https://github.com/superannotateai/superannotate-python-sdk

SuperAnnotate Python SDK
https://github.com/superannotateai/superannotate-python-sdk

Last synced: 3 months ago
JSON representation

SuperAnnotate Python SDK

• Host: GitHub
• URL: https://github.com/superannotateai/superannotate-python-sdk
• Owner: superannotateai
• License: mit
• Created: 2020-08-20T10:38:15.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2026-03-27T06:45:44.000Z (3 months ago)
• Last Synced: 2026-03-27T18:43:50.001Z (3 months ago)
• Language: Python
• Homepage: https://superannotate.readthedocs.io
• Size: 125 MB
• Stars: 40
• Watchers: 0
• Forks: 14
• Open Issues: 9
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
SuperAnnotate Python SDK

===============================

|Python| |License| |Changelog|

Welcome 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.

.. |Python| image:: https://img.shields.io/static/v1?label=python&message=3.7/3.8/3.9/3.10/3.11&color=blue&style=flat-square

    :target: https://pypi.org/project/superannotate/

    :alt: Python Versions

.. |License| image:: https://img.shields.io/static/v1?label=license&message=MIT&color=green&style=flat-square

    :target: https://github.com/superannotateai/superannotate-python-sdk/blob/master/LICENSE/

    :alt: License

.. |Changelog| image:: https://img.shields.io/static/v1?label=change&message=log&color=yellow&style=flat-square

    :target: https://github.com/superannotateai/superannotate-python-sdk/blob/master/CHANGELOG.rst

    :alt: Changelog

Resources

---------------

- API Reference and User Guide available on `Read the Docs `__

- `Platform documentation `__

Authentication

---------------

.. code-block:: python

    from superannotate import SAClient

    # by environment variable SA_TOKEN

    sa_client = SAClient()

    # by token

    sa_client = SAClient(token='')

    # by config file

    # default path is ~/.superannotate/config.ini

    sa_client = SAClient(config_path='~/.superannotate/dev_config.ini')

config.ini example

------------------

.. code-block:: python

    [DEFAULT]

    SA_TOKEN = 

    LOGGING_LEVEL = INFO

Using superannotate

-------------------

.. code-block:: python

    from superannotate import SAClient

    sa_client =SAClient()

    project = 'Dogs'

    sa_client.create_project(

            project_name=project,

            project_description='Test project generated via SDK',

            project_type='Vector'

        )

    sa_client.create_annotation_class(

        project=project,

        name='dog',

        color='#F9E0FA',

        class_type='tag'

    )

    sa_client.attach_items(

            project=project,

            attachments=[

                {

                    'url': 'https://drive.google.com/uc?export=download&id=1ipOrZNSTlPUkI_hnrW9aUD5yULqqq5Vl',

                    'name': 'dog.jpeg'

                }

            ]

        )

    sa_client.upload_annotations(

            project=project,

            annotations=[

                {

                    'metadata': {'name': 'dog.jpeg'},

                    'instances': [

                        {'type': 'tag', 'className': 'dog'}

                    ]

                }

            ]

        )

    sa_client.get_annotations(project=project, items=['dog.jpeg'])

Installation

------------

SuperAnnotate python SDK is available on PyPI:

.. code-block:: bash

    pip install superannotate

The package officially supports Python 3.10+ and was tested under Linux and

Windows (`Anaconda `__

) platforms.

Supported Features

------------------

- search/get/create/clone/update/delete projects

- search/get/create/delete folders

- assign folders to project contributors

- upload items to a project from a local or AWS S3 folder

- attach items by URL or from an integrated storage, meanwhile keeping them secure in your cloud provider

- get integrated cloud storages

- upload annotations (also from local or AWS S3 folder)

- delete annotations

- set items annotations statuses

- get/download/export annotations from a project (also to a local or AWS S3 folder)

- invite/search team contributors or add contributors to a specific project

- search/get/copy/move items in a project

- query items using SA Query Language

- define custom metadata for items and upload custom values (query based on your custom metadata)

- upload priority scores

- get available subsets (sets of segregated items), query items in a subset or add items to a subset

- assign or anassign items to project contributors

- download an image that has been uploaded to project

- search/create/download/delete project annotation classes

- search/download models

- run predictions

- convert annotations from/to COCO format

- convert annotation from VOC, SuperVisely, LabelBox, DataLoop, VGG, VoTT, SageMaker, GoogleCloud, YOLO formats

- CLI commands for simple tasks

Questions and Issues

--------------------

For questions and issues please use this repo’s issue tracker on GitHub or contact support@superannotate.com.