Mamba-YOLO

用 Mamba 替 YOLO 主干,精度更高算力更省

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 计算机视觉 🍴 复刻 67 🐛 待处理 78 👀 关注 6
GitHub ↗
GitHub 星标 ★ 658
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

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

项目数据

分类计算机视觉
开发团队HZAI-ZJNU
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议AGPL-3.0
主要语言Python
GitHub 星标★ 658
上线时间2024-06-09 00:00:00
代码更新2026-09-10
仓库体积8.5 MB
本站数据更新2026-11-03
维护状态维护中
收录时间2026-09-20
浏览次数1

项目介绍

Mamba-YOLO 是论文《Mamba-YOLO: SSMs-based for Object Detection》的官方 PyTorch 实现,把状态空间模型(SSM/Mamba)引入目标检测,替代 YOLO 系列常用的 CNN 或 Transformer 主干。它要解决的问题是:Transformer 检测器精度高但自注意力计算量随分辨率平方增长,CNN 又受限于局部感受野。项目用 Mamba 的线性复杂度序列建模能力,在保持全局信息交互的同时降低计算开销,并给出适配检测任务的网络结构与训练配置。核心能力包括可复现的检测精度、对 COCO 等标准数据集的训练/评估脚本,以及与 YOLO 框架相近的工程接口,方便研究者对比 SSM 与 CNN/Transformer 主干的差异。

Star 增长趋势

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

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

使用教程

难度:高级 约 120 分钟 部署方式:本地GPU 6 步

环境要求

  • CUDA 11.8 与 GPU 24G 显存
  • Python 3.11
  • COCO 数据集

安装与启动步骤

  1. 1建环境拉代码

    官方指定 Python 3.11,比多数检测仓库新,别沿用旧的 3.8 环境。

    git clone https://github.com/HZAI-ZJNU/Mamba-YOLO.git
  2. 2装指定版本 torch

    README 写死了 torch 2.3.0,装错版本后面的自编译扩展会失败。

    pip3 install torch===2.3.0 torchvision torchaudio
  3. 3装常用依赖

    seaborn、thop、timm、einops 是检测训练链路的标准件。

    pip install seaborn thop timm einops
  4. 4编译 selective_scan

    Mamba 的核心算子要单独编,这一步最容易卡在 CUDA 版本不匹配。

    cd selective_scan && pip install . && cd ..
  5. 5装本项目

    再回根目录做可编辑安装,之后才能用 mbyolo_train.py。

    pip install -v -e .
  6. 6训 COCO

    先用默认配置跑通,确认数据路径和卡数对了再改自己的数据集。

    python mbyolo_train.py --task train

如何确认成功

selective_scan 编译通过,训练脚本能起训并持续刷新 mAP

注意事项

  • 自编译算子对 CUDA 版本极敏感,先确认 nvcc 版本再动手。
  • nano 规格单卡可训,更大的规格基本要双卡以上。
  • 内存小的话把 dataloader 的 worker 数调低,否则容易 OOM。

核心亮点

  • 把 Mamba/SSM 落到目标检测任务,提供官方 PyTorch 训练与评估代码,可直接复现论文结果
  • 相比 Transformer 检测器,序列建模为线性复杂度,高分辨率特征图上计算更友好
  • 沿用 YOLO 式工程结构,权重、配置、数据接口清晰,便于替换主干做消融实验

不足之处

  • 依赖 mamba-ssm、causal-conv1d 等 CUDA 扩展,环境安装对显卡和编译工具链较敏感
  • 代码与文档主要面向研究复现,缺少部署、量化和移动端推理支持

适用场景

  • 研究 SSM 与 CNN/Transformer 在检测任务上的精度-速度权衡
  • 在边缘或算力受限设备上探索线性复杂度检测主干
  • 以 YOLO 框架为基础,替换主干做目标检测消融与改进实验

替代项目

YOLOv8、RT-DETR、VMamba

上一篇:RT-DETR

下一篇:D-FINE-seg

同类项目推荐

Texo 开源

20M 超轻量模型,浏览器里秒转公式为 LaTeX。

A minimalist SOTA LaTeX OCR model with only 20M parameters, running in browser. Full···

★ 915 2026-09-29
MonkeyOCRv2 开源

专为文档打造的视觉骨干,让 OCR 与版面理解更准

MonkeyOCRv2 Vision Encoder — A Document-Native Visual Backbone

★ 1661 2026-09-19
rabbit-ear 开源

用代码设计折纸,自动计算折叠过程,输出矢量图。

computational origami library

★ 655 2026-08-09
surya 开源

多语言文档一键 OCR,版面表格阅读顺序全搞定

OCR, layout analysis, reading order, table recognition in 90+ languages

★ 21574 2026-09-19
Wis3D 开源

浏览器里直接看3D点云和相机位姿,免装软件

A web-based 3D visualization tool for 3D computer vision.

★ 323 2026-09-18
RT-DETR 开源

无 NMS 端到端检测,精度速度双超 YOLO

[CVPR 2024] Official RT-DETR (RTDETR paddle pytorch), Real-Time DEtection TRansforme···

★ 5647 2026-09-20
production-ocr-course 开源

用 Rust+K8s 把 OCR 从 Demo 做成能扛并发的生产服务

Build, deploy, and scale a production-grade OCR pipeline using Rust, vLLM, Redis, KE···

★ 473 2026-09-19
stitching 开源

多张照片一键拼成全景图,快且稳

A Python package for fast and robust Image Stitching

★ 2641 2026-09-17