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

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.74.1
File	Size	Uploaded
cvat_cli-2.74.1.tar.gz	26.7 kB	Sep 1, 2026	Details

Built distribution (wheel)

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

Total release size: 61.5 kB

Release files / cvat_cli-2.74.1.tar.gz

Download URL	cvat_cli-2.74.1.tar.gz
Size	26.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`d9998f752b70fa0c24c0635d79ac0774997aaf4f2e536c3f422fc398df24f148`
BLAKE2b-256 checksum How to use checksums	`dc8c57d466303952b6471f01bae937386f3965c71887b70a6bc620bb449b69b5`
Upload date	Sep 1, 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/f1a0bcf81851cf2e917348aabdfc197f40fa8b29

Workflow

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

Artifact

Subject: cvat_cli-2.74.1.tar.gz
SHA-256 checksum: d9998f752b70fa0c24c0635d79ac0774997aaf4f2e536c3f422fc398df24f148 Verifying attestations

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

Download URL	cvat_cli-2.74.1-py3-none-any.whl
Size	34.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`01f91481ff9541c4173bafea388d0f7452456e35371b95f4c92675c0a4a308af`
BLAKE2b-256 checksum How to use checksums	`5369e0bb2b12269cae6b070f60ffa0c665fb13573e00666231ec2fa0b675a541`
Upload date	Sep 1, 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/f1a0bcf81851cf2e917348aabdfc197f40fa8b29

Workflow

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

Artifact

Subject: cvat_cli-2.74.1-py3-none-any.whl
SHA-256 checksum: 01f91481ff9541c4173bafea388d0f7452456e35371b95f4c92675c0a4a308af Verifying attestations