ChatTTS 模型下载慢——HuggingFace 超时的加速方案

症状

首次调用 chat.load() 时卡在模型下载上，速度几 KB/s 或直接超时。

解决方案

方案一：用 ModelScope 源（最简单）

chat.load(compile=False, source='modelscope')

ChatTTS 内置对 ModelScope 的支持，国内访问速度通常比 HuggingFace 快一个数量级。

方案二：手动预下载 + 本地路径

提前用 huggingface-cli 下载模型：

set HF_ENDPOINT=hf-mirror 镜像地址
huggingface-cli download 2Noise/ChatTTS

（上面的 set HF_ENDPOINT 是 PowerShell 语法；Linux/Mac 用 export HF_ENDPOINT=hf-mirror 镜像地址）

然后 ChatTTS 的 chat.load() 会自动从本地缓存读取。

方案三：手动下载到自定义目录

set HF_ENDPOINT=hf-mirror 镜像地址
huggingface-cli download 2Noise/ChatTTS --local-dir ./my_chattts_model

然后在代码里指定：

chat.load(compile=False, source='custom', custom_path='./my_chattts_model')

方案四：代理

有可用代理的话：

set HTTPS_PROXY=你的代理地址和端口
chat.load(compile=False)

下载完成后怎么验证

模型缓存目录应该有以下文件（HuggingFace 默认路径）：

• Linux/Mac：~/.cache/huggingface/hub/models--2Noise--ChatTTS/
• Windows：C:\Users\你的用户名\.cache\huggingface\hub\models--2Noise--ChatTTS\

里面应该有 *.safetensors 或 *.bin 权重文件和配置文件。