每日文摘

深挖 · X-AnyLabeling

题图

练过视觉模型的人都知道,真正的苦活不是训练,是标注。X-AnyLabeling 是一款跨平台桌面 AI 辅助标注应用,把 SAM、YOLO、RT-DETR、Grounding DINO 等 230+ 个模型配置装进一个 GUI:点一下出掩码、一键标注全图、标注完直接导出 YOLO/COCO 训练集。10.3k star、83 万+下载、数据全程不出本地——对个人和小团队来说,它可能是目前最省事的自训数据生产工具。

是什么

X-AnyLabeling 自我定位是「轻量、高效、统一的跨平台桌面应用,面向文本/图像/视频/多模态数据的 AI 辅助标注」(README),官网口号更直白:“Raw data in / Reliable labels out”——原始数据进,可靠标签出(官网)。

它的血统值得说清楚。GitHub 机制上它不是 fork,但代码包至今仍叫 anylabeling/、安装文档要求先卸载 anylabeling 包、README 把 AnyLabeling 列进致谢第一位(pyproject.toml)——实际上是从开源项目 AnyLabeling(约 3.5k star,仍在活跃维护)二次开发出的重投入支线,stars 是上游的 3 倍、commits 是 5 倍,功能大超集。再往前追溯,它接的是 LabelImg 的班:后者只能手工画矩形框,2024 年 2 月已经归档停更(LabelImg README),X-AnyLabeling 等于给「LabelImg 式单机标注」加上了整整一代 AI 能力。

作者是 CVHub520(BibTeX 署名 Wei Wang,GitHub 组织隶属显示 DJI),一个 CV 知识分享自媒体品牌,纯个人项目、赞助制运营,没有企业背景。

能标什么:图像分类、目标检测、实例分割、旋转框(OBB)、姿态关键点、多目标跟踪(MOT)、OCR 与关键信息抽取、车道线、目标计数、图像打标、VQA,外加多边形/矩形/旋转框/四边形/圆/线/点/3D 立方体/掩码十种几何形状(README)。

核心机制(技术)

推理底座以 ONNX Runtime 为主(可选 TensorRT、OpenCV DNN,远程场景还能接 vLLM/SGLang)。每个模型就是一对「.onnx 权重 + YAML 配置」,GUI 里选中即自动下载到 ~/xanylabeling_data/models/;想用自己的权重,把 Model Zoo 里的 YAML 复制一份、model_path 指向本地 onnx、classes 改成自己的标签,“Load Custom Model” 加载即可——同类模型换权重零代码(custom_model.md)。

实际标注是三种范式(user_guide.md):

model_zoo.md 收录约 230+ 条模型配置、13 大任务类:SAM 1/2/3 全系(含 SAM-HQ、SAM-Med2D、MobileSAM 等轻量变体)、YOLOv5 到 YOLO26 全家桶、RT-DETR/D-FINE/RF-DETR 等 DETR 系、PP-OCR 系与 PaddleOCR-VL、Depth Anything、RMBG 抠图,甚至 Qwen3-VL/Gemini/GLM 这类 VLM。

最能体现设计野心的是数据飞轮:零样本模型先冷启动预标注 → 人工修正 → 导出 YOLO 格式 → 训练自己的模型 → ONNX 导回来当标注器 → 第二轮预标注更快更准(custom_model.md)。v3.0 之后干脆内置了基于 Ultralytics 的 GUI 训练平台,标注、训练、导出、导回在一个界面里闭环(examples/training/ultralytics)。官方 FAQ 也明说:开箱模型对私有领域不保证准,精度靠这个闭环自己迭代。

工程上它是典型的单人主导项目——作者一人 1,346 次提交占 91%——但迭代速度惊人:3 年 76 个 release,2026 年 8 月单月连发 v4.0.0 到 v4.0.5 五个版本(v4.0.0 完成 PyQt6 化),有 CI 跨平台构建和中英双语文档(Releases)。

怎么跑起来(环境)

安装按算力选 extras,一个环境只能装一个(get_started.md):

uv pip install "x-anylabeling-cvhub[cpu]"        # CPU
uv pip install "x-anylabeling-cvhub[gpu]"        # CUDA 12.x
uv pip install "x-anylabeling-cvhub[gpu-cu11]"   # CUDA 11.x
uv pip install "x-anylabeling-cvhub[gpu-cu13]"   # CUDA 13.x

平台覆盖 Windows/Linux/macOS,但 GPU 加速只有 Windows/Linux,macOS 只能跑 CPU。不想装环境可以直接下预编译单文件包(v4.0.5:Windows CPU 版 354MB、Linux CUDA12 版 638MB、macOS arm64 版 299MB)。

两个坑提前知道:一是部分高级功能只有源码安装才有——SAM2/3 视频跟踪、交互式检测分割、Ultralytics 训练平台、X-AnyLabeling-Server 远程推理,pip 包和预编译版都不含;二是社区反馈预编译版出问题难排障、GPU 加速支持不完善,认真用建议源码跑(腾讯云社区反馈)。

模型获取对国内用户友好:下载源分 GitHub 和 ModelScope 双线,中文界面默认走 ModelScope,也可完全离线——手动下权重、改 YAML 的 model_path 指过去就行。模型体积跨度很大,从 569KB 的 OCR 分类器到 1.7GB 的 SAM3 encoder(model_zoo.md)。

硬件上官方没给显存数字,旁证可参考:SAM ViT-H 加载约 7GB 显存(上游 segment-anything Issue #33)——所以一张 24GB 的 3090 跑全部图像标注场景都富余,只有 SAM2 视频跟踪这种显存随帧数增长的模式需要留意。

数据集衔接:导出格式覆盖 COCO/VOC/YOLO/DOTA/MOT/MASK/PPOCR/VLM-R1/ShareGPT,内部以自定义 XLABEL(JSON)为中间格式;CLI 提供 19 个 xanylabeling convert 批量转换任务(cli.md)。注意批量自动标注(Ctrl+B)只在 GUI 里,CLI 没有推理命令——想要无人值守的 headless 批标注流水线,它做不到。

数据说话(评测)

2026-09-05 GitHub API 实测:10,343 stars / 1,144 forks / 47 名贡献者 / open issues + PR 仅 10 个;release 附件累计下载 830,880 次,其中单是 v0.2.0 就有 12 万次(GitHub API)。热度还在上升期:2025 年 12 月 7.5k stars,9 个月涨了 2.8k(dev.to)。

口碑中英文社区一致偏正面。Reddit r/computervision 一个 1 万人数据集的选型帖里,最高赞回答是 “Strongly recommend X-AnyLabeling, especially paired with X-AnyLabeling-Server. Full local data control”(Reddit);3.0 发布帖拿了 84 upvotes。中文侧知乎、CSDN、B 站教程生态成熟——不过要提醒:知乎上的「发布文」多数是作者自宣,不是独立评测。

质疑也如实摆出来:

横向定位一句话:它和 CVAT/Label Studio 是互补,不是替代。CVAT、Label Studio 是 Web 服务端平台,强在团队协作、任务分配、质检审核流(CVAT 官方对比文);X-AnyLabeling 是装了就用的单机桌面应用,强在本地 AI 提效和数据隐私。对 Roboflow 这类云端付费工具,它的差异点就是数据不用上传。最后别忘了 GPL-3.0——想把它嵌进自家闭源产品链路,先过法务。

值不值得跟

该用的场景:自己训 CV 模型、数据量在几百到几万张的量级,想省标注工时;隐私敏感、数据不能上云;视频/MOT 数据集(SAM2/3 沿帧传播是杀手级功能);给 VLM 产多模态训练数据(VQA/Chatbot 对话可导出 ShareGPT 格式,官方点名适配 LLaMA-Factory);OCR 票据/文档结构化标注。

不该用的场景:海量数据流水线(官方明说自己不为这个设计);多角色团队的协作审核流(那是 CVAT/Label Studio 的地盘);无人值守 headless 批标注(没有 CLI 推理);想集成进闭源产品(GPL-3.0 传染)。

我的结论:这是一件「该进工具箱备用」的工具。它解决的是 CV 自训流程里最疼的一环——数据生产,且完全本地、免费、活跃维护。哪天你要在 3090 机器上从零训一个自己的检测/分割模型,从标注到导出 YOLO 数据集再到模型导回当标注器,这一条链它全包了。

参考阅读