JTheta Python SDK

📦 JTheta Python SDK

The official Python SDK for interacting with the JTheta.ai platform — enabling seamless dataset management, annotation requests, and automation of your AI pipeline.

---

🚀 Installation

Install the SDK using pip:

pip install jtheta

---

🔑 Getting Started

1. Login to https://app.jtheta.ai and create a workspace.

2. Navigate to the workspace dashboard and click on the Create API Key option in the left sidebar.

3. Copy the generated API key.

import jtheta

# Initialize with your API key
jtheta.init("your_api_key_here")

# Validate your API key
print(jtheta.validate_key())

---

📁 Project & Dataset Management

Create a New Project

project = jtheta.create_project("My Project", "image")

Create a Dataset and Upload Images

dataset = jtheta.create_dataset(
    "MyDataset",
    "MIT",
    "My Project",
    ["image1.jpg", "image2.jpg"]
)

Upload Additional Images

upload_image = jtheta.upload_images(
    231,
    "My Project",
    "image1.jpg"
)

---

👥 Manage Annotators & Reviewers

Retrieve Annotators

annotators = jtheta.get_annotators()

Retrieve Reviewers

reviewers = jtheta.get_reviewers()

---

📝 Request Annotations

jtheta.request_annotation(
    "My Project",
    dataset["id"],
    "[e-mail]",
    "[e-mail]",
    [
        {"label": "car", "type": "Bounding Boxes"},
        {"label": "truck", "type": "Polygons"}
    ],
    allow_class_creation=True,
    auto_annotation=False
)

---

📥 Download Annotated Dataset

jtheta.download_dataset(
    dataset["id"],
    format="csv",
    version="1.0",
    save_path="annotations.csv"
)

---

✅ Features

• Project and dataset creation

• Image upload

• Annotation request and monitoring

• Dataset export

• Retrieve annotators and reviewers

---

📬 Support & Feedback

Have questions or feature requests? Reach out!

• Email: [e-mail]

• Website: https://jtheta.ai

---

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.