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.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.74.0
File	Size	Uploaded
cvat_cli-2.74.0.tar.gz	26.6 kB	Aug 26, 2026	Details

Built distribution (wheel)

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

Total release size: 61.4 kB

Release files / cvat_cli-2.74.0.tar.gz

Download URL	cvat_cli-2.74.0.tar.gz
Size	26.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`3e2e17d87240ace9f2b63293a6feae90ce8aa9b2faca95cb5d889bd8b106de94`
BLAKE2b-256 checksum How to use checksums	`7fa85c2be37ffae11e54ea911d3749752d223385baf1f5603d42f7dd6bb49bcb`
Upload date	Aug 26, 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/c494299bbd225d6d0fc5e8a5e2668447abf50d70

Workflow

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

Artifact

Subject: cvat_cli-2.74.0.tar.gz
SHA-256 checksum: 3e2e17d87240ace9f2b63293a6feae90ce8aa9b2faca95cb5d889bd8b106de94 Verifying attestations

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

Download URL	cvat_cli-2.74.0-py3-none-any.whl
Size	34.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`386cc877bd37648bf40bc28a5cae39a6f6e18b9d78de0ce5424e448413754d5b`
BLAKE2b-256 checksum How to use checksums	`054792ebd24f5f1d76bfc2739bdefc2ec2f88b7d703fcf4cbb70bf1b91f99c76`
Upload date	Aug 26, 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/c494299bbd225d6d0fc5e8a5e2668447abf50d70

Workflow

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

Artifact

Subject: cvat_cli-2.74.0-py3-none-any.whl
SHA-256 checksum: 386cc877bd37648bf40bc28a5cae39a6f6e18b9d78de0ce5424e448413754d5b Verifying attestations