GPT-SoVITS hps未定义报错3步快速修复指南【免费下载链接】GPT-SoVITS1 min voice data can also be used to train a good TTS model! (few shot voice cloning)项目地址: https://gitcode.com/GitHub_Trending/gp/GPT-SoVITS装好环境、打开网页、点下生成屏幕却弹出NameError: name hps is not defined这是 GPT-SoVITS 语音推理时的高频坑别慌按下面三步就能修掉。一、先确认你踩的是不是这个坑对照下面三条全中才是本文的主角报错信息里带有NameError并且点名了hps这个变量堆栈顶部指向 inference_webui.py出错位置集中在三处附近计算int(hps.data.sampling_rate * 0.3)的暂停时长、进入torch.no_grad()关闭梯度计算的推理模式之前、以及给参考文本补标点的分句逻辑。如果你的堆栈长得不一样多半是别的错先别急着对号入座。二、hps 到底是什么hps 就是模型自带的说明书对象全称 hparams超参数里面装着采样率、滤波器长度这些推理必需的设定值。打个比方模型检查点是个快递包裹hps 就是盒子里的产品说明书——包裹没拆封或者说明书被新版包装格式藏起来了代码想照着说明书干活时自然无从下手直接抛出未定义。所以问题通常出在脚本、PyTorch 版本和模型版本的配合上而不是你亲手改坏了什么。三、三步修复hps报错更新推理脚本把仓库拉到最新用新版inference_webui.py覆盖旧文件这一步解决绝大多数旧脚本读不到新说明书的情况核对 PyTorch 版本运行pip show torch看一眼建议锁定 2.6.0版本偏差较大时重新安装对应版本必要时给 torch.load 加参数若报错仍指向加载模型的torch.load(...)一行是因为新版 PyTorch 默认收紧了读取权限给它补上weights_onlyFalse允许完整读回检查点里的配置即可新版脚本已内置该写法。修完重跑一次正常情况下就能听到声音了。四、环境配置速查表跑之前先过一遍这张表多数报错能提前拦住配置项建议值说明Python3.9.x过新过老都会踩依赖坑PyTorch2.6.0与推理脚本配套验证过的组合模型版本v1v3 与代码版本匹配新代码加载老模型前先确认对应关系依赖安装优先走官方安装脚本参考 install.sh少手动拼版本五、修完又冒出别的错如果你看到ModuleNotFoundError: No module named text.LangSegmenter多半是代码更新不彻底把仓库整体拉到最新或改用官方整合包再重装依赖别只覆盖单个文件如果你在 Mac M 系列芯片上跑注意 onnxruntime 要装 CPU 版而非 GPU 版PyTorch 选对应平台的包装错了推理阶段才炸如果你在 Windows 上跑跟着官方安装脚本走别跨系统复制 Python 虚拟环境。若问题仍反复出现把完整报错和项目版本信息贴出来社区里大概率有同款答案。盯紧项目的更新日志、翻一遍官方文档docs/cn/README.md遇到新坑时去社区讨论区搜一圈比反复硬试省时间。【免费下载链接】GPT-SoVITS1 min voice data can also be used to train a good TTS model! (few shot voice cloning)项目地址: https://gitcode.com/GitHub_Trending/gp/GPT-SoVITS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考