
Windows 快速上手 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如果你手头有一堆会议录音要转成带标点的文字又想在 Windows 笔记本上几分钟内跑起来那么 FunASR 社区软件包的一键安装路线就是为你准备的装好依赖、启动服务、对着麦克风说句话三步就能看到转写结果。这篇按「先自检、再实战、后调优」的顺序带你跑通不绕弯子。一句话定位先判断值不值得装FunASR 社区软件包 一条「语音端点检测 → 语音识别 → 标点恢复」链路打包成的可部署服务VAD 指自动切出「人在说话」的片段省去手动截取。你可以用它来做四件事把长录音批量转成文字、对着麦克风实时听写、给转写文本自动补标点、给专有名词加权纠错。拿不准要不要装对照三条快速决策适合需要在 Windows 本机离线转写录音不想把音频传到第三方网站适合想先验证转写效果再决定要不要接到自己的应用里不适合要上百路并发跑生产流量——那属于 C 服务端SDK_tutorial_zh.md的地盘本机体验用不上一句话总结先按 Python 路线装一遍10 分钟内能验证值不值得往下投入。装之前先确认这 4 件事装之前先确认比装完再排障省事得多。四条全部满足安装过程基本不会卡系统为 64 位 Windows 10 / 11开始菜单 → 设置 → 系统 → 关于里可看已安装 Python 3.8–3.12推荐 3.10。检查python -V没装可以用winget install Python.Python.3.10端口 10095 空闲netstat -ano | findstr 10095无输出说明可用被占了就换个端口启动磁盘剩余 3GB 以上首次启动会自动下载 VAD、ASR、标点三类模型并缓存在本机上手实战跟着做这条主路径仓库里有两条部署路线Python 轻量版pip install即可Windows 直接可用和 C 高性能版面向高并发官方一键脚本偏向 Linux / Docker 环境。在 Windows 桌面上推荐只走 Python 路线C 路线留到上生产时再说。第 1 步装依赖并拿到代码pip install -U modelscope funasrgit clone https://gitcode.com/GitHub_Trending/fun/FunASR.git cd FunASR国内网络如果慢可加参数-i https://mirror.sjtu.edu.cn/pypi/web/simple检查点新终端里执行python -c import funasr不报错依赖就位。第 2 步启动服务端cd runtime/python/websocket python funasr_wss_server.py --port 10095检查点控制台先刷一段模型下载进度随后出现「Listening on port: 10095」类字样。首次启动慢属正常模型会缓存到本机第二次启动秒级就绪。第 3 步启动客户端试说一句话另开一个终端cd runtime/python/websocket python funasr_wss_client.py --host 0.0.0.0 --port 10095 --mode offline检查点对着麦克风说一句「FunASR 转写测试」屏幕上实时出现文字、句尾自动带上标点——到这里整条链路就跑通了。3 分钟跑通第一个结果最小可运行示例就是上面第 3 步的麦克风版想直接转文件加一个--audio_in参数python funasr_wss_client.py --host 0.0.0.0 --port 10095 --mode offline --audio_in D:\meeting.wav一次转一批把文件路径换成 Kaldi 风格的列表文件每行一条记录仓库自带样例可以参考 data/list/train_wav.scppython funasr_wss_client.py --host 0.0.0.0 --port 10095 --mode offline --audio_in D:\batch\wav.scp --output_dir D:\batch\results三种模式的对应关系记一下后面都用得上offline文件转写、online实时听写、2pass流式出字 离线纠错默认 600ms 分块可调成 480ms 更低延时。踩坑急救箱我这边跑下来最容易翻车的五处按「现象 → 原因 → 一句话解法」记给你现象原因一句话解法客户端连接被拒 / 连不上10095 被别的程序占了netstat -ano \| findstr 10095找出进程或换个端口两边同步改点了允许还是连不上防火墙弹窗点错了重新触发一次连接允许「专用网络」访问再跑客户端首次启动卡住不动模型还在下载或网络波动看控制台有没有下载进度没有就换镜像源装依赖后重试客户端窗口中文乱码Windows 控制台编码问题窗口内先执行chcp 65001不影响识别结果本身识别一段长音频内存飙高一次性加载太长先用 ffmpeg 按 5–10 分钟切片再走批量列表性能调优速查按你的机器对号入座先动并发、再动线程你的配置建议2 核 / 4GB单文件短音频offline模式别开实时4 核 / 8GB2 路并发内实时听写可用8 核 / 16GB4 路以上并发长音频切片后批量转生产级并发几十上百路走 C 路线参考 SDK_advanced_guide_offline_zh.md四条通用原则长音频先切再批量比硬扛稳实时听写并发上来后改offline--chunk_size从5,10,5600ms换成8,8,4480ms能降延时但更吃算力调参优先调并发数别急着动线程。进阶玩法点到为止热词加权。在服务端加载热词文件每行格式「词 权重」例如阿里巴巴 20词长建议不超过 10 个字符、总数控制在 1000 以内、权重取 1–100。公司名、产品名、人名被反复识别错的话这一招见效最快。接到自己的应用。仓库自带 Python 客户端、html5 网页版浏览器里点麦克风就能试手机也能连以及 Java、C# 客户端二选一接进现有系统即可。延伸与社区快速上手总入口runtime/quick_start_zh.md离线文件转写部署详解runtime/docs/SDK_advanced_guide_offline_zh.md实时听写部署详解runtime/docs/SDK_advanced_guide_online_zh.md客户端与服务端参数参考runtime/python/websocket/README.md可选模型清单model_zoo/modelscope_models_zh.md社区项目与交流方式docs/community_projects_zh.md跑通第一条命令只是开始模型库和客户端文档会帮你把它接到自己的应用里。【免费下载链接】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),仅供参考