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 是 Intel 开源的数据标注工具,支持图像、视频和 3D 点云标注,能导出 COCO、YOLO 等 20 多种主流格式。这篇文章带你用 Docker 部署 CVAT,配好第一个标注任务,学会用 AI 预标注提速,并讲清团队协作和常见坑,照着做就能上手。
CVAT 标注工作台:左侧工具栏、中间画布、右侧对象列表,图像标注在这里完成
环境装不上?CVAT 的 Docker 快速部署 🐳
CVAT 的依赖不少(Django 后端、Redis、数据库、前端),手动装容易踩坑。最省事的方式是 Docker 部署 CVAT:官方把整套服务打包好了,你只需要机器上有 Docker 和 Docker Compose。
拉代码并启动,一共两条命令:
git clone https://gitcode.com/GitHub_Trending/cvat/cvat && cd cvat docker compose up -d启动后还需要创建一个管理员账号(createsuperuser命令在服务器容器里执行),然后浏览器打开http://localhost:8080,用刚建的账号登录即可。更详细的系统级说明可以看仓库根目录的 README.md。
提示:官方建议在 Chromium 系浏览器(Chrome、Edge)里使用,Safari 不受支持。
从零搭建标注任务:项目、标签与任务怎么配 📋
CVAT 的组织层级是:项目(Project)→ 任务(Task)→ 作业(Job)。项目管"标注什么",任务管"标哪批数据",Job 是任务切分出来的可分配工作单元。
- 建项目:Projects 页面点 Create New Project,填名称和描述。项目的价值在于统一管理标签和复用配置,也可以单独建任务不挂项目。
- 配标签:在标签区点 Add Label,逐条添加类别(如 car、pedestrian),还能给标签挂属性(颜色、尺寸)和属性选项,颜色可以自动分配。
- 建任务:点 Create New Task,数据有三类来源——本地上传(支持 zip 压缩包、视频)、URL 直链、云存储(AWS S3、Azure Blob 等,需先在 Cloud Storages 里配置)。视频任务会自动按帧切分,你还可以设置分割方式(按帧数/时长/场景切换)。
创建完进入任务详情页,就能看到任务下的 Job 列表:给每个 Job 选 Assignee(标注员)、Stage(annotation 标注 / validation 校验)、State(状态)。右侧标签构造器支持 Raw / Constructor 两种编辑模式。
任务详情页:标签构造器(Constructor 模式)在上方,Job 的分配人、阶段、状态在下方表格中直接改
标注太慢?预标注 + 画笔 + 快捷键,三个提效杠杆 ⚡
按"能省多少时间"排序,这三个杠杆依次是:
1. AI 预标注(省最多时间)。在顶部导航的 Models 页面挑一个模型(YOLO、RetinaNet、SAM 等检测/分割/跟踪模型),然后在任务或 Job 上触发自动标注,模型先跑一遍生成初始结果,你只负责修正。仓库里内置了一批 serverless 模型的部署定义,位于 ai-models/,想接自己的模型也可以参考 serverless/ 目录下的框架示例(PyTorch、TensorFlow、ONNX、OpenVINO 都有)。
2. 画笔工具(涂抹出掩码)。语义分割任务里逐点画多边形很慢。CVAT 的画笔(Brushing Tools)可以像画图一样涂抹,工具支持像素模式(直接生成掩码)、多边形模式(涂抹自动生成 polygon)、轮廓吸附(snap to contour)和底层像素参考,涂完自动转成对象,效率比手画高一个量级。
3. 快捷键(细水长流)。把高频操作交给键盘:F框选目标、P切换多边形、Z/Y撤销/重做、Ctrl+S保存。快捷键可以在工作区设置里自定义,乱了可以一键 Restore Defaults。
团队协作与质量管控:分配、进度跟踪、版本回溯 👥
单人标注和团队标注是两套玩法,CVAT 的协作能力集中在组织(Organization)上,后端实现在 cvat/apps/organizations/:
- 人员与角色:创建组织后通过邮件邀请成员,分配 Admin、Manager、Contributor 等角色,不同角色能看到不同的项目和操作权限。
- 任务分配:回到任务详情页,把 Job 的 Assignee 改成对应标注员。一个任务可以拆给多个人并行标,每人负责不同帧区间。
- 流程与质量:Job 的 Stage 决定当前处于标注还是审核阶段。标注完成后交给校验员,校验模式(Review 模式)下审核者可以逐条接受或拒绝标注,并附评论,被拒的对象上会挂 issue 标记,方便追溯。
- 进度跟踪:任务详情里每个 Job 的 State(in progress / completed)、完成帧数、耗时都直接可见;Analytics 页面还能按用户、按任务汇总工作量和事件记录。
- 版本回溯:CVAT 会保留标注历史,误删或改错的对象可以从历史记录里恢复,不用整段重标。
校验阶段(Review 模式):审核者对标注对象逐条做出处理决定
卡住了?高频问题速查 🛠️
- 标注卡顿、大图缩放吃力:先在画布的图片设置里降低预览分辨率或开启 Image Grid(控制网格尺寸和透明度),能明显改善流畅度;本地开发部署可以改用 docker-compose.dev.yml 调整资源配置。
- 自动标注模型加载失败:内置模型依赖 serverless 组件,确认启动时带了
components/serverless/docker-compose.serverless.yml这份 compose 文件,并且模型函数已部署成功;依赖问题可以检查 cvat/requirements/ 下的依赖清单。 - 页面打不开:默认入口是 8080 端口,确认
docker compose ps里服务都是 running;远程访问需要设置CVAT_HOST为机器 IP 或域名。
工作区设置:Image Grid 与亮度、对比度、饱和度等参数都在这里调
CVAT 把"部署—标注—协作—导出"整条链路都免费开源了,从 COCO 格式导出到 Python SDK 自动化都开箱即用。打开终端跑起docker compose up -d,半小时后你就能在 8080 端口里开始第一次标注。
【免费下载链接】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),仅供参考