# Ango Hub Python SDK
<img src="https://imerit.net/wp-content/themes/imerit/images/imerit-logo.svg" alt="iMerit" height="60">
A comprehensive Python SDK to interface programmatically with Ango Hub, iMerit's data annotation and AI training platform.
## Overview
The iMerit-Ango SDK provides a powerful Python interface for interacting with Ango Hub, enabling you to:
- **Manage Projects**: Create, configure, and manage annotation projects
- **Upload Data**: Import assets from local storage, cloud storage (AWS S3, GCP, Azure), or URLs
- **Handle Annotations**: Import and export annotations in various formats (COCO, YOLO, KITTI, Ango native format)
- **Workflow Management**: Manage labeling workflows, batches, and task assignments
- **Team Collaboration**: Add team members, manage roles, and track performance
- **Integration**: Connect with your existing ML pipelines and data infrastructure
## Installation
Install the latest version from PyPI:
```bash
pip install imerit-ango
```
To upgrade to the latest version:
```bash
pip install -U imerit-ango
```
## Quick Start
### 1. Get Your API Key
First, obtain your API key from your [Ango Hub account page](https://docs.imerit.net/sdk/sdk-documentation#obtaining-your-api-key):
1. Navigate to your Account page in Ango Hub
2. Go to the API tab
3. Create a new API key or copy your existing key
### 2. Basic Usage
```python
import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK
# Load environment variables
load_dotenv()
# Initialize SDK
sdk = SDK(api_key=os.getenv('API_KEY'))
# List your projects
projects = sdk.list_projects()
print(f"Found {len(projects)} projects")
# Get project details
project = sdk.get_project(project_id=os.getenv('PROJECT_ID'))
print(f"Project: {project['name']}")
```
## SDK Functions Overview
### Project-Level Functions
- **Project Management**: `create_project()`, `get_project()`, `list_projects()`
- **Data Upload**: `upload_files()`, `upload_files_cloud()`, `upload_chat_assets()`
- **Batch Management**: `create_batch()`, `assign_batches()`, `get_batches()`
- **Task Management**: `get_tasks()`, `assign_task()`, `requeue_tasks()`
- **Annotations**: `import_labels()`, `export()`, `exportV3()`
- **Team**: `add_members_to_project()`
- **Performance**: `get_metrics()`, `get_project_performance()`
### Organization-Level Functions
- **Storage**: `create_storage()`, `get_storages()`, `delete_storage()`
- **Members**: `invite_members_to_org()`, `get_organization_members()`
- **Permissions**: `update_organization_members_role()`
## Supported Asset Types
The SDK supports a wide variety of data types:
- **Images**: PNG, JPEG, TIFF, BMP, WebP
- **Videos**: MP4, AVI, MOV, WebM
- **Medical**: DICOM, NRRD files
- **Documents**: PDF, Markdown, HTML
- **Text**: Plain text, NER datasets
- **3D Data**: Point clouds, multi-sensor fusion
- **Audio**: WAV, MP3, FLAC
- **LLM**: Chat conversations and responses
## Documentation
### Comprehensive Documentation
Full SDK documentation is available at: https://docs.imerit.net/sdk/sdk-documentation
### Key Resources
- [Installation Guide](https://docs.imerit.net/sdk/sdk-documentation#sdk-installation)
- [API Reference](https://docs.imerit.net/sdk/sdk-documentation#project-level-sdk-functions)
- [Usage Examples](https://docs.imerit.net/sdk/sdk-useful-snippets)
- [Troubleshooting](https://docs.imerit.net/troubleshooting)
## Examples
### Upload and Create a Labeling Project
```python
# Create a new project
project = sdk.create_project(
organization_id=org_id,
name="My Annotation Project",
description="Object detection for autonomous vehicles"
)
# Upload images from local directory
sdk.upload_files(
project_id=project['_id'],
file_paths=['/path/to/images/*.jpg']
)
# Create batches for organized labeling
batch = sdk.create_batch(
project_id=project['_id'],
batch_name="Training Set Batch 1"
)
```
### Export Annotations
```python
# Export annotations in COCO format
export_result = sdk.export(
project_id=project_id,
export_format='COCO'
)
# Download the export
import requests
response = requests.get(export_result['downloadUrl'])
with open('annotations.json', 'wb') as f:
f.write(response.content)
```
## Support
- **Documentation**: [https://docs.imerit.net](https://docs.imerit.net)
- **Status Page**: [Ango Hub Status](https://docs.imerit.net/other/ango-hub-status-page)
- **Customer Support**: Available through your Ango Hub account
## License
This SDK is provided by iMerit Technology Services for use with Ango Hub platform.
---
For the latest updates and detailed API reference, visit our [complete documentation](https://docs.imerit.net/sdk/sdk-documentation).
Raw data
{
"_id": null,
"home_page": null,
"name": "imerit-ango",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "imerit_ango, angohub, Ango, Ango Hub, iMerit",
"author": "Faruk Karakaya",
"author_email": "<faruk@imerit.net>",
"download_url": null,
"platform": null,
"description": "# Ango Hub Python SDK\n\n<img src=\"https://imerit.net/wp-content/themes/imerit/images/imerit-logo.svg\" alt=\"iMerit\" height=\"60\">\n\nA comprehensive Python SDK to interface programmatically with Ango Hub, iMerit's data annotation and AI training platform.\n\n## Overview\n\nThe iMerit-Ango SDK provides a powerful Python interface for interacting with Ango Hub, enabling you to:\n\n- **Manage Projects**: Create, configure, and manage annotation projects\n- **Upload Data**: Import assets from local storage, cloud storage (AWS S3, GCP, Azure), or URLs\n- **Handle Annotations**: Import and export annotations in various formats (COCO, YOLO, KITTI, Ango native format)\n- **Workflow Management**: Manage labeling workflows, batches, and task assignments\n- **Team Collaboration**: Add team members, manage roles, and track performance\n- **Integration**: Connect with your existing ML pipelines and data infrastructure\n\n## Installation\n\nInstall the latest version from PyPI:\n\n```bash\npip install imerit-ango\n```\n\nTo upgrade to the latest version:\n\n```bash\npip install -U imerit-ango\n```\n\n## Quick Start\n\n### 1. Get Your API Key\n\nFirst, obtain your API key from your [Ango Hub account page](https://docs.imerit.net/sdk/sdk-documentation#obtaining-your-api-key):\n\n1. Navigate to your Account page in Ango Hub\n2. Go to the API tab\n3. Create a new API key or copy your existing key\n\n\n### 2. Basic Usage\n\n```python\nimport os\nfrom dotenv import load_dotenv\nfrom imerit_ango.sdk import SDK\n\n# Load environment variables\nload_dotenv()\n\n# Initialize SDK\nsdk = SDK(api_key=os.getenv('API_KEY'))\n\n# List your projects\nprojects = sdk.list_projects()\nprint(f\"Found {len(projects)} projects\")\n\n# Get project details\nproject = sdk.get_project(project_id=os.getenv('PROJECT_ID'))\nprint(f\"Project: {project['name']}\")\n```\n\n## SDK Functions Overview\n\n### Project-Level Functions\n- **Project Management**: `create_project()`, `get_project()`, `list_projects()`\n- **Data Upload**: `upload_files()`, `upload_files_cloud()`, `upload_chat_assets()`\n- **Batch Management**: `create_batch()`, `assign_batches()`, `get_batches()`\n- **Task Management**: `get_tasks()`, `assign_task()`, `requeue_tasks()`\n- **Annotations**: `import_labels()`, `export()`, `exportV3()`\n- **Team**: `add_members_to_project()`\n- **Performance**: `get_metrics()`, `get_project_performance()`\n\n### Organization-Level Functions\n- **Storage**: `create_storage()`, `get_storages()`, `delete_storage()`\n- **Members**: `invite_members_to_org()`, `get_organization_members()`\n- **Permissions**: `update_organization_members_role()`\n\n## Supported Asset Types\n\nThe SDK supports a wide variety of data types:\n\n- **Images**: PNG, JPEG, TIFF, BMP, WebP\n- **Videos**: MP4, AVI, MOV, WebM\n- **Medical**: DICOM, NRRD files\n- **Documents**: PDF, Markdown, HTML\n- **Text**: Plain text, NER datasets\n- **3D Data**: Point clouds, multi-sensor fusion\n- **Audio**: WAV, MP3, FLAC\n- **LLM**: Chat conversations and responses\n\n## Documentation\n\n### Comprehensive Documentation\nFull SDK documentation is available at: https://docs.imerit.net/sdk/sdk-documentation\n\n### Key Resources\n- [Installation Guide](https://docs.imerit.net/sdk/sdk-documentation#sdk-installation)\n- [API Reference](https://docs.imerit.net/sdk/sdk-documentation#project-level-sdk-functions)\n- [Usage Examples](https://docs.imerit.net/sdk/sdk-useful-snippets)\n- [Troubleshooting](https://docs.imerit.net/troubleshooting)\n\n## Examples\n\n### Upload and Create a Labeling Project\n\n```python\n# Create a new project\nproject = sdk.create_project(\n organization_id=org_id,\n name=\"My Annotation Project\",\n description=\"Object detection for autonomous vehicles\"\n)\n\n# Upload images from local directory\nsdk.upload_files(\n project_id=project['_id'],\n file_paths=['/path/to/images/*.jpg']\n)\n\n# Create batches for organized labeling\nbatch = sdk.create_batch(\n project_id=project['_id'],\n batch_name=\"Training Set Batch 1\"\n)\n```\n\n### Export Annotations\n\n```python\n# Export annotations in COCO format\nexport_result = sdk.export(\n project_id=project_id,\n export_format='COCO'\n)\n\n# Download the export\nimport requests\nresponse = requests.get(export_result['downloadUrl'])\nwith open('annotations.json', 'wb') as f:\n f.write(response.content)\n```\n\n## Support\n\n- **Documentation**: [https://docs.imerit.net](https://docs.imerit.net)\n- **Status Page**: [Ango Hub Status](https://docs.imerit.net/other/ango-hub-status-page)\n- **Customer Support**: Available through your Ango Hub account\n\n## License\n\nThis SDK is provided by iMerit Technology Services for use with Ango Hub platform.\n\n---\n\nFor the latest updates and detailed API reference, visit our [complete documentation](https://docs.imerit.net/sdk/sdk-documentation).\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Ango-Hub SDK",
"version": "1.3.42",
"project_urls": null,
"split_keywords": [
"imerit_ango",
" angohub",
" ango",
" ango hub",
" imerit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "73d714a4b59f51b4112afbd92969c573cdc9aa0657cc3f1895cc91ab31dbe20a",
"md5": "76ce07ddfe8db24f06cdf0b1bc398ebf",
"sha256": "8732513ea2d336ef284c52d30678ad23e0efcdd32c6a2a4959af7d7e59eb8816"
},
"downloads": -1,
"filename": "imerit_ango-1.3.42-py3-none-any.whl",
"has_sig": false,
"md5_digest": "76ce07ddfe8db24f06cdf0b1bc398ebf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 25599,
"upload_time": "2025-08-05T10:53:13",
"upload_time_iso_8601": "2025-08-05T10:53:13.958658Z",
"url": "https://files.pythonhosted.org/packages/73/d7/14a4b59f51b4112afbd92969c573cdc9aa0657cc3f1895cc91ab31dbe20a/imerit_ango-1.3.42-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-05 10:53:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "imerit-ango"
}
JSON