| 依赖项 | 版本要求 | 说明 |
|---|---|---|
| Python | >= 3.10 | 推荐 3.11 |
| paddlepaddle | >= 3.0 | 推理引擎(3.2.2 实测可用),NPU 场景需配套 paddle-custom-npu |
| numpy / Pillow | 最新版 | 图像预处理与数组处理 |
| pyyaml / protobuf | 最新版 | 配置解析 |
| matplotlib | 最新版 | 结果可视化 |
| 昇腾驱动 | CANN 8.0.RC2+ | 推荐最新版 |
安装命令:
pip install --target /mnt/workspace/en_PP-OCRv5_mobile_rec/libs -i https://pypi.tuna.tsinghua.edu.cn/simple "paddlepaddle>=3.0" numpy pillow pyyaml matplotlib# 检查 NPU 设备
npu-smi info
# 权重已就位(Paddle Inference 格式)
ls /home/developer/models/en_PP-OCRv5_mobile_rec/ # inference.json inference.pdiparams config.json inference.yml ...PYTHONPATH=/mnt/workspace/en_PP-OCRv5_mobile_rec/libs python3 inference.py --model_path /home/developer/models/en_PP-OCRv5_mobile_rec脚本内置程序化绘制的英文文本行示例图,只传 --model_path 即可跑通;识别结果可视化自动保存到 assets/model_result.png。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| --model_path | str | /home/developer/models/en_PP-OCRv5_mobile_rec | 本地权重目录(离线加载) |
| --device | str | 自动(npu > cuda > cpu) | 推理设备 |
| --output | str | assets/model_result.png | 结果可视化保存路径 |
输入:
python3 inference.py --model_path /home/developer/models/en_PP-OCRv5_mobile_rec输出:
[INFO] device = npu
[INFO] 模型加载完成 load_time=x.xxs (en_PP-OCRv5_mobile_rec, inputs=['x'], outputs=['softmax_0.tmp_0'])
[RESULT] 输入张量 shape=(1, 3, 48, 320) dtype=float32
[RESULT] 输出张量 shape=(1, T, C)
[RESULT] 识别文本: '...' (score=0.xxxx)
[INFO] 推理完成 耗时/elapsed=x.xx s (input=(640, 64), device=npu)
[RESULT] status=ok device=npu 耗时/elapsed=x.xx输入:
python3 inference.py --model_path /home/developer/models/en_PP-OCRv5_mobile_rec --device cpu输出:
每行输出 [RESULT] 张量/识别文本统计,末行含 耗时/elapsed 字段,status=ok


--model_path 加载,推理全程离线,不联网下载任何文件;