{"id":34914305,"url":"https://github.com/superannotateai/superannotate-python-sdk","last_synced_at":"2026-04-02T14:54:04.266Z","repository":{"id":36962741,"uuid":"288978101","full_name":"superannotateai/superannotate-python-sdk","owner":"superannotateai","description":"SuperAnnotate Python SDK","archived":false,"fork":false,"pushed_at":"2026-03-27T06:45:44.000Z","size":130797,"stargazers_count":40,"open_issues_count":9,"forks_count":14,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-27T18:43:50.001Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://superannotate.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superannotateai.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-08-20T10:38:15.000Z","updated_at":"2026-03-26T11:39:41.000Z","dependencies_parsed_at":"2023-12-18T17:52:25.211Z","dependency_job_id":"49800aa7-30b4-4785-b11f-1a42308f8360","html_url":"https://github.com/superannotateai/superannotate-python-sdk","commit_stats":{"total_commits":2627,"total_committers":20,"mean_commits":131.35,"dds":0.6943281309478493,"last_synced_commit":"144146ca1fd4b05973dbfb35bfb9d07970b66980"},"previous_names":[],"tags_count":555,"template":false,"template_full_name":null,"purl":"pkg:github/superannotateai/superannotate-python-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superannotateai%2Fsuperannotate-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superannotateai%2Fsuperannotate-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superannotateai%2Fsuperannotate-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superannotateai%2Fsuperannotate-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superannotateai","download_url":"https://codeload.github.com/superannotateai/superannotate-python-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superannotateai%2Fsuperannotate-python-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308447,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-26T12:00:50.687Z","updated_at":"2026-04-02T14:54:04.247Z","avatar_url":"https://github.com/superannotateai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"SuperAnnotate Python SDK\n===============================\n|Python| |License| |Changelog|\n\n\nWelcome to the SuperAnnotate Python Software Development Kit (SDK), which enables Python programmers to create software that incorporates services of the platform and effortlessly integrates SuperAnnotate into their AI process.\n\n.. |Python| image:: https://img.shields.io/static/v1?label=python\u0026message=3.7/3.8/3.9/3.10/3.11\u0026color=blue\u0026style=flat-square\n    :target: https://pypi.org/project/superannotate/\n    :alt: Python Versions\n.. |License| image:: https://img.shields.io/static/v1?label=license\u0026message=MIT\u0026color=green\u0026style=flat-square\n    :target: https://github.com/superannotateai/superannotate-python-sdk/blob/master/LICENSE/\n    :alt: License\n.. |Changelog| image:: https://img.shields.io/static/v1?label=change\u0026message=log\u0026color=yellow\u0026style=flat-square\n    :target: https://github.com/superannotateai/superannotate-python-sdk/blob/master/CHANGELOG.rst\n    :alt: Changelog\n\nResources\n---------------\n\n- API Reference and User Guide available on `Read the Docs \u003chttps://superannotate.readthedocs.io/en/stable/index.html\u003e`__\n- `Platform documentation \u003chttps://doc.superannotate.com/\u003e`__\n\n\nAuthentication\n---------------\n\n.. code-block:: python\n\n    from superannotate import SAClient\n    # by environment variable SA_TOKEN\n    sa_client = SAClient()\n    # by token\n    sa_client = SAClient(token='\u003cteam token\u003e')\n    # by config file\n    # default path is ~/.superannotate/config.ini\n    sa_client = SAClient(config_path='~/.superannotate/dev_config.ini')\n\n\nconfig.ini example\n------------------\n.. code-block:: python\n\n    [DEFAULT]\n    SA_TOKEN = \u003cToken\u003e\n    LOGGING_LEVEL = INFO\n\n\nUsing superannotate\n-------------------\n\n.. code-block:: python\n\n    from superannotate import SAClient\n\n\n    sa_client =SAClient()\n\n    project = 'Dogs'\n\n    sa_client.create_project(\n            project_name=project,\n            project_description='Test project generated via SDK',\n            project_type='Vector'\n        )\n\n    sa_client.create_annotation_class(\n        project=project,\n        name='dog',\n        color='#F9E0FA',\n        class_type='tag'\n    )\n\n    sa_client.attach_items(\n            project=project,\n            attachments=[\n                {\n                    'url': 'https://drive.google.com/uc?export=download\u0026id=1ipOrZNSTlPUkI_hnrW9aUD5yULqqq5Vl',\n                    'name': 'dog.jpeg'\n                }\n            ]\n        )\n\n    sa_client.upload_annotations(\n            project=project,\n            annotations=[\n                {\n                    'metadata': {'name': 'dog.jpeg'},\n                    'instances': [\n                        {'type': 'tag', 'className': 'dog'}\n                    ]\n                }\n            ]\n        )\n\n    sa_client.get_annotations(project=project, items=['dog.jpeg'])\n\nInstallation\n------------\n\nSuperAnnotate python SDK is available on PyPI:\n\n.. code-block:: bash\n\n    pip install superannotate\n\n\nThe package officially supports Python 3.10+ and was tested under Linux and\nWindows (`Anaconda \u003chttps://www.anaconda.com/products/individual#windows\u003e`__\n) platforms.\n\n\nSupported Features\n------------------\n\n- search/get/create/clone/update/delete projects\n- search/get/create/delete folders\n- assign folders to project contributors\n- upload items to a project from a local or AWS S3 folder\n- attach items by URL or from an integrated storage, meanwhile keeping them secure in your cloud provider\n- get integrated cloud storages\n- upload annotations (also from local or AWS S3 folder)\n- delete annotations\n- set items annotations statuses\n- get/download/export annotations from a project (also to a local or AWS S3 folder)\n- invite/search team contributors or add contributors to a specific project\n- search/get/copy/move items in a project\n- query items using SA Query Language\n- define custom metadata for items and upload custom values (query based on your custom metadata)\n- upload priority scores\n- get available subsets (sets of segregated items), query items in a subset or add items to a subset\n- assign or anassign items to project contributors\n- download an image that has been uploaded to project\n- search/create/download/delete project annotation classes\n- search/download models\n- run predictions\n- convert annotations from/to COCO format\n- convert annotation from VOC, SuperVisely, LabelBox, DataLoop, VGG, VoTT, SageMaker, GoogleCloud, YOLO formats\n- CLI commands for simple tasks\n\nQuestions and Issues\n--------------------\n\nFor questions and issues please use this repo’s issue tracker on GitHub or contact support@superannotate.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperannotateai%2Fsuperannotate-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperannotateai%2Fsuperannotate-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperannotateai%2Fsuperannotate-python-sdk/lists"}