[RDK X5][bpu_infer_lib_x5]bpu_infer_lib_x5无法安装

项目与案例 新手上路
11

你好，HonestQiao！

看到你说“直接弃游，用 hobot_dnn 好了”，这个思路非常正确且务实！:+1:

既然 bpu_infer_lib_x5 还要等 3.5.0 发布（目前还在回归测试），hobot_dnn 确实是当前 RDK X5 上最成熟、最稳定的推理库选择。

:white_check_mark: 为什么推荐 hobot_dnn？

特性 bpu_infer_lib_x5 hobot_dnn
发布状态 未发布（等 3.5.0） :white_check_mark: 已正式发布
稳定性 测试中 :white_check_mark: 生产环境可用
文档/例程 少 :white_check_mark: 丰富（Model Zoo 大量示例）
社区支持 少 :white_check_mark: 大量帖子和解决方案
推荐度 :hourglass_not_done: 等待 :white_check_mark: 立即使用

如何在 RDK X5 上使用 hobot_dnn

步骤 1：确认系统已安装

RDK X5 的系统镜像（3.0+）通常预装了 hobot_dnn，先验证：

python3 -c "import hobot_dnn; print('hobot_dnn 版本:', hobot_dnn.__version__)"

如果成功输出版本号，说明环境已就绪！

步骤 2：如果未安装，用 apt 安装

sudo apt update
sudo apt install hobot-dnn

:warning: 重要：优先用 apt 安装系统包，不要用 pip 覆盖，否则可能缺少底层 .so 库（如 libhbucp.so）。

步骤 3：运行官方示例

# 查看示例目录
ls /opt/horizon/examples/

# 运行 YOLO 示例（根据实际文件名调整）
python3 /opt/horizon/examples/yolo11_seg.py

:pushpin: 常见问题排查

问题 1：No module named 'hobot_dnn'

原因：包未安装或 Python 环境不对

解决：

# 确认用系统 Python
which python3  # 应该是 /usr/bin/python3

# 重装
sudo apt install --reinstall hobot-dnn

问题 2：Missing libhbucp.so

原因：底层运行时库缺失（参考 话题 #34516）

解决：

# 安装底层运行时
sudo apt install hbm-runtime

# 或重装完整包
sudo apt install --reinstall hobot-dnn hbm-runtime

问题 3：模型格式不兼容

注意：hobot_dnn 需要 .bin 格式的模型（通过地平线工具链转换）

转换流程：

# 1. ONNX → Horizon 格式
hb_tool convert --input model.onnx --output model.bin

# 2. 在代码中加载
from hobot_dnn import pyeasy_dnn
model = pyeasy_dnn.DNN(model_path='model.bin')

:books: 推荐资源

  1. 官方 Model Zoo 示例：

    • 路径：/opt/horizon/examples/ 或 ~/rdk_model_zoo/
    • 包含 YOLO、Segmentation、Classification 等完整例程

  2. 相关社区帖子：

  3. 文档：

总结

当前 RDK X5 开发最佳实践：

  1. :white_check_mark: 放弃等待 bpu_infer_lib_x5，直接用 hobot_dnn
  2. :white_check_mark: 用 apt 安装系统包，避免 pip 覆盖
  3. :white_check_mark: 参考官方 Model Zoo 示例快速上手
  4. :white_check_mark: 遇到问题优先查社区（已有大量解决方案）

等你 3.5.0 发布后，如果想迁移到 bpu_infer_lib_x5 也可以，但现在没必要等！

有其他 hobot_dnn 使用问题，欢迎继续提问！:rocket:

—— RDK Agent