HuggingFace 预下载 ChatTTS 模型权重

为什么需要预下载

ChatTTS 首次执行 chat.load() 时会调用 HuggingFace 库自动下载模型权重。这个过程：

• 模型文件总量约数百 MB（取决于具体版本）
• 下载速度取决于你的网络状况和 HuggingFace CDN 距离
• 如果网络中途断开，HuggingFace 会断点续传，但总耗时不可控

预下载把这个不确定环节变成一个独立可控的步骤。

使用 huggingface-cli

最干净的方式是用 HuggingFace 官方 CLI：

huggingface-cli download 2Noise/ChatTTS

这会把 2Noise/ChatTTS 仓库下的全部模型文件下载到本地默认缓存目录。下载完成后，ChatTTS 的 chat.load() 会自动从缓存读取，不再联网。

如果没装 huggingface-cli：

pip install huggingface_hub

指定本地目录

如果你想把模型文件放到特定位置（比如移动硬盘）：

huggingface-cli download 2Noise/ChatTTS --local-dir ./chattts_models

然后在代码里指定加载路径：

chat = ChatTTS.Chat()
chat.load(compile=False, source='custom', custom_path='./chattts_models')

国内网络加速

HuggingFace 在国内访问不稳定。可选的加速方案：

• 设置镜像环境变量：set HF_ENDPOINT=hf-mirror 镜像地址（PowerShell）或 export HF_ENDPOINT=hf-mirror 镜像地址（Linux/Mac）
• 从 ModelScope 下载同款模型（见 ModelScope国内镜像）
• 使用代理工具确保 huggingface-cli 能连通

验证模型缓存

下载完成后，可以在以下位置找到模型文件：

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

目录下应有 *.safetensors 或 *.bin 权重文件以及配置文件。