算能盒子——AI_report适配文档
算能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