cvat-sdk

library2.68.0pypypi✓ verified 86d ago

CVAT SDK provides a Python client for the Computer Vision Annotation Tool (CVAT) API. Version 2.64.0, requires Python >=3.10. It supports task management, annotation upload/download, and integration with CVAT server. Release cadence is regular, following CVAT releases.

http-networking data

pip install cvat-sdk

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CVAT-SDK

cvat-sdk

http-networkingpythonv2.68.0

Install

3.2s avg

Import

679ms

Disk

48MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.68.0 · 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

installs and imports cleanly · install 0.0s · import 0.724s · 49.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.2s · import 0.634s · 50MB

48MB installed

● package 48MB

Code

Verified usage

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

Client

✓ from cvat_sdk import Client

✗ from cvat_sdk.client import Client

Alias changed in 2.x; direct import from submodule deprecated.

Task

✓ from cvat_sdk.models import Task

✗ from cvat_sdk.core.models import Task

Core subpackage removed in 2.x.

Initialize client with URL and credentials from environment variables.

import os from cvat_sdk import Client client = Client( url=os.environ.get('CVAT_URL', 'http://localhost:8080'), auth=(os.environ.get('CVAT_USER', ''), os.environ.get('CVAT_PASS', '')) ) print(f"Logged in as {client.user}")

Debug

Known issues

breakingv2.x removed the deprecated `cvat_sdk.core` subpackage. Use `cvat_sdk.models` for data classes.

fix

Update imports: replace `from cvat_sdk.core.models import Task` with `from cvat_sdk.models import Task`.

affects: >=2.0.0

breaking`Client` constructor no longer accepts positional arguments for `auth`. Must pass as keyword or use `(user, pass)` tuple.

fix

Change `Client('url', 'user', 'pass')` to `Client(url='url', auth=('user', 'pass'))`.

affects: >=2.0.0

gotchaImage upload methods like `client.tasks.upload_data()` require a data stream or file-like object, not file path as string.

fix

Open the file: `with open('image.jpg', 'rb') as f: client.tasks.upload_data(task_id, data=f)`.

affects: all

deprecated`create_task()` method is deprecated; use `tasks.create()` instead.

fix

Call `client.tasks.create(spec)` instead of `client.create_task(spec)`.

affects: >=1.5.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'cvat_sdk.core'

v2.x removed the core subpackage; imports from cvat_sdk.core.models fail.

fix

Change import to `from cvat_sdk.models import Task`.

TypeError: Client.__init__() takes 1 positional argument but 3 were given

Passing url and auth as positional arguments in v2.x.

fix

Use keyword arguments: `Client(url='http://...', auth=('user', 'pass'))`.

AttributeError: 'Client' object has no attribute 'create_task'

Deprecated method removed or not available in current version.

fix

Use `client.tasks.create(spec)`.

cvat_sdk.exceptions.ApiException: Not Found

Trying to access a task or project that doesn't exist or insufficient permissions.

fix

Verify resource ID and user access rights.

Upgrade

Version history

2.68.0latest on PyPI · released Jun 10, 2026

Audit

Dependencies

requestsrequiredHTTP client for API calls

attrsrequiredData classes for models

PillowoptionalImage handling

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cvat-ai/cvat ↗

packagehttps://pypi.org/project/cvat-sdk/ ↗

homepagehttps://www.cvat.ai/ ↗