项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 58255
使用教程
环境要求
- 已安装 Python 并配置好 pip,可执行 python / pip 命令
- 网络可访问 GitHub 与 PyPI,以便克隆仓库、下载依赖和模型权重
- 进行训练时建议使用 NVIDIA 显卡,README 以单卡 V100 作为训练参考
安装与启动步骤
-
1克隆项目仓库
把 YOLOv5 源码下载到本地,后续命令都在仓库根目录下执行。
git clone https://github.com/ultralytics/yolov5 cd yolov5 -
2安装项目依赖
在仓库根目录安装 requirements.txt 中列出的依赖(含 PyTorch),建议先建虚拟环境。
pip install -r requirements.txt -
3单张图片推理
用默认的 yolov5s.pt 权重做检测,模型会自动从最新 release 下载,可先换成自己的图片路径。
python detect.py --weights yolov5s.pt --source data/images/bus.jpg -
4摄像头与视频推理
--source 传 0 表示调用本机摄像头,也可直接传本地视频文件名。
python detect.py --weights yolov5s.pt --source 0 python detect.py --weights yolov5s.pt --source vid.mp4 -
5批量与网络流推理
--source 支持目录、glob、txt 列表、YouTube 链接以及 RTSP/RTMP/HTTP 流地址。
python detect.py --weights yolov5s.pt --source path/to/images/ python detect.py --weights yolov5s.pt --source 'path/to/*.jpg' python detect.py --weights yolov5s.pt --source 'rtsp://example.com/media.mp4' -
6分割与分类推理
仓库同时提供实例分割与图像分类脚本,需使用对应的 -seg / -cls 权重。
python segment/predict.py --weights yolov5m-seg.pt --source data/images/bus.jpg python classify/predict.py --weights yolov5s-cls.pt --source data/images/bus.jpg -
7安装ultralytics包
README 也提供新版 Ultralytics YOLO 包,如只想调用接口可单独安装,二选一即可。
pip install ultralytics
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--weights | 是 | 指定模型权重文件,不存在时自动下载 | yolov5s.pt |
--source | 是 | 输入来源:图片、视频、目录、URL 或摄像头编号 | data/images/bus.jpg |
--batch-size | 否 | 训练批大小,填 -1 启用自动批处理 | -1 |
如何确认成功
执行 detect.py 后终端不再报错并输出检测结果,说明依赖安装成功、模型可正常推理。
常见问题
Q:模型权重和数据集要手动下载吗?
A:不需要。README 说明模型和数据集会自动从最新的 YOLOv5 release 下载,首次运行联网即可。
Q:训练一次大概需要多久?
A:README 给出的参考是单张 NVIDIA V100 上,YOLOv5n/s/m/l/x 分别约需 1/2/4/6/8 天,多卡训练可明显缩短。
Q:显存不够怎么办?
A:README 建议使用硬件允许的最大 --batch-size,也可以使用 --batch-size -1 启用 AutoBatch 自动调整。
Q:detect.py 的 --source 能传什么?
A:图片、视频、图片目录、glob 通配符、路径列表 txt、YouTube 链接,以及 RTSP/RTMP/HTTP 流均可。
Q:pip install ultralytics 和本仓库什么关系?
A:README 中该命令用于安装最新版 Ultralytics YOLO 包;使用本仓库的 detect.py 等脚本时只需安装 requirements.txt。
注意事项
- 所有推理/训练命令都必须在克隆下来的 yolov5 仓库根目录执行。
- 首次运行会自动下载权重,请保持网络畅通并预留磁盘空间。
- README 也介绍了通过 PyTorch Hub 调用模型的方式,可参考官方文档链接。
核心亮点
- 推理速度快,支持从 nano 到 x 多种模型尺寸,灵活适配不同硬件
- 训练流程极简,一行命令即可启动训练,内置数据增强和超参数调优
- 导出格式丰富(ONNX/TensorRT/CoreML),方便部署到移动端和边缘设备
不足之处
- 官方维护重心已转向 YOLOv8,YOLOv5 更新频率降低
- 部分高级功能依赖 Ultralytics HUB 或企业版,社区版功能受限
适用场景
- 工业质检中实时检测产品缺陷
- 安防监控中行人或车辆检测
- 自动驾驶场景下的道路目标识别
替代项目
YOLOv8、YOLOX、MMDetection
同类项目推荐
Construction-Hazard-Detection
开源
YOLO+聚类自动圈出工地危险区,实时告警
Enhances construction site safety using YOLO for object detection, identifying hazar···
Biodiversity
开源
把红外相机和录音自动变成物种数据,省去人工翻图
Microsoft AI for Good Lab — Biodiversity research hub. Open-source AI models, edge ···
GestureGAN
开源
上传一张手势图,一键生成指定新手势,背景身份不变
[ACM MM 2018 Oral] GestureGAN for Hand Gesture-to-Gesture Translation in the Wild
上传视频或接摄像头,网页里实时看目标检测与跟踪效果
YOLO Vision Studio: a free, open-source Streamlit app for detection, segmentation, p···
FILTER.js
开源
纯 JS 实现 OpenCV 级图像视频处理,浏览器 Node 都能跑
Video and Image Processing and Computer Vision Library similar to OpenCV in pure Jav···
LabelAny3D
开源
一张普通照片,自动标出任意物体的3D框
[NeurIPS 2025] LabelAny3D: Label Any Object 3D in the Wild
VideoLucy
开源
让AI看懂长视频,靠“记忆回溯”抓住关键线索
[NeurIPS 2025] Deep Memory Backtracking for Long Video Understanding
BlackVIP
开源
黑盒模型也能迁移学习,用视觉提示搞定下游任务
Official implementation for CVPR'23 paper "BlackVIP: Black-Box Visual Prompting for ···
PolarFormer
开源
用极坐标 Transformer 做多相机 3D 检测
[AAAI 2023] PolarFormer: Multi-camera 3D Object Detection with Polar Transformers
