CVAT数据标注平台快速上手指南:本地部署与第一次标注完整教程
【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat
手头有一批图片要做目标检测标注,或者一段视频需要逐帧标出运动轨迹?CVAT 数据标注平台(Computer Vision Annotation Tool)是开源的视觉数据标注工具,支持图像、视频和 3D 点云标注,并提供 AI 辅助标注、团队协作与 20 多种导出格式。下面按一条完整的使用旅程走一遍:部署、标注、用 AI 加速、团队协作,最后把数据导出给训练框架。
它适合谁:CVAT的典型使用场景
- 算法工程师:需要把标注数据直接对接 COCO、YOLO 等训练格式,减少格式转换成本
- 标注团队负责人:需要分配任务、跟踪进度、做质检,CVAT 内置项目/任务/作业的三级组织与角色体系
- 数据自持要求高的企业:CVAT Community 为 MIT 协议,可完全部署在自己的基础设施内
- 视频与 3D 标注需求方:支持点云 cuboid、骨骼、关键点等标注类型
- 想先零成本试用的新手:官方提供在线版,可直接在浏览器体验,不必先搭环境
5分钟本地部署:Docker Compose 一键启动
前置条件只需安装 Docker Engine、Docker Compose 和 Git。推荐使用 Chromium 系浏览器(Chrome、Edge),Safari 不受支持。
git clone https://gitcode.com/GitHub_Trending/cvat/cvat cd cvat docker compose up -d启动完成后,创建管理员账号(首次部署必做):
docker exec -it cvat_server bash -ic 'python3 ~/manage.py createsuperuser'浏览器打开http://localhost:8080,用刚创建的账号登录。如果访问的不是本机,可提前设置export CVAT_HOST=你的IP或域名。这套编排默认拉起 PostgreSQL、Redis、服务端、前端、Grafana 分析面板等组件,全部配置都在docker-compose.yml中可查。
其余方案一句话带过:Kubernetes 环境可用仓库内的 Helm Chart 部署;只想快速验证功能可用官方在线版试用。
第一次标注怎么做:创建任务到画出第一个框
以"标注 100 张含行人的街景图片"为例:
- 登录后进入 Projects 页面,创建项目并定义标签(如
person、car),可为标签设置颜色和属性 - 在项目中创建任务(Task),上传压缩后的图片包,选择视频或图像序列类型
- 打开任务,左侧工具栏选 Rectangle 工具,在行人身上拖动画出边界框
- 右侧属性面板选择标签类别,按
N切到下一帧继续 - 需要精细轮廓时换 Polygon 工具,依次点击轮廓关键点,双击闭合;想快速涂抹区域可用画笔工具

图中展示的是属性标注模式:选中一个标注对象后,可以在面板上填写结构化属性(如是否戴帽子、朝向),这些信息会随导出数据一起输出。视频标注时配合轨迹(Track)功能,标一次可在后续帧间插值。3D 数据则进入点云画布:
用内置AI模型加速:自动标注配置流程
CVAT 通过 Serverless 函数(Nuclio)挂载预构建模型,仓库内自带 9 个开箱模型,覆盖检测、分割、姿态估计、跟踪:
| 模型 | 框架 | 用途 |
|---|---|---|
| Segment Anything (SAM) | PyTorch | 交互式分割 |
| YOLO v7 | ONNX | 目标检测 |
| RetinaNet R101 | PyTorch | 目标检测 |
| HRNet32 Whole Body Pose | PyTorch | 姿态估计 |
| TransT | PyTorch | 目标跟踪 |
| Face Detection 0205 | OpenVINO | 人脸检测 |
启用步骤:
docker compose -f docker-compose.yml -f components/serverless/docker-compose.serverless.yml up -d这会拉起 Nuclio 基础设施。接着用nuctl部署你需要的模型,以 SAM 为例:
cd serverless/pytorch/facebookresearch/sam/nuclio nuctl deploy function.yaml部署完成后,回到标注界面点击 Auto Annotation 按钮即可在模型列表中选择它。对已有粗框想精细化分割时,可框选 ROI 区域调用 SAM 交互式生成掩码。GPU 环境部署时可换用function-gpu.yaml。
团队协作与质量检查:任务分配和进度跟踪
CVAT 的组织层级是:组织(Organization)→ 项目 → 任务 → 作业(Job)。
- 分配:创建组织后邀请成员并分配角色,把任务切分为多个作业后指派给不同标注员,每人只看到自己名下的作业
- 进度:内置分析面板按用户统计标注量、作业耗时和事件流水,底层数据存在 ClickHouse,面板入口在
http://localhost:8080/analytics,配置位于 components/analytics/grafana/dashboards/ - 质检:审核员通过评论和 Issue 标记问题帧;多人独立标注同一作业后可用 Consensus 对比差异并合并,质检与共识合并的执行器在
cvat_worker_quality_reports、cvat_worker_consensus容器内运行
数据出去:20+格式导出与下游训练衔接
任务页选择 Export Task 即可导出。仓库 cvat/apps/dataset_manager/formats/ 目录下每个文件对应一种格式,包括 COCO(JSON)、YOLO(TXT)、Pascal VOC(XML)、KITTI、MOT、Mask、LabelMe、Open Images 等,导出可选是否打包图像。
两个下游衔接示例:
- 目标检测:导出 YOLO 格式后,训练脚本直接指向导出的
labels目录即可,无需写转换代码 - 实例分割:导出 COCO 格式,配合
mmdet等框架的配置即可加载
想跳过界面批量操作时,可用 Python SDK(pip install cvat-sdk)以编程方式创建任务、上传数据、触发导出,示例脚本在cvat-sdk/examples/下;终端脚本化则用 命令行工具(pip install cvat-cli)。
高频问题排障:部署后最常见的4个坑
页面打不开或白屏
docker compose ps docker compose logs cvat_server重点看cvat_server和traefik两个容器是否为 Up 状态。
忘了管理员账号或登录失败:重新执行前面createsuperuser那条命令创建新账号即可,服务无需重启。
上传大文件失败或很慢:检查磁盘空间与cvat_data卷容量;超大任务建议拆分为多个小任务分批导入,避免单队列长时间阻塞。
Auto Annotation 模型列表为空:说明 serverless 组件或函数没起来,先执行 serverless 的 compose 命令,再确认 Nuclio 容器(容器名nuclio)状态正常。
想看服务端报错细节:打开http://localhost:8080/analytics的 Grafana 日志面板,它聚合了容器日志与事件流。
收尾:从工具到流程
CVAT Community 把标注、质检、导出放在同一套基础设施里,数据始终在你自己的环境内,配合 SDK 和 REST API 可以嵌入到完整的数据流水线中。建议先按本文完成"部署 → 第一个任务 → 一次导出"的闭环,再按需接入自动标注模型。进阶资源:官方文档站点源码(用户手册与教程)、Python SDK、命令行工具、Helm Chart、更新日志。
【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考