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.75.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.75.0
File	Size	Uploaded
cvat_cli-2.75.0.tar.gz	26.7 kB	Sep 10, 2026	Details

Built distribution (wheel)

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

Total release size: 61.5 kB

Release files / cvat_cli-2.75.0.tar.gz

Download URL	cvat_cli-2.75.0.tar.gz
Size	26.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`69aa16d2a1b95f8003861fbc3eb246afc2713882bd1fdcb77bfbbb7a68381c00`
BLAKE2b-256 checksum How to use checksums	`9bc1d987ef87283c1d995a199fd06a832e09d6c88991adc7b09cd30b9c1d6afa`
Upload date	Sep 10, 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/2a8340fb10ac85f45fd0eef18aaf3f814178cb04

Workflow

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

Artifact

Subject: cvat_cli-2.75.0.tar.gz
SHA-256 checksum: 69aa16d2a1b95f8003861fbc3eb246afc2713882bd1fdcb77bfbbb7a68381c00 Verifying attestations

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

Download URL	cvat_cli-2.75.0-py3-none-any.whl
Size	34.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`27a2656c8fa2712066f1d08663d5ce53a72da2ed0b24bd7aed58e5493bc3be29`
BLAKE2b-256 checksum How to use checksums	`f82a670c20492b7be54272db075a8c99772d8e894a58acca5df1e541a3ac05d9`
Upload date	Sep 10, 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/2a8340fb10ac85f45fd0eef18aaf3f814178cb04

Workflow

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

Artifact

Subject: cvat_cli-2.75.0-py3-none-any.whl
SHA-256 checksum: 27a2656c8fa2712066f1d08663d5ce53a72da2ed0b24bd7aed58e5493bc3be29 Verifying attestations