Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/source/api_reference/api_folder.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ Folders
=======

.. automethod:: superannotate.SAClient.search_folders
.. automethod:: superannotate.SAClient.set_folder_status
.. automethod:: superannotate.SAClient.assign_folder
.. automethod:: superannotate.SAClient.unassign_folder
.. automethod:: superannotate.SAClient.get_folder_by_id
Expand Down
111 changes: 1 addition & 110 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,113 +19,4 @@
History <changelog_link>
LICENSE.rst

----------

SuperAnnotate Python SDK documentation
==================================================================

SuperAnnotate Python SDK allows access to the platform without web browser:

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


SDK is available on PyPI:

.. code-block:: bash

pip install superannotate


The package officially supports Python 3.7+ and was tested under Linux and
Windows (`Anaconda <https://www.anaconda.com/products/individual#windows>`_) platforms.

----------

Supported Features
__________________

- Search projects
- Create/delete a project
- Upload images to a project from a local or AWS S3 folder
- Upload videos to a project from a local folder
- Upload annotations/pre-annotations to a project from local or AWS S3 folder
- Set the annotation status of the images being uploaded
- Export annotations from a project to a local or AWS S3 folder
- Share and unshare a project with a team contributor
- Invite a team contributor
- Search images in a project
- Download a single image
- Copy/move image between projects
- Get image bytes (e.g., for numpy array creation)
- Set image annotation status
- Download image annotations/pre-annotations
- Create/download project annotation classes
- Add annotations to images on platform
- Convert annotation format from/to COCO
- Add annotations to local SuperAnnotate format JSONs
- CLI commands for simple tasks
- Aggregate class/attribute distribution as histogram

----------

License
_______

This SDK is distributed under the :ref:`MIT License <ref_license>`.

----------

Questions and Issues
____________________

For questions and issues please use issue tracker on
`GitHub <https://github.com/superannotateai/superannotate-python-sdk>`_.
.. include:: ../../README.rst
6 changes: 3 additions & 3 deletions requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,17 @@ pillow==9.4.0
matplotlib>=3.3.1
xmltodict==0.12.0
opencv-python>=4.4.0.42
wheel>=0.38.4
wheel>=0.40.0
packaging>=20.4
plotly>=4.1.0
ffmpeg-python>=0.2.0
fire==0.4.0
mixpanel==4.8.3
pydantic>=1.10.4
pydantic>=1.10.7
setuptools>=57.4.0
email-validator>=1.0.3
jsonschema==3.2.0
pandas>=1.1.4
aiofiles==0.8.0
Werkzeug==2.2.2
Werkzeug==2.2.3
Jinja2==3.1.2
2 changes: 1 addition & 1 deletion src/superannotate/lib/app/interface/sdk_interface.py
Original file line number Diff line number Diff line change
Expand Up @@ -2192,7 +2192,7 @@ def get_annotations(
:param project: project name or folder path (e.g., “project1/folder1”).
:type project: str

:param items: item names. If None all items in the project will be exported
:param items: item names. If None all items in specified directory
:type items: list of strs

:return: list of annotations
Expand Down