chatterbox

环境要求

• Python 环境（README 未注明最低版本）
• pip 包管理工具
• 示例代码导入了 PyTorch 与 torchaudio，需可正常安装
• 可选 NVIDIA GPU 与 CUDA 环境；无 GPU 时可用 CPU

安装与启动步骤

1. 1确认运行环境

   先确认 Python 与 pip 可用；示例代码同时导入 torch 与 torchaudio，安装依赖前先保证这两者可正常安装。

   python --version
   pip --version

   复制

2. 2安装 chatterbox-tts

   README 给出的标准安装方式是用 pip 从包索引安装 chatterbox-tts，一条命令即可完成。

   pip install chatterbox-tts

   复制

3. 3加载 Turbo 模型

   按 README 示例从预训练权重加载 ChatterboxTurboTTS；有 GPU 用 cuda，无 GPU 改成 cpu。

   python -c "import torchaudio as ta
   import torch
   from chatterbox.tts_turbo import ChatterboxTurboTTS
   
   model = ChatterboxTurboTTS.from_pretrained(device=\"cuda\", nano=True)"

   复制

4. 4改写为脚本运行

   命令较长时建议存成 .py 文件再执行，便于后续修改 device、nano 等参数并复用模型对象。

   python load_chatterbox.py

   复制

关键配置

如何确认成功

执行加载脚本无异常退出，模型对象成功创建，即说明依赖与权重可正常使用。

常见问题

注意事项

• README 明确该项目已停止维护，仅作为归档代码保留，不提供技术支持。
• README 中「从源码安装」的命令在节选里被截断，本教程未给出未经验证的源码安装命令。
• 示例仅展示模型加载，未包含文本合成调用；具体合成接口请以仓库代码为准。
• 涉及音色克隆时，请确保对参考音频拥有合法授权，遵守当地法律法规。