# Gradio-YOLOv5-Det-Blocks

**Repository Path**: loukw/gradio_yolov5_det_blocks

## Basic Information

- **Project Name**: Gradio-YOLOv5-Det-Blocks
- **Description**: 🚀 基于Gradio Blocks的YOLOv5通用目标检测演示系统 Gradio YOLOv5 Det项目的扩展版
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/PyCVer
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2022-06-29
- **Last Updated**: 2022-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
<a href="https://gitee.com/CV_Lab/gradio_yolov5_det_blocks">
<img src="https://pycver.gitee.io/ows-pics/imgs/gradio_yolov5_det_blocks_logo.png" alt="Simple Icons" >
</a>
<p align="center">
    基于Gradio Blocks的YOLOv5通用目标检测演示系统
</p>
<p align="center">
    <a href="https://gitee.com/CV_Lab/gradio_yolov5_det">Gradio YOLOv5 Det</a>的扩展项目
</p>
</p>
<p align="center">
<a href="#"><img src="https://img.shields.io/badge/CodeCheck-passing-success" alt="code check" /></a>
<a href="https://gitee.com/CV_Lab/gradio_yolov5_det_blocks/releases/v0.2"><img src="https://img.shields.io/badge/Releases-v0.2-green" alt="Releases Version" /></a>
<a href="https://gitee.com/CV_Lab/gradio_yolov5_det"><img src="https://img.shields.io/badge/Gradio--YOLOv5--Det-v0.4-brightgreen" alt="gradio awesome demos" /></a>
<a href="https://huggingface.co/"><img src="https://img.shields.io/badge/%F0%9F%A4%97-Hugging%20Face-blue" alt="Hugging Face Spaces" /></a>
<a href="https://huggingface.co/spaces"><img src="https://img.shields.io/badge/🤗%20Hugging%20Face-Spaces-blue" alt="Hugging Face Spaces" /></a>
<a href="https://gitee.com/CV_Lab/gradio_yolov5_det_blocks/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0-blue" alt="License" /></a>
</p>
<p align="center">
<a href="https://github.com/ultralytics/yolov5"><img src="https://img.shields.io/badge/YOLOv5-v6.1-blue" alt="YOLOv5 Version" /></a>
<a href="https://github.com/gradio-app/gradio"><img src="https://img.shields.io/badge/Gradio-3.0.20+-orange" alt="Gradio Version" /></a>
<a href="#"><img src="https://img.shields.io/badge/Python-3.8%2B-blue?logo=python" alt="Python Version" /></a>
<a href="https://pypi.org/project/torch/"><img src="https://img.shields.io/badge/torch-1.11.0%2B-important?logo=pytorch" alt="Torch Version" /></a>
<a href="https://pypi.org/project/torchvision/"><img src="https://img.shields.io/badge/torchvision-0.12.0%2B-green?logo=pytorch" alt="TorchVision Version" /></a>
<a href="https://github.com/pre-commit/pre-commit"><img src="https://img.shields.io/badge/checks-pre--commit-brightgreen" alt="pre-commit"></a>
</p>

## 🚀 作者简介

曾逸夫，从事人工智能研究与开发；主研领域：计算机视觉；[YOLOv5官方开源项目代码贡献人](https://github.com/ultralytics/yolov5/graphs/contributors)；[YOLOv5 v6.1代码贡献人](https://github.com/ultralytics/yolov5/releases/tag/v6.1)

❤️  Github：https://github.com/Zengyf-CVer

🔥 YOLOv5 官方开源项目PR ID：

- Save \*.npy features on detect.py `--visualize`：https://github.com/ultralytics/yolov5/pull/5701
- Fix `detect.py --view-img` for non-ASCII paths：https://github.com/ultralytics/yolov5/pull/7093
- Fix Flask REST API：https://github.com/ultralytics/yolov5/pull/7210
- Add yesqa to precommit checks：https://github.com/ultralytics/yolov5/pull/7511
- Add mdformat to precommit checks and update other version：https://github.com/ultralytics/yolov5/pull/7529

💡 YOLOv5 v6.1代码贡献链接：

- https://github.com/ultralytics/yolov5/releases/tag/v6.1

<h2 align="center">🚀更新走势</h2>

- `2022-06-24` **⚡ [Gradio YOLOv5 Det Blocks v0.2](https://gitee.com/CV_Lab/gradio_yolov5_det_blocks/releases/v0.2)正式上线**
- `2022-06-09` **⚡ [Gradio YOLOv5 Det Blocks v0.1](https://gitee.com/CV_Lab/gradio_yolov5_det_blocks/releases/v0.1)正式上线**

<h2 align="center">💎项目流程与用途</h2>

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gradio_yolov5_det_blocks_workflow.png">
</div>

### 📌 项目示例

#### ❤️ 对比检测系列：blocks_01 对比检测，不同图片 不同模型 不同配置

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_01.png">
</div>

#### ❤️ 对比检测系列：blocks_01_02 对比检测，同一图片 不同模型 不同配置

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_01_02.png">
</div>

#### ❤️ 对比检测系列：blocks_01_03 对比检测，同一图片 相同模型 不同配置

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_01_03.png">
</div>

#### ❤️ 双端操作系列：blocks_02 单图片，双端操作

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_02.png">
</div>

#### ❤️ 双端操作系列：blocks_02_02 图片/webcam双模式，双端操作

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_02_02.png">
</div>

#### ❤️ 双端操作系列：blocks_02_03 单图片，双端操作，强制加载YOLOv5

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_02_03.png">
</div>

#### ❤️ 示例系列：blocks_03 单图片，示例

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_03.png">
</div>

#### ❤️ 示例系列：blocks_03_02 单图片，示例下载

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_03_02.png">
</div>

#### ❤️ 清除与重置系列：blocks_04 & blocks_04_02 单图片，清除/双端清除

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_04.png">
</div>

#### ❤️ 清除与重置系列：blocks_04_03 单图片，重置

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_04_03.png">
</div>

#### ❤️ 图片路径系列：blocks_05 单图片路径，文本输入（在线）

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_05.png">
</div>

#### ❤️ 图片路径系列：blocks_05_02 多图片路径，文件上传（在线）

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_05_02.png">
</div>

#### ❤️ 绘制检测系列：blocks_06 绘制检测（opencv, pillow, matplotlib）

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_06.png">
</div>

#### ❤️ 绘制检测系列：blocks_06_02 绘制检测（opencv, pillow, matplotlib），画廊（多选模式）

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/gyd_blocks_06_02.png">
</div>

<h2 align="center">💡项目结构</h2>

```
.
├── gradio_yolov5_det_blocks				# 项目名称
│   ├── model_download						# 模型下载
│   │   ├── yolov5_model_p5_p6_all.sh		# YOLOv5 P5模型
│   │   ├── yolov5_model_p5_all.sh			# YOLOv5 P5模型
│   │   ├── yolov5_model_p6_all.sh			# YOLOv5 P6模型
│   │   └── yolov5_model_p5_n.sh			# yolov5n模型
│   ├── model_config						# 模型配置
│   │   ├── model_name_p5_all.yaml			# YOLOv5 P5 模型名称（yaml版）
│   │   ├── model_name_p6_all.yaml			# YOLOv5 P6 模型名称（yaml版）
│   │   ├── model_name_p5_p6_all.yaml		# YOLOv5 P5 & P6 模型名称（yaml版）
│   │   ├── model_name_p5_n.yaml			# yolov5n 模型名称（yaml版）
│   │   ├── model_name_p5_all.csv			# YOLOv5 P5 模型名称（csv版）
│   │   ├── model_name_p6_all.csv			# YOLOv5 P6 模型名称（csv版）
│   │   └── model_name_p5_n.csv				# yolov5n 模型名称（csv版）
│   ├── cls_name							# 类别名称
│   │   ├── cls_name_zh.yaml				# 类别名称文件（yaml版-中文）
│   │   ├── cls_name_en.yaml				# 类别名称文件（yaml版-英文）
│   │   ├── cls_name_ru.yaml				# 类别名称文件（yaml版-俄语）
│   │   ├── cls_name_es.yaml				# 类别名称文件（yaml版-西班牙语）
│   │   ├── cls_name_ar.yaml				# 类别名称文件（yaml版-阿拉伯语）
│   │   ├── cls_name_ko.yaml				# 类别名称文件（yaml版-韩语）
│   │   ├── cls_name.yaml					# 类别名称文件（yaml版-中文）
│   │   └── cls_name.csv					# 类别名称文件（csv版-中文）
│   ├── models								# 模型Hub
│   │   ├── readme.md						# 模型Hub README
│   │   ├── *.pt							# PyTorch模型
│   │   └── *.onnx							# ONNX模型
│   ├── util								# 工具包
│   │   ├── gradio_version_opt.py			# gradio版本管理
│   │   ├── fonts_opt.py					# 字体管理
│   │   ├── pdf_opt.py						# PDF管理
│   │   └── download_unzip.py				# 下载与解压管理
│   ├── img_examples						# 示例图片
│   ├── __init__.py							# 初始化文件
│   ├── blocks_01_x.py						# 对比检测系列
│   ├── blocks_02_x.py						# 双端操作系列
│   ├── blocks_03_x.py						# 示例系列
│   ├── blocks_04_x.py						# 清除与重置系列
│   ├── blocks_05_x.py						# 图片路径系列
│   ├── blocks_06_x.py						# 绘制检测系列
│   ├── LICENSE								# 项目许可
│   ├── CodeCheck.md						# 代码检查
│   ├── .gitignore							# git忽略文件
│   ├── yolov5_pytorch_gpu.md				# YOLOv5 PyTorch GPU安装教程
│   ├── README.md							# 项目说明
│   └── requirements.txt					# 脚本依赖包
```

<h2 align="center">🔥安装教程</h2>

### ✅ 第一步：创建conda环境

```shell
conda create -n yolo python==3.8
conda activate yolo # 进入环境
```

### ✅ 第二步：克隆

```shell
git clone https://gitee.com/CV_Lab/gradio_yolov5_det_blocks.git
```

### ✅ 第三步：安装Gradio YOLOv5 Det Blocks依赖

```shell
cd gradio_yolov5_det_blocks
pip install -r ./requirements.txt -U
```

❗ 注意：yolov5默认采用pip安装PyTorch GPU版，如果采用官网安装**PyTorch GPU**版，参见[YOLOv5 PyTorch GPU安装教程](./yolov5_pytorch_gpu.md)

<h2 align="center">⚡使用教程</h2>

```shell
# 对比检测系列
python blocks_01_x.py

# 双端操作系列
python blocks_02_x.py

# 示例系列
python blocks_03_x.py

# 清除与重置系列
python blocks_04_x.py

# 图片路径系列
python blocks_05_x.py

# 绘制检测系列
python blocks_06_x.py
```

❤️ 具体文件信息与功能描述，参见下表：

| 系列编号 |               文件名称                |                   功能描述                    |
| :--: | :-------------------------------: | :---------------------------------------: |
|  01  |    [blocks_01](./blocks_01.py)    |            对比检测，不同图片 不同模型 不同配置            |
|  01  | [blocks_01_02](./blocks_01_02.py) |            对比检测，同一图片 不同模型 不同配置            |
|  01  | [blocks_01_03](./blocks_01_03.py) |            对比检测，同一图片 相同模型 不同配置            |
|  02  |    [blocks_02](./blocks_02.py)    |                 单图片，双端操作                  |
|  02  | [blocks_02_02](./blocks_02_02.py) |             图片/webcam双模式，双端操作             |
|  02  | [blocks_02_03](./blocks_02_03.py) |            单图片，双端操作，强制加载YOLOv5            |
|  03  |    [blocks_03](./blocks_03.py)    |                  单图片，示例                   |
|  03  | [blocks_03_02](./blocks_03_02.py) |                 单图片，示例下载                  |
|  04  |    [blocks_04](./blocks_04.py)    |                  单图片，清除                   |
|  04  | [blocks_04_02](./blocks_04_02.py) |                 单图片，双端清除                  |
|  04  | [blocks_04_03](./blocks_04_03.py) |                  单图片，重置                   |
|  05  |    [blocks_05](./blocks_05.py)    |              单图片路径，文本输入（在线）               |
|  05  | [blocks_05_02](./blocks_05_02.py) |              多图片路径，文件上传（在线）               |
|  06  |    [blocks_06](./blocks_06.py)    |     绘制检测（opencv, pillow, matplotlib）      |
|  06  | [blocks_06_02](./blocks_06_02.py) | 绘制检测（opencv, pillow, matplotlib），画廊（多选模式） |

### 💬 技术交流

- 如果你发现任何Gradio YOLOv5 Det Blocks存在的问题或者是建议, 欢迎通过[Gitee Issues](https://gitee.com/CV_Lab/gradio_yolov5_det_blocks/issues)给我提issues。
- 欢迎加入CV Lab技术交流群

<div align="center" >
<img src="https://pycver.gitee.io/ows-pics/imgs/qq_group.jpg" width="20%">
</div>