SDK for accessing the jtheta.ai API.

🧠 jtheta

SDK for accessing the jtheta.ai API — making it easy to manage datasets, request annotations, and automate your AI pipeline.

📆 Installation

Install the SDK with pip:

pip install jtheta

🚀 Getting Started

Step 1: Login into https://app.jtheta.ai/ & Create the workspace.

Step 2: On Workspace dashboard click the Crete API key option in left sidebar.

Step 3: Copy the api key 

import jtheta

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

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

# Create a new project
#jtheta.create_project("project_title","project_category")
project = jtheta.create_project("My Project", "image")

# Upload images and create a dataset
#jtheta.create_dataset("dataset_name","license","project_name","image_paths"=["image path"])
dataset = jtheta.create_dataset("MyDataset", "MIT", "My Project", ["image1.jpg", "image2.jpg"])

#Upload more images
#jtheta.upload_images("dataset_id","project_name","images"="image1.jpg")
upload_image = jtheta.upload_images(231,"My Project","image1.jpg")

# Get list of Annotators
jtheta.get_annotators()

# Get list of Reviewers
jtheta.get_reviewers()

# Request annotation
#jtheta.request_annotation("dataset_id","project_name","assigned_annotator","assigned_reviewer","labels"=[{"label": class_label, "type": "Bounding Boxes"},{"label": class_label, "type": "Polygons"},{"label": class_label, "type": "Instance Segmentation"},{"label": class_label, "type": "Semantic Segmentation"}],allow_class_creation=True,auto_annotation=True)

jtheta.request_annotation("My Project", dataset["id"], "annotator@example.com", "reviewer@example.com", [{"label": "car", "type": "Bounding Boxes"},{"label": "truck", "type": "Polygons"}], True, False)

# Download 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: contact@jtheta.ai 🌐 Website: jtheta.ai

🌐 Connect with us

📝 License

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