如何部署 CVAT:本地搭建 AI 数据标注平台
【免费下载链接】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 点云标注,内置团队协作、质量检查和多格式数据集导出能力。当团队需要把标注数据完整保留在自己的基础设施内时,就需要在本地部署这套服务。部署完成后,CVAT 监听 8080 端口,浏览器即可打开标注界面,数据不出本机。
部署 CVAT 前需要满足的环境条件
CVAT 的默认部署完全基于 Docker Compose,机器上只需准备 Docker Engine、Docker Compose 和 Git 三个组件,可以先用docker --version确认环境是否就绪。💾 资源方面,首次拉取镜像和初始化大约需要 20GB 磁盘空间,内存建议 8GB 起步。浏览器推荐使用 Chrome 或 Edge 等 Chromium 系内核,Safari 不在官方支持列表内。
拉取代码并执行 CVAT 启动命令
仓库根目录的 docker-compose.yml 定义了整套服务:后端 API(cvat_server)、前端界面、PostgreSQL、两个 Redis 实例、权限策略服务 OPA 以及分析组件,克隆代码后即可一次启动。
git clone https://gitcode.com/GitHub_Trending/cvat/cvat cd cvat在仓库根目录启动全部容器。首次运行要拉取镜像并初始化数据库,⏳ 耗时约 2-5 分钟,期间容器会逐步进入运行状态。
docker compose up -d进度可以用docker compose logs -f实时跟踪;确认后端容器正常后再做下一步,此时数据库已完成建表。
创建管理员账户并验证 CVAT 服务可用
CVAT 不预置任何账号,需要手动创建超级用户。这条命令进入后端容器执行 Django 的管理脚本,按提示输入用户名、邮箱和密码即可:
docker exec -it cvat_server bash -ic 'python3 ~/manage.py createsuperuser'创建完成后,浏览器打开 http://localhost:8080 并用该账户登录。能进入任务列表页,说明后端 API、前端和数据库已经连通;接着新建一个任务,上传几张图片、定义标签并保存一个矩形框,就能验证整条标注链路。
处理 CVAT 端口冲突与容器权限报错
⚠️ 最常见的故障是 8080 端口被其他程序占用:容器显示在运行,但浏览器打不开页面。修改 docker-compose.yml 中 traefik 服务的端口映射,把8080:8080改成8081:8080之类,再重新执行docker compose up -d生效。
另一类报错出现在执行任何 docker 命令时提示 permission denied,原因是当前用户没有 docker 套接字权限,可把用户加入 docker 组,或临时改用 sudo 执行。
如果某个服务状态异常需要彻底重建,先停掉并清理全部容器,再重新启动:
docker compose down docker compose up -d部署完成后的标注能力与协作入口
登录后,工作区按 Project、Task、Job 三级组织:项目聚合一批数据,任务按数据源拆分,作业是分配给标注员的最小单位,进度可实时查看,成员与角色在同一页面管理。
标注速度不够时,可以接入检测模型做自动标注,在 Automatic annotation 面板里选择模型、建立模型输出与项目标签的映射,并限定兴趣区域后一键生成初始结果。
除了图像和视频,CVAT 支持点云标注,画布提供 Top、Side、Front 三个正交视角,适合自动驾驶数据集的标注场景。
标注结果可导出为 COCO、YOLO、Pascal VOC 等 20 多种格式,也可以直接使用仓库内的 cvat-sdk Python SDK 与 cvat-cli 命令行工具,把创建任务、上传和导出串进自动化流水线。
【免费下载链接】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),仅供参考