ViTDet
ViTDet 是一个基于 PyTorch 开发的开源项目,旨在复现并探索“纯视觉 Transformer(Plain Vision Transformer)”在目标检测任务中的强大潜力。它主要解决了传统检测模型过度依赖复杂的层级化骨干网络或特定设计的问题,证明了经过适当适配,结构简洁的标准 Transformer 也能在 COCO 等数据集上取得顶尖的检测与分割精度。
该项目特别适合计算机视觉领域的研究人员和开发者使用。如果你希望深入理解 Transformer 架构在下游任务中的应用机制,或者需要一套高性能的代码基准来对比实验,ViTDet 提供了详尽的训练配置、日志记录以及预训练权重。其核心技术亮点在于验证了仅需简单的适配器模块,即可将原本用于图像分类的 Plain ViT 骨干网络(如 ViT-Base 及 ViTAE 系列)高效迁移至目标检测领域,并在 Mask R-CNN 框架下实现了超过 51% 的框检测 mAP。通过支持多种预训练策略(如 MAE)和硬件环境,ViTDet 为构建更简洁、通用的视觉感知系统提供了有力的技术参考。
使用场景
某自动驾驶初创公司的算法团队正在开发夜间城市道路的车辆与行人检测系统,急需提升模型在复杂光照下的识别精度。
没有 ViTDet 时
- 特征提取能力受限:传统 CNN 骨干网络(如 ResNet)感受野固定,难以捕捉夜间模糊图像中车辆的全局上下文信息,导致小目标漏检率高。
- 架构设计复杂:为了弥补主干网缺陷,工程师不得不引入复杂的特征金字塔(FPN)或多阶段结构,增加了代码维护难度和训练调参成本。
- 精度遭遇瓶颈:即便堆叠更多层数或使用更重的模型,在 COCO 验证集上的框检测平均精度(Box mAP)始终卡在 45% 左右,无法满足量产安全标准。
- 迁移效果不佳:直接在大规模数据集预训练的模型迁移到特定夜间场景时,因缺乏对长距离依赖的建模能力,泛化表现不稳定。
使用 ViTDet 后
- 全局感知增强:ViTDet 采用纯 Vision Transformer 作为骨干,利用自注意力机制有效捕捉图像全局特征,显著提升了夜间弱光下模糊车辆的检出率。
- 架构极简高效:团队移除了繁琐的多阶段设计,直接使用简单的单尺度特征输入配合 ViTDet,不仅简化了推理流程,还降低了工程落地复杂度。
- 性能大幅突破:基于 ViT-Base 骨干的模型在同等训练条件下,将 Box mAP 从 45% 提升至 51.1%,成功跨越了量产所需的精度门槛。
- 预训练优势明显:结合 MAE 等大规模自监督预训练权重,ViTDet 展现出极强的迁移能力,仅需少量微调即可适应夜间特殊场景。
ViTDet 通过“简单骨干 + 强力预训练”的范式,证明了去除复杂归纳偏置后,纯 Transformer 架构能在目标检测任务中实现精度与简洁性的双重飞跃。
运行环境要求
- Linux
- 必需,实验基于 NVIDIA A100 (4 台机器,每台 2 张卡) 或 TPU 进行
- 需支持 CUDA 的 NVIDIA GPU
未说明

快速开始
目标检测中探索简单视觉Transformer主干网络的非官方PyTorch实现
本分支包含目标检测中探索简单视觉Transformer主干网络的非官方 PyTorch 实现。感谢他们的出色工作!
本仓库在COCO上的结果
模型在4台A100机器上训练,每GPU处理2张图像,因此训练时的批量大小为64。
| 模型 | 预训练 | 设备 | 框架 | Box mAP | Mask mAP | 配置文件 | 日志 | 权重 |
|---|---|---|---|---|---|---|---|---|
| ViT-Base | IN1K+MAE | TPU | Mask RCNN | 51.1 | 45.5 | 配置 | 日志 | OneDrive |
| ViT-Base | IN1K+MAE | GPU | Mask RCNN | 51.1 | 45.4 | 配置 | 日志 | OneDrive |
| ViTAE-Base | IN1K+MAE | GPU | Mask RCNN | 51.6 | 45.8 | 配置 | 日志 | OneDrive |
| ViTAE-Small | IN1K+Sup | GPU | Mask RCNN | 45.6 | 40.1 | 配置 | 日志 | OneDrive |
更新
[2022-04-18] 探索使用小型1K监督训练模型(20M参数)用于ViTDet(45.6 mAP)。采用多阶段结构后,Swin-T 的结果为 46.0 mAP,而 ViTAEv2-S 在COCO数据集上使用Mask RCNN时达到 47.8 mAP。
[2022-04-17] 发布了ViT-B和ViTAE-B在MS COCO上的预训练权重和日志。这些模型完全使用PyTorch在GPU上训练完成。
[2022-04-16] 发布了基于ViT-Base模型的ViTDet初始非官方实现!该模型在检测和分割任务上分别取得了51.1 mAP和45.5 mAP的成绩。权重和日志将很快上传。
ViTAE Transformer的应用包括:图像分类 | 目标检测 | 语义分割 | 动物姿态分割 | 遥感 | 抠图
使用方法
我们使用PyTorch 1.9.0或NGC Docker 21.06,以及mmcv 1.3.9进行实验。
git clone https://github.com/open-mmlab/mmcv.git
cd mmcv
git checkout v1.3.9
MMCV_WITH_OPS=1 pip install -e .
cd ..
git clone https://github.com/ViTAE-Transformer/ViTDet.git
cd ViTDet
pip install -v -e .
安装完这两个仓库后,再安装timm和einops,即:
pip install timm==0.4.9 einops
从MAE或ViTAE下载预训练模型,然后通过以下方式开展实验:
# 单机运行
bash tools/dist_train.sh <Config PATH> <NUM GPUs> --cfg-options model.pretrained=<Pretrained PATH>
# 多机运行
python -m torch.distributed.launch --nnodes <Num Machines> --node_rank <Rank of Machine> --nproc_per_node <GPUs Per Machine> --master_addr <Master Addr> --master_port <Master Port> tools/train.py <Config PATH> --cfg-options model.pretrained=<Pretrained PATH> --launcher pytorch
待办事项
当前本仓库包含以下修改:
- 在RPN和头部中使用LN替代卷积
- 使用大规模jittor进行数据增强
- 使用来自MViT的RPE
- 延长训练周期并采用1024的测试尺寸
- 使用全局注意力层
此外还有其他待办事项:
实现用于全局信息传递的卷积块
调优Cascade RCNN模型
训练ViT模型以适应LVIS数据集
使用ViTDet框架训练ViTAE模型
致谢
我们感谢mmdetection、MAE、MViT以及BeiT提供的优秀实现。
引用ViTDet
@article{Li2022ExploringPV,
title={Exploring Plain Vision Transformer Backbones for Object Detection},
author={Yanghao Li and Hanzi Mao and Ross B. Girshick and Kaiming He},
journal={ArXiv},
year={2022},
volume={abs/2203.16527}
}
对于ViTAE和ViTAEv2,请参考:
@article{xu2021vitae,
title={Vitae: Vision transformer advanced by exploring intrinsic inductive bias},
author={Xu, Yufei and Zhang, Qiming and Zhang, Jing and Tao, Dacheng},
journal={Advances in Neural Information Processing Systems},
volume={34},
year={2021}
}
@article{zhang2022vitaev2,
title={ViTAEv2: Vision Transformer Advanced by Exploring Inductive Bias for Image Recognition and Beyond},
author={Zhang, Qiming and Xu, Yufei and Zhang, Jing and Tao, Dacheng},
journal={arXiv preprint arXiv:2202.10108},
year={2022}
}
常见问题
相似工具推荐
openclaw
OpenClaw 是一款专为个人打造的本地化 AI 助手,旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚,能够直接接入你日常使用的各类通讯渠道,包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息,OpenClaw 都能即时响应,甚至支持在 macOS、iOS 和 Android 设备上进行语音交互,并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地,用户无需依赖云端服务即可享受快速、私密的智能辅助,真正实现了“你的数据,你做主”。其独特的技术亮点在于强大的网关架构,将控制平面与核心助手分离,确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者,以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力(支持 macOS、Linux 及 Windows WSL2),即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
gemini-cli
gemini-cli 是一款由谷歌推出的开源 AI 命令行工具,它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言,它提供了一条从输入提示词到获取模型响应的最短路径,无需切换窗口即可享受智能辅助。 这款工具主要解决了开发过程中频繁上下文切换的痛点,让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用,还是执行复杂的 Git 操作,gemini-cli 都能通过自然语言指令高效处理。 它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口,具备出色的逻辑推理能力;内置 Google 搜索、文件操作及 Shell 命令执行等实用工具;更独特的是,它支持 MCP(模型上下文协议),允许用户灵活扩展自定义集成,连接如图像生成等外部能力。此外,个人谷歌账号即可享受免费的额度支持,且项目基于 Apache 2.0 协议完全开源,是提升终端工作效率的理想助手。
markitdown
MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具,专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片(含 OCR)、音频(含语音转录)、HTML 乃至 YouTube 链接等多种格式的解析,能够精准提取文档中的标题、列表、表格和链接等关键结构信息。 在人工智能应用日益普及的今天,大语言模型(LLM)虽擅长处理文本,却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点,它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式,成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外,它还提供了 MCP(模型上下文协议)服务器,可无缝集成到 Claude Desktop 等 LLM 应用中。 这款工具特别适合开发者、数据科学家及 AI 研究人员使用,尤其是那些需要构建文档检索增强生成(RAG)系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性,但其核心优势在于为机器