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"],
    "annotator@example.com",
    "reviewer@example.com",
    [
        {"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!


πŸ“ License

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

Last updated