# cvat-ai/cvat architecture

> Architecture diagram of the GitHub repository cvat-ai/cvat, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cvat-ai/cvat
- Repository: https://github.com/cvat-ai/cvat

## Overview

CVAT is a self-hosted computer-vision annotation platform. Its main workflow is to create a project or task, upload media, annotate it in a modality-specific workspace, and save or export annotations; teams can assign and review work and use connected models for auto-labeling. The graph also includes the documented SDK/CLI, cloud-storage, quality-control, analytics, and format capabilities. Evidence is limited to the README and indexed excerpts; unsampled subsystem links are omitted or marked unverified.

Main entry points: [`cvat-ui/src/components/annotation-page/annotation-page.tsx`](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/annotation-page/annotation-page.tsx) (Web application), [`cvat/apps/engine/models.py`](https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/engine/models.py) (Task and job data), [`cvat-core/src/server-proxy.ts`](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/server-proxy.ts) (Core API client), [`cvat-sdk/cvat_sdk/core/client.py`](https://github.com/cvat-ai/cvat/blob/develop/cvat-sdk/cvat_sdk/core/client.py) (Python SDK)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Annotation experience"]
  node_web["Web application"]
  node_canvas2d["2D canvas<br/>[canvasModel.ts]"]
  node_canvas3d["3D canvas<br/>[canvas3dModel.ts]"]
  node_audio["Audio workspace"]
end

subgraph group_platform["Core platform"]
  node_annotations["Annotation model<br/>[shape.ts]"]
  node_coreapi["Core API client<br/>[server-proxy.ts]"]
  node_frames["Media frames<br/>[frames.ts]"]
  node_taskdata[("Task and job data<br/>[models.py]")]
  node_asyncjobs["Background requests<br/>[background.py]"]
end

subgraph group_collaboration["Team and quality"]
  node_organizations["Organizations<br/>[organization.ts]"]
  node_review["Review and issues"]
  node_consensus["Consensus merge<br/>[merging_manager.py]"]
  node_quality["Quality reports<br/>[queue_manager.py]"]
  node_analytics["Analytics"]
end

subgraph group_automation["Automation interfaces"]
  node_sdk["Python SDK<br/>[client.py]"]
  node_cli["Command-line tool<br/>[commands_tasks.py]"]
  node_models["Serverless models<br/>[model_handler.py]"]
end

subgraph group_integrations["Data and integrations"]
  node_formats["Annotation formats"]
  node_cloud["Cloud storage<br/>[cloud-storage.ts]"]
  node_cloudui["Cloud storage setup"]
end

node_annotator(("Annotator"))

node_annotator -->|"uses"| node_web
node_web -->|"annotates images"| node_canvas2d
node_web -->|"annotates point clouds"| node_canvas3d
node_web -->|"annotates audio"| node_audio
node_web -.->|"requests platform data"| node_coreapi
node_coreapi -->|"calls server API"| node_taskdata
node_coreapi -->|"loads frame data"| node_frames
node_web -.->|"edits annotations"| node_annotations
node_web -->|"creates and manages tasks"| node_taskdata
node_taskdata -.->|"queues processing"| node_asyncjobs
node_web -->|"collaborates in teams"| node_organizations
node_web -->|"reviews work"| node_review
node_taskdata -->|"merges replicas"| node_consensus
node_taskdata -->|"checks quality"| node_quality
node_web -->|"views activity"| node_analytics
node_cli -->|"runs task commands"| node_sdk
node_sdk -->|"automates REST API"| node_coreapi
node_web -.->|"requests auto-labeling"| node_models
node_web -->|"imports and exports"| node_formats
node_web -->|"configures storage"| node_cloudui
node_cloudui -->|"creates storage"| node_cloud
node_cloud -->|"calls storage endpoints"| node_coreapi

click node_web "https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/annotation-page/annotation-page.tsx"
click node_canvas2d "https://github.com/cvat-ai/cvat/blob/develop/cvat-canvas/src/typescript/canvasModel.ts"
click node_canvas3d "https://github.com/cvat-ai/cvat/blob/develop/cvat-canvas3d/src/typescript/canvas3dModel.ts"
click node_audio "https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/audio/components/annotation-page/audio-workspace/audio-workspace.tsx"
click node_annotations "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/annotations-objects/shape.ts"
click node_coreapi "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/server-proxy.ts"
click node_frames "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/frames.ts"
click node_taskdata "https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/engine/models.py"
click node_asyncjobs "https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/redis_handler/background.py"
click node_organizations "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/organization.ts"
click node_review "https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/annotation-page/review-workspace/review-workspace.tsx"
click node_consensus "https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/consensus/merging_manager.py"
click node_quality "https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/quality_control/queue_manager.py"
click node_analytics "https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/analytics-report/analytics-report-page.tsx"
click node_sdk "https://github.com/cvat-ai/cvat/blob/develop/cvat-sdk/cvat_sdk/core/client.py"
click node_cli "https://github.com/cvat-ai/cvat/blob/develop/cvat-cli/src/cvat_cli/_internal/commands_tasks.py"
click node_models "https://github.com/cvat-ai/cvat/blob/develop/serverless/onnx/WongKinYiu/yolov7/nuclio/model_handler.py"
click node_formats "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/annotation-formats.ts"
click node_cloud "https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/cloud-storage.ts"
click node_cloudui "https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/create-cloud-storage-page/cloud-storage-form.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_canvas2d,node_canvas3d,node_audio toneBlue
class node_annotations,node_coreapi,node_frames,node_taskdata,node_asyncjobs toneAmber
class node_organizations,node_review,node_consensus,node_quality,node_analytics toneMint
class node_sdk,node_cli,node_models toneRose
class node_formats,node_cloud,node_cloudui,node_annotator toneIndigo
```

## Components

### Annotation experience

- [Web application](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/annotation-page/annotation-page.tsx): `cvat-ui/src/components/annotation-page/annotation-page.tsx`
- [2D canvas](https://github.com/cvat-ai/cvat/blob/develop/cvat-canvas/src/typescript/canvasModel.ts): `cvat-canvas/src/typescript/canvasModel.ts`
- [3D canvas](https://github.com/cvat-ai/cvat/blob/develop/cvat-canvas3d/src/typescript/canvas3dModel.ts): `cvat-canvas3d/src/typescript/canvas3dModel.ts`
- [Audio workspace](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/audio/components/annotation-page/audio-workspace/audio-workspace.tsx): `cvat-ui/src/audio/components/annotation-page/audio-workspace/audio-workspace.tsx`

### Core platform

- [Annotation model](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/annotations-objects/shape.ts): `cvat-core/src/annotations-objects/shape.ts`
- [Core API client](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/server-proxy.ts): `cvat-core/src/server-proxy.ts`
- [Media frames](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/frames.ts): `cvat-core/src/frames.ts`
- [Task and job data](https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/engine/models.py): `cvat/apps/engine/models.py`
- [Background requests](https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/redis_handler/background.py): `cvat/apps/redis_handler/background.py`

### Team and quality

- [Organizations](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/organization.ts): `cvat-core/src/organization.ts`
- [Review and issues](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/annotation-page/review-workspace/review-workspace.tsx): `cvat-ui/src/components/annotation-page/review-workspace/review-workspace.tsx`
- [Consensus merge](https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/consensus/merging_manager.py): `cvat/apps/consensus/merging_manager.py`
- [Quality reports](https://github.com/cvat-ai/cvat/blob/develop/cvat/apps/quality_control/queue_manager.py): `cvat/apps/quality_control/queue_manager.py`
- [Analytics](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/analytics-report/analytics-report-page.tsx): `cvat-ui/src/components/analytics-report/analytics-report-page.tsx`

### Automation interfaces

- [Python SDK](https://github.com/cvat-ai/cvat/blob/develop/cvat-sdk/cvat_sdk/core/client.py): `cvat-sdk/cvat_sdk/core/client.py`
- [Command-line tool](https://github.com/cvat-ai/cvat/blob/develop/cvat-cli/src/cvat_cli/_internal/commands_tasks.py): `cvat-cli/src/cvat_cli/_internal/commands_tasks.py`
- [Serverless models](https://github.com/cvat-ai/cvat/blob/develop/serverless/onnx/WongKinYiu/yolov7/nuclio/model_handler.py): `serverless/onnx/WongKinYiu/yolov7/nuclio/model_handler.py`

### Data and integrations

- [Annotation formats](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/annotation-formats.ts): `cvat-core/src/annotation-formats.ts`
- [Cloud storage](https://github.com/cvat-ai/cvat/blob/develop/cvat-core/src/cloud-storage.ts): `cvat-core/src/cloud-storage.ts`
- [Cloud storage setup](https://github.com/cvat-ai/cvat/blob/develop/cvat-ui/src/components/create-cloud-storage-page/cloud-storage-form.tsx): `cvat-ui/src/components/create-cloud-storage-page/cloud-storage-form.tsx`

### Other components

- **Annotator**

## Connections

- Annotator → Web application: uses
- Web application → 2D canvas: annotates images
- Web application → 3D canvas: annotates point clouds
- Web application → Audio workspace: annotates audio
- Web application → Core API client: requests platform data
- Core API client → Task and job data: calls server API (evidence: `cvat-core/src/server-proxy.ts`)
- Core API client → Media frames: loads frame data (evidence: `cvat-core/src/frames.ts`)
- Web application → Annotation model: edits annotations
- Web application → Task and job data: creates and manages tasks
- Task and job data → Background requests: queues processing (evidence: `cvat/apps/redis_handler/background.py`)
- Web application → Organizations: collaborates in teams
- Web application → Review and issues: reviews work
- Task and job data → Consensus merge: merges replicas (evidence: `cvat/apps/consensus/merging_manager.py`)
- Task and job data → Quality reports: checks quality (evidence: `cvat/apps/quality_control/queue_manager.py`)
- Web application → Analytics: views activity
- Command-line tool → Python SDK: runs task commands (evidence: `cvat-cli/src/cvat_cli/_internal/commands_tasks.py`)
- Python SDK → Core API client: automates REST API
- Web application → Serverless models: requests auto-labeling
- Web application → Annotation formats: imports and exports
- Web application → Cloud storage setup: configures storage
- Cloud storage setup → Cloud storage: creates storage (evidence: `cvat-ui/src/components/create-cloud-storage-page/cloud-storage-form.tsx`)
- Cloud storage → Core API client: calls storage endpoints (evidence: `cvat-core/src/cloud-storage.ts`)
