
Mamba-YOLO
用 Mamba 替 YOLO 主干,精度更高算力更省
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-20 · 当前星标 ★ 658
使用教程
环境要求
- CUDA 11.8 与 GPU 24G 显存
- Python 3.11
- COCO 数据集
安装与启动步骤
-
1建环境拉代码
官方指定 Python 3.11,比多数检测仓库新,别沿用旧的 3.8 环境。
git clone https://github.com/HZAI-ZJNU/Mamba-YOLO.git -
2装指定版本 torch
README 写死了 torch 2.3.0,装错版本后面的自编译扩展会失败。
pip3 install torch===2.3.0 torchvision torchaudio -
3装常用依赖
seaborn、thop、timm、einops 是检测训练链路的标准件。
pip install seaborn thop timm einops -
4编译 selective_scan
Mamba 的核心算子要单独编,这一步最容易卡在 CUDA 版本不匹配。
cd selective_scan && pip install . && cd .. -
5装本项目
再回根目录做可编辑安装,之后才能用 mbyolo_train.py。
pip install -v -e . -
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···
MonkeyOCRv2
开源
专为文档打造的视觉骨干,让 OCR 与版面理解更准
MonkeyOCRv2 Vision Encoder — A Document-Native Visual Backbone
rabbit-ear
开源
用代码设计折纸,自动计算折叠过程,输出矢量图。
computational origami library
surya
开源
多语言文档一键 OCR,版面表格阅读顺序全搞定
OCR, layout analysis, reading order, table recognition in 90+ languages
Wis3D
开源
浏览器里直接看3D点云和相机位姿,免装软件
A web-based 3D visualization tool for 3D computer vision.
RT-DETR
开源
无 NMS 端到端检测,精度速度双超 YOLO
[CVPR 2024] Official RT-DETR (RTDETR paddle pytorch), Real-Time DEtection TRansforme···
production-ocr-course
开源
用 Rust+K8s 把 OCR 从 Demo 做成能扛并发的生产服务
Build, deploy, and scale a production-grade OCR pipeline using Rust, vLLM, Redis, KE···
ultralytics-YOLO-DeepSort-ByteTr···
开源
点点鼠标,就能用YOLO加跟踪算法跑视频和摄像头
a GUI application, which uses YOLOs (YOLOv8, YOLO11, YOLOv13) for Object Detection/T···
stitching
开源
多张照片一键拼成全景图,快且稳
A Python package for fast and robust Image Stitching