FunASR 安装：新手 3 步装好并验证环境
【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR
FunASR 安装并不复杂。这是一个开源语音识别项目——把会议录音变成带说话人标签的文字、把外语讲座转成字幕、把实时音频流滚出识别结果，都是它的日常。下面带你从零把环境跑通。
🎯 它能帮你做什么
想象这三个场景：
- 开会：一整段会议录音丢进去，出来的不是"一坨文字"，而是"谁在哪个时间点说了什么"，直接当纪要底稿。
- 听外语：多语言音频（中、英、日、韩、粤等）能直接转成文字，不用先判断"这是哪种语言"。
- 做字幕、实时应用：边播边识别，延迟低，适合直播字幕、语音输入这类要"跟着说"的场景。
不用记任何模型名。装好后按场景挑参数就行，本文不展开。
✅ 装前自查
先花 30 秒对一遍，比装完再排错省时间：
| 项目 | 要求 | 不满足会怎样 |
|---|---|---|
| 操作系统 | Linux / macOS / Windows | 装不上或功能跑不全 |
| Python | 3.8 ~ 3.13 | 依赖装失败或 import 报错 |
| pip | 已可用 | 一切安装无从谈起 |
| GPU（NVIDIA） | 可选 | 没有就全程 CPU，慢但能跑 |
确认python --version落在区间内，再往下走。
🚀 三步装完
第一步：取代码
把仓库拉下来，进入目录：
git clone https://gitcode.com/GitHub_Trending/fun/FunASR.git cd FunASR做对了的样子：目录里能看到funasr/包、setup.py和docs/。
第二步：装依赖
先装 PyTorch，再装项目本体（源码方式）：
pip install torch torchaudio pip install -e ./有 NVIDIA 卡的话，先按你的驱动版本选对应的 CUDA 版 PyTorch wheel，再执行第一条。做对了的样子：第二条命令末尾输出Successfully installed funasr-...。
第三步：下载模型并验证
先确认 GPU 是否可见：
python -c "import torch; print(torch.cuda.is_available())"输出True就用device="cuda"，否则用device="cpu"。然后跑一段最小验证，首次运行会自动把模型下载到本地：
from funasr import AutoModel model = AutoModel(model="paraformer-zh", device="cpu") result = model.generate(input="runtime/funasr_api/asr_example.wav") print(result)看到一段与示例音频对得上的中文文本，就说明 FunASR 环境配置完成了。
🛠 这些报错你大概率会遇到
现象 1：M1/M2 Mac 报incompatible architecture (have (x86_64), need (arm64e))
原因：环境里混进了 x86 架构编译的 cffi。解决：
pip uninstall cffi pycparser ARCHFLAGS="-arch arm64" pip install cffi pycparser --compile --no-cache-dir现象 2：torch.cuda.is_available()打印False
原因：装的 PyTorch wheel 与显卡驱动不匹配，或装的是纯 CPU 版。解决：对照你的驱动版本重装匹配的 CUDA wheel，再打印一次，变成True才算数。
现象 3：ModuleNotFoundError: No module named 'torch'
原因：命令跑在了没装依赖的解释器里，常见于机器上有好几套 Python、虚拟环境没激活。解决：用which python确认当前解释器，它就是刚才执行pip install -e ./的那一个。
📍 接下来去哪儿
- 多平台安装细节：docs/installation/installation_zh.md
- 不写代码、命令行直接转写文件：docs/cli.md
- 更多排障问答：docs/troubleshooting_zh.md
- 暂时不想配本地环境？examples/colab/ 里有浏览器里就能跑的 notebook
把这篇当作你的 FunASR 教程第一课——拿一段会议录音丢进去，试试你的环境吧。
【免费下载链接】FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.项目地址: https://gitcode.com/GitHub_Trending/fun/FunASR
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
