PyPI 一行安装 ChatTTS——pip install 快速上手

安装条件

• Python 3.9 及以上（推荐 3.11）
• 有 NVIDIA GPU 的话装好 CUDA（11.8 或 12.x 均可）；没有 GPU 也能用 CPU 跑但慢很多
• pip 包管理器

安装步骤

ChatTTS 依赖 PyTorch，建议把 torch 和 ChatTTS 一起装：

pip install torch ChatTTS torchaudio

如果需要特定 CUDA 版本的 torch（例如 CUDA 11.8），用 PyTorch 官方源：

pip install torch torchaudio --index-url PyTorch 官方 CUDA 源
pip install ChatTTS

验证安装

安装完跑一行确认：

python -c "import ChatTTS; print(ChatTTS.__version__)"

同时验证 GPU 是否可用：

python -c "import torch; print(torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'CPU only')"

安装后自动下载

ChatTTS 首次调用 chat.load() 时会自动从 HuggingFace 下载模型权重到本地缓存目录（~/.cache/huggingface/hub/ 或 Windows 的 C:\Users\你\.cache\huggingface\hub\）。这个下载步骤可能比较慢，见 HuggingFace模型获取 了解预下载方法。

常见安装问题

如果 pip 报错找不到合适的版本，先确认 Python 版本是否 ≥ 3.9。如果 torch 安装慢，可以换成国内镜像源：

pip install torch ChatTTS torchaudio -i 清华 PyPI 镜像

但注意 torch 的 CUDA 轮子最好还是从官方源装，国内镜像通常只有 CPU 版。