算能bm_model模型链接:https://github.com/hsyysy/FunASR-bmodel/blob/bmodel/bmodel/README.md
一、环境配置
1.安装torch,torchaudio:
pip3 install torch torchaudio2.安装funasr:
git clone https://github.com/hsyysy/FunASR-bmodel.gitcd FunASR-bmodel && pip3 install -e ./cd FunASR-bmodel/bmodel/pip install -r requirements.txt需要注意,这里固定版本为 pip3 install umap-learn==0.5.3
3.根据系统架构选择性地安装tpu_perf:
查看系统架构:
uname -a安装 x86架构:
pip3 install tpu_perf-1.2.35-py3-none-manylinux2014_x86_64.whl
或者arm架构:
pip3 install tpu_perf-1.2.35-py3-none-manylinux2014_aarch64.whl二、离线语音识别demo
本例程在各个模型的目录内scripts目录下提供了下载脚本download.sh
3.运行脚本:
python3 offline.py4. AI报告安装依赖和字体
安装python-docx报错非常典型,而且在 BM1684 / ARM / Ubuntu 上几乎必遇到。
我们直接把根因、为什么你装了还是不行、以及 3 种可落地解决方案一次性说清楚。
一、现在的问题已经变了(不是 docx 了)
你现在的错误不再是:
❌
No module named 'docx'
而是python-docx 的依赖lxml编译失败:
Error: Please make sure the libxml2 and libxslt development packages are installed.
👉结论一句话:
在 ARM(BM1684)环境下,
python-docx依赖的lxml没有可用的预编译 wheel,pip 只能源码编译,但你的系统缺少底层 C 库开发头文件。
二、为什么在你这台机器上一定会这样?
1️⃣ python-docx → 依赖链
python-docx └── lxml ❌(需要本地编译) ├── libxml2-dev ❌ 缺失 └── libxslt-dev ❌ 缺失
2️⃣ 为什么 x86 机器没事,你这台有事?
| 平台 | lxml 安装方式 |
|---|---|
| x86_64 | 直接下载 wheel(不用编译) |
| ARM / BM1684 | ❌ 没有 wheel → 必须源码编译 |
三、✅ 正确、最稳的解决方案(强烈推荐)
🔧 方案 (最标准):安装系统依赖后再 pip 装
这是官方推荐、成功率 100%的方式。
① 安装系统依赖(只需一次)
sudo apt-get update sudo apt-get install -y libxml2-dev libxslt-dev python3-dev build-essentialsudo apt-get update sudo apt-get install -y \ libxml2-dev \ libxslt-dev \ python3-dev \ build-essential说明一下这些包是干嘛的:
| 包名 | 作用 |
|---|---|
| libxml2-dev | lxml 核心依赖 |
| libxslt-dev | XML / XSLT 支持 |
| python3-dev | Python C 扩展头文件 |
| build-essential | gcc / make |
② 再装 python-docx
pip3 install python-docx -i https://pypi.tuna.tsinghua.edu.cn/simple③ 验证(一定要做)
python3 - << 'EOF' from docx import Document print("python-docx OK") EOF
看到输出就说明彻底解决。
5. 字体根据具体路径安装
6. 运行AI_resport
把模型迁移到项目目录下:SourceHanSansSC 除外(思源黑体)
修改模型加载方式:
运行:
python3 asr_flask.py