
FunASR情感识别模型emotion2vec加载卡住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/FunASRFunASR是开源语音工具链其emotion2vec情感识别模型能对一段语音给出情绪标签与置信度首次调用emotion2vec_plus_large时最常见的卡点不在推理而在加载环节要么打印Download: iic/emotion2vec_plus_large failed!后初始化静默失败要么权重文件对不上只报一句init_param does not exist。以下排查笔记覆盖从模型定位到配置合并的完整加载链路。⚡ 最短路径4行代码跑通情感识别先pip install funasr modelscope然后用模型短名直接调用。短名emotion2vec_plus_large已注册在name_maps_from_hub.py中会自动映射到 ModelScope 的iic/emotion2vec_plus_large无需手动拼路径from funasr import AutoModel model AutoModel(modelemotion2vec_plus_large, devicecuda) result model.generate(inputaudio.wav, granularityutterance) print(result)granularityutterance表示输出整句层面的情绪标签与分数README_zh.md中的情感识别示例即此写法。 工作机制速览加载链路四步走加载逻辑集中在download_model_from_hub.py共四步模型定位先查name_maps_ms映射表命中则把短名换成完整的 ModelScope 模型 id文件下载调用snapshot_download拉取模型目录调用点本地已有目录时默认只远程检查版本check_latestTrue不重复下载配置合并读取模型目录的configuration.json或config.yaml并与传入参数合并自动回填model.pt、tokens.txt、am.mvn等文件路径依赖处理仅当trust_remote_codeTrue时安装模型目录requirements.txt中的依赖并从本地路径动态注册模型代码 排障速查报错现象对照表报错现象常见根因解决方法Download: iic/emotion2vec_plus_large failed!网络无法访问 ModelScope或 modelscope SDK 版本过旧、snapshot_download不支持user_agent参数pip install -U modelscope或改用本地路径加载跳过下载init_param does not exist用本地模型目录加载但目录里缺少model.pt补齐权重文件或改用模型 id 让框架自动下载ModuleNotFoundError提示缺少model模块模型目录含自定义model.py但未开启动态注册给AutoModel传入trust_remote_codeTrue第三类最容易误判报错里的model不像手误但它确实就是模型目录中代码文件的文件名去掉.py后缀动态推导出的模块名。根因在于动态导入只在trust_remote_codeTrue分支执行——开关关闭时目录里的model.py完全不会被执行config.yaml中声明的模型类自然找不到。修复只需补一个参数model AutoModel( modelemotion2vec_plus_large, trust_remote_codeTrue, )开启后若模型目录带requirements.txt其依赖会先被自动安装因此离线机器上建议提前核对依赖齐全。⚙️ 进阶场景离线加载的目录要求无网环境下可在联网机器下载完整模型包再按本地路径加载。加载器对目录结构的检查是固定的文件必需作用config.yaml是模型配置声明模型类与前端参数model.pt是权重文件缺失即报init_param does not existtokens.txt/bpe.model否词表存在则自动注册am.mvn否特征均值方差归一化文件requirements.txt否依赖清单仅在trust_remote_codeTrue时安装model AutoModel(model/data/models/emotion2vec_plus_large)缓存管理下载结果缓存在 modelscope 默认目录~/.cache/modelscope/hub下多项目共用同一份缓存本地目录已存在时只触发一次远程版本检查。重复初始化慢、或想固定模型版本时可通过model_revision参数指定分支而不是每次重新拉取。推理参数调优参数建议值作用devicecuda:0GPU 推理CPU 可用但明显更慢batch_size8~32批量推理按显存上调granularityutterance整句情绪粒度更细粒度可查教程文档资源入口情感识别调用示例README_zh.md模型短名映射表funasr/download/name_maps_from_hub.py下载与配置合并源码funasr/download/download_model_from_hub.py教程文档docs/tutorial/README_zh.md模型列表model_zoo/【免费下载链接】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),仅供参考