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.79.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.79.0
File	Size	Uploaded
cvat_cli-2.79.0.tar.gz	26.8 kB	Oct 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cvat-cli 2.79.0
File	Interpreter	ABI	Platform	Reset
cvat_cli-2.79.0-py3-none-any.whl 34.9 kB Oct 15, 2026	Python 3	none	any	Details

Total release size: 61.7 kB

Release files / cvat_cli-2.79.0.tar.gz

Download URL	cvat_cli-2.79.0.tar.gz
Size	26.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`869873eccd15d9f3f1aa2d5a0f9959826a23886aa8f12ea49538ba3e126ca59a`
BLAKE2b-256 checksum How to use checksums	`1faf9bd4157b2c65d0832cb6de149138baae12def9c4ddd7b76d3b104aee40d3`
Upload date	Oct 15, 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/9176834830e2e931a8d3a6857dcf43c6cc0ee927

Workflow

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

Artifact

Subject: cvat_cli-2.79.0.tar.gz
SHA-256 checksum: 869873eccd15d9f3f1aa2d5a0f9959826a23886aa8f12ea49538ba3e126ca59a Verifying attestations

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

Download URL	cvat_cli-2.79.0-py3-none-any.whl
Size	34.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`354a17b78953d9909937b4b0ff24c10b53c85dfef721951f0c44daa86f419089`
BLAKE2b-256 checksum How to use checksums	`b4812043bb35ae2b3f933ae96c34e4dced3a61f3877e5872293f40f5e1b81364`
Upload date	Oct 15, 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/9176834830e2e931a8d3a6857dcf43c6cc0ee927

Workflow

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

Artifact

Subject: cvat_cli-2.79.0-py3-none-any.whl
SHA-256 checksum: 354a17b78953d9909937b4b0ff24c10b53c85dfef721951f0c44daa86f419089 Verifying attestations