detectron2

用配置组合模型,快速训练检测分割模型

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 计算机视觉 🍴 复刻 7939 🐛 待处理 601 👀 关注 394
GitHub ↗
GitHub 星标 ★ 34984
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,Apache 2.0 许可证

项目预览

detectron2 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类计算机视觉
开发团队facebookresearch
定价模式🏷️完全免费
价格说明开源免费,Apache 2.0 许可证
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
GitHub 星标★ 34984
上线时间2019-09-05 00:00:00
代码更新2026-10-27
仓库体积6.8 MB
本站数据更新2026-11-15
维护状态较活跃
收录时间2026-09-30
浏览次数1

项目介绍

Detectron2 是 Meta AI(原 Facebook AI Research)开源的计算机视觉算法平台,基于 PyTorch 构建,用于目标检测、实例分割、语义分割、关键点检测等视觉识别任务。它把主流检测与分割模型(如 Faster R-CNN、Mask R-CNN、RetinaNet、FCOS、Panoptic FPN 等)统一到模块化架构中,用户可通过配置文件组合骨干网络、区域提议、检测头与数据增强,无需从零实现。项目提供 COCO 等数据集的训练与推理脚本、预训练模型库、评估工具和可视化能力,并支持分布式训练、混合精度与模型导出。相比早期 Detectron(Caffe2 版),它完全基于 PyTorch,更易调试和扩展,适合研究者复现论文与工程师搭建检测分割流水线,是工业界与学术界广泛采用的视觉基线框架。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-30 · 当前星标 ★ 34984

使用教程

难度:进阶 约 10 分钟 部署方式:库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境(Detectron2 是以库形式使用的 Python 项目,README 未给出具体版本要求)
  • PyTorch(项目基于 PyTorch 构建)
  • 可访问 GitHub 与 detectron2.readthedocs.io 官方文档的网络
  • 如需 GPU 加速或分布式训练,需按官方文档准备匹配的 CUDA 环境

安装与启动步骤

  1. 1克隆项目仓库

    把 detectron2 源码下载到本地,后续按官方文档从源码安装或作为库引入到自己的工程中。

    git clone https://github.com/facebookresearch/detectron2.git
  2. 2查阅官方安装文档

    README 正文没有给出任何安装命令,只提供安装文档链接,安装方式与依赖以该文档为准。

  3. 3准备 PyTorch 环境

    先按 PyTorch 官方说明装好与机器 CUDA 匹配的 PyTorch,再在同一环境中安装 detectron2。

  4. 4进入仓库目录

    切换到克隆下来的源码目录,便于按官方安装文档在源码根目录执行后续步骤。

    cd detectron2
  5. 5跑通入门示例

    打开 Getting Started 文档或官方 Colab Notebook,运行推理示例,了解配置、预训练模型与可视化用法。

如何确认成功

按官方安装文档完成安装且无报错,并能跑通 Getting Started 或官方 Colab Notebook 中的推理示例,即视为可用。

常见问题

Q:为什么教程里没有 pip install detectron2 之类的安装命令?

A:因为 README 只给出了官方安装文档链接,没有写具体命令。安装方式(含编译、依赖、CUDA 匹配)请以该官方文档为准,避免照抄过期命令。

Q:想先快速看看效果,不想直接搭环境怎么办?

A:README 推荐使用官方 Colab Notebook(Getting Started 文档中给出),可在浏览器里直接体验基础推理用法,再决定是否本地安装。

Q:detectron2 能做什么任务?

A:支持目标检测、实例分割、语义分割、关键点检测,以及全景分割、DensePose、旋转框、PointRend、DeepLab、ViTDet、MViTv2 等能力。

Q:训练好的模型怎么部署?

A:README 说明模型可导出为 TorchScript 或 Caffe2 格式用于部署,具体导出流程需查阅官方文档。

Q:安装文档打不开或版本对不上怎么办?

A:请确认网络可访问 detectron2.readthedocs.io,并核对文档版本与你的 PyTorch、CUDA 版本是否匹配,必要时改用官方 Colab 环境验证。

注意事项

  • 本项目 README 未提供任何安装命令,所有安装与依赖细节必须以官方安装文档为准,不要凭猜测执行 pip 或 conda 命令。
  • 建议先克隆仓库或直接用官方 Colab Notebook 跑通示例,再考虑本地源码安装,可减少环境问题排查成本。
  • PyTorch 版本与 CUDA 版本的匹配关系会直接影响 detectron2 安装成败,安装前先确认二者对应关系。
  • 想基于 detectron2 做二次开发,可参考仓库中的 projects/ 目录,里面是构建在其之上的示例项目。

核心亮点

  • 模块化设计,骨干网络、检测头、数据增强可自由替换组合
  • 官方提供大量 COCO 预训练模型与训练配置,开箱即用
  • 基于 PyTorch 生态,调试、扩展和部署链路成熟

不足之处

  • 安装依赖较复杂,对 CUDA、PyTorch 与编译环境版本敏感
  • API 迭代较快,旧版本代码升级时存在兼容性成本

适用场景

  • 复现目标检测或实例分割论文并做对比实验
  • 在自有数据集上微调预训练模型,快速搭建检测系统
  • 作为视觉算法基线,集成到自动驾驶、安防或工业质检流水线

替代项目

mmdetection、YOLOv5、detectron

同类项目推荐

awesome-segment-anything 开源

一网打尽 SAM 生态资源,快速上手图像分割

Tracking and collecting papers/projects/others related to Segment Anything.

★ 1697 2026-08-09
HTR-VT 开源

用纯 ViT 做手写文字识别,跑通训练到推理

(Pattern Recognition) Pytorch implementation of “HTR-VT: Handwritten Text Recogniti···

★ 140 2026-09-30
awesome-yolo-object-detection 开源

一份清单,快速找到你想要的 YOLO 模型和数据集。

A collection of some awesome public YOLO object detection series projects and the re···

★ 1804 2026-08-09
VGGT-Det-CVPR2026 开源

不用相机标定,多视角直接检测室内3D物体

Official code for CVPR 2026 paper: VGGT-Det: Mining VGGT Internal Priors for Sensor-···

★ 164 2026-09-30
ViGeo 开源

让视频几何估计更连贯,重建更稳定

ViGeo: Towards Consistent Video Geometry Estimation

★ 143 2026-08-09
GLM-OCR 开源

GLM 驱动的开源 OCR,图片文字快速准确提取

GLM-OCR: Accurate × Fast × Comprehensive

★ 7593 2026-10-27
AnomalyDINO 开源

用少量正常样本,精准揪出图像中的异常区域

[WACV2025] AnomalyDINO: Boosting Patch-based Few-shot Anomaly Detection with DINOv2

★ 274 2026-08-09
Anime2Sketch 开源

一键将动漫图变线稿,省去手工描线

A sketch extractor for anime/illustration.

★ 2146 2026-08-09