Command-line client for CVAT

A simple command line interface for working with CVAT. At the moment it implements a basic feature set but may serve as the starting point for a more comprehensive CVAT administration tool in the future.

The following subcommands are supported:

Projects:
- backup - back up a project
- create - create a new project
- create-from-backup - create a project from a backup file
- delete - delete projects
- export-dataset - export a project as a dataset
- import-dataset - import annotations into a project from a dataset
- ls - list all projects
Tasks:
- create - create a new task
- create-from-backup - create a task from a backup file
- delete - delete tasks
- ls - list all tasks
- frames - download frames from a task
- export-dataset - export a task as a dataset
- import-dataset - import annotations into a task from a dataset
- backup - back up a task
- auto-annotate - automatically annotate a task using a local function
Functions (Enterprise/Cloud only):
- create-native - create a function that can be powered by an agent
- delete - delete a function
- run-agent - process requests for a native function

Installation

pip install cvat-cli

Usage

The general form of a CLI command is:

$ cvat-cli <common options> <resource> <action> <options>

where:

<common options> are options shared between all subcommands;
<resource> is a CVAT resource, such as task;
<action> is the action to do with the resource, such as create;
<options> is any options specific to a particular resource and action.

You can list available subcommands and options using the --help option:

$ cvat-cli --help # get help on available common options and resources
$ cvat-cli <resource> --help # get help on actions for the given resource
$ cvat-cli <resource> <action> --help # get help on action-specific options

Examples

Create a task with local images:

cvat-cli --auth user task create
    --labels '[{"name": "car"}, {"name": "person"}]'
    "test_task"
    "local"
    "image1.jpg" "image2.jpg"

List tasks on a custom server with auth:

cvat-cli --auth admin:password \
    --server-host cvat.my.server.com --server-port 30123 \
    task ls

Metadata

Release files for cvat-cli 2.76.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cvat-cli 2.76.0
File	Size	Uploaded
cvat_cli-2.76.0.tar.gz	26.7 kB	Sep 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cvat-cli 2.76.0
File	Interpreter	ABI	Platform	Reset
cvat_cli-2.76.0-py3-none-any.whl 34.8 kB Sep 16, 2026	Python 3	none	any	Details

Total release size: 61.5 kB

Release files / cvat_cli-2.76.0.tar.gz

Download URL	cvat_cli-2.76.0.tar.gz
Size	26.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`ede3f37a12122583f4c83ddc360360fd5c7619804a0ea1c40b6a5bdef34d844d`
BLAKE2b-256 checksum How to use checksums	`2ada6edc7353efadcae34bd4f50cc3284d74f37000d4de51716ecabf88ff30db`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cvat-ai/cvat
Publishing commit: github.com/cvat-ai/cvat/tree/b78c39f7a5de6450567e77c9e1ffc8f0c428cea7

Workflow

Publishing configuration: github.com/cvat-ai/cvat/blob/b78c39f7a5de6450567e77c9e1ffc8f0c428cea7/.github/workflows/publish-artifacts.yml
Publishing logs: github.com/cvat-ai/cvat/actions/runs/35090101648/attempts/1

Artifact

Subject: cvat_cli-2.76.0.tar.gz
SHA-256 checksum: ede3f37a12122583f4c83ddc360360fd5c7619804a0ea1c40b6a5bdef34d844d Verifying attestations

Release files / cvat_cli-2.76.0-py3-none-any.whl

Download URL	cvat_cli-2.76.0-py3-none-any.whl
Size	34.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ea1247a3665f36ada23ad1563b2ce4f6fb21f45c3c09d48872234c8f80643be1`
BLAKE2b-256 checksum How to use checksums	`d7b16c650673593f572690cf1783212cd55e3a07a63ca7a1874aa4d8f9b823c1`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cvat-ai/cvat
Publishing commit: github.com/cvat-ai/cvat/tree/b78c39f7a5de6450567e77c9e1ffc8f0c428cea7

Workflow

Publishing configuration: github.com/cvat-ai/cvat/blob/b78c39f7a5de6450567e77c9e1ffc8f0c428cea7/.github/workflows/publish-artifacts.yml
Publishing logs: github.com/cvat-ai/cvat/actions/runs/35090101648/attempts/1

Artifact

Subject: cvat_cli-2.76.0-py3-none-any.whl
SHA-256 checksum: ea1247a3665f36ada23ad1563b2ce4f6fb21f45c3c09d48872234c8f80643be1 Verifying attestations