# rknn-yolo

**Repository Path**: agricultureiot/rknn-yolo

## Basic Information

- **Project Name**: rknn-yolo
- **Description**: yolov8 yolov11 yolo 移植到国产 瑞芯微 npu rknn 3568 3588 项目，可以进行AI目标检测，分割等，教科书般的代码案例
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: pro
- **Homepage**: http://rknn.net:1234
- **GVP Project**: No

## Statistics

- **Stars**: 232
- **Forks**: 1
- **Created**: 2024-11-14
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: cv

**Tags**: None

## README

 :cn: 为国产AI芯片做贡献，降低国产NPU适配难度，让更多开发者使用国产品AI芯片
# 说明
-  :rotating_light: 开源项目仅仅用于理解思路，逻辑，理念，入门启蒙，并非最佳性能(但是经过极致优化性能已经超越c++)
-  :rocket: 极简依赖，极简且优雅代码，一键运行，初学者专用，不依赖pytorch，安装包减少3GB
-  :umbrella: 全网唯一不会报错的开源代码，直接少踩半年坑，不用熬夜和焦虑

# 环境
- `python 3.12.x`
- `rk3568/rk3588/rk3588s`
- `rknn-toolkit 2.3.2`
- `yolov11n.rknn(yolov11n.pt -> yolov11n.onnx)`兼容yolov8
- `ubuntu 20.04、ubuntu 22.04、Debian 11`

# 性能
- 150FPS(1280x720)
- 支持H264/H265
- 看pro分支即可，纯小白看其他分支入门


# 开始


```bash
# 防止小白报错不知道原因，必须全程root账号
sudo su

# 防止小白不会安装git
apt update
apt install git
git clone https://gitee.com/agricultureiot/rknn-yolo.git

# 防止小白报错不知道原因，必须给足授予权限
chmod -R 777 rknn-yolo/
```

# 安装python

```bash
# 防止小白不会安装python3.12，或者python不是3.12版本，老版本不用卸载
mkdir -p ~/miniconda3
wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py312_25.7.0-2-Linux-aarch64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh
source ~/miniconda3/bin/activate
conda init --all
python --version
```

# 安装项目

```bash
# 本项目只能在3588开发板中运行，无法在pc和服务器上运行
cd rknn-yolo

# 替换 rknn npu api 运行时驱动，防止不是2.3.2版本，仅需执行一次即可
cp -f lib/librknnrt.so /usr/lib

apt update
# ffmpeg无需安装: 项目ffmpeg/目录自带rkmpp硬编版(含全部依赖库, 仅支持RK3588+Ubuntu22.04, 详见docs/ffmpeg_rkmpp_build.md)
apt install gcc

# 安装项目依赖
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

```

# 安装流媒体服务
```bash
# 192.168.5.31 改为 本机的对外IP：不是127.0.0.1和localhost，局域网ip或公网ip
# 访问地址：IP:8080
# 在线观看视频：http://IP:8080/players/whep.html?schema=http
docker run -itd  --restart=always  --network host   \
--env CANDIDATE=192.168.5.31 \
-v /root/rknn-yolo/etc:/root/config  \
registry.cn-hangzhou.aliyuncs.com/ossrs/srs:6 ./objs/srs -c /root/config/srs.conf
```


# 多核心NPU同时推理视频

```
# 需要真实摄像头和流媒体服务,填写rtsp/rtmp地址
python src/video_track_multi_core.py
```



# 备注
- 性能够用，暂时不需要 RGA 参与
- 仅做demo启发功能，不做工程相关功能
- 加微信群【免费无条件领取3588npu车牌识别代码】：875079028