superannotate

library4.5.5pypypi✓ verified 83d ago

Python SDK for the SuperAnnotate platform, enabling programmatic management of annotation projects, items, classes, exports, and team workflows. Current version 4.5.4, supports Python >=3.10, released approximately every 1-2 months.

ai-ml devops

pip install superannotate

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · SUPERANNOTATE

superannotate

ai-mlpythonv4.5.5

Install

22.4s avg

Import

3848ms

Disk

505MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.5.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 22.4s · import 3.848s · 468MB

505MB installed

● package 505MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SAClient

✓ from superannotate import SAClient

Main client class introduced in v4.x. Legacy import sa.SAClient is obsolete.

Initialize SAClient and list projects. Replace SA_API_TOKEN with your token.

from superannotate import SAClient import os # Initialize client with API token sa = SAClient(api_token=os.environ.get('SA_API_TOKEN', '')) # Example: list projects projects = sa.list_projects() for p in projects: print(p['name'], p['id'])

superannotate --version

Debug

Known issues

breakingIn v4.x the synchronous client SAClient replaces the legacy sa module. All method calls must go through SAClient instance.

fix

Migrate from `import superannotate as sa` to `from superannotate import SAClient` and instantiate with `sa = SAClient(...)`. Function signatures changed.

affects: <4.0.0

breakingPydantic v2 migration in v4.5.3. If you rely on Pydantic v1 compatibility, your code may break when using SAClient models directly.

fix

If pinning Pydantic v1, stay on 4.5.2 or upgrade Pydantic to v2. Refrain from direct manipulation of SAClient response pydantic models.

affects: >=4.5.3

gotchaAPI token must be valid and passed as parameter or set via SA_API_TOKEN environment variable. Missing token raises ValueError with unclear message.

fix

Always set API token via environment variable SA_API_TOKEN or constructor argument api_token. Verify token is active in SuperAnnotate UI.

affects: all

Errors

Common errors & fixes

AttributeError: module 'superannotate' has no attribute 'SAClient'

Importing from superannotate before v4.0 where SAClient didn't exist, or incorrect import path.

fix

Run `pip install --upgrade superannotate` to get v4.x. Then use `from superannotate import SAClient`.

ValueError: The api_token must be provided either as an argument or via the SA_API_TOKEN environment variable.

Initializing SAClient without API token.

fix

Set SA_API_TOKEN environment variable or pass api_token='...' to SAClient constructor.

pydantic.errors.PydanticUserError: Field name "project_name" shadows an attribute in parent model

Using Pydantic v1 with SAClient >=4.5.3 which now uses Pydantic v2.

fix

Upgrade Pydantic to v2 (`pip install pydantic>=2.0`) or downgrade superannotate to 4.5.2.

Upgrade

Version history

4.5.5latest on PyPI · released May 31, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

18 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/superannotateai/superannotate-python-sdk ↗

packagehttps://pypi.org/project/superannotate/ ↗

homepagehttps://www.superannotate.com ↗

docshttps://superannotate.readthedocs.io/en/stable/ ↗