ChatTTS_colab

环境要求

• macOS 上需先安装 Conda
• Python 3.11（README 用 conda 创建该版本环境）
• 需能访问 GitHub，并允许首次运行时自动下载 ChatTTS 模型
• 使用 Colab 方式需要浏览器与可打开 Notebook 的环境

安装与启动步骤

1. 1Colab 一键运行

   想免配置可点顶部 Open In Colab，打开笔记本后执行“代码执行程序-全部运行”，在日志中找访问地址。

2. 2创建 Conda 环境

   macOS 本地运行的第一步，新建名为 ChatTTS_colab 的 Python 3.11 环境。

   conda create -n "ChatTTS_colab" python=3.11

   复制

3. 3激活环境

   后续所有安装与运行命令都要在这个已激活的环境中执行。

   conda activate ChatTTS_colab

   复制

4. 4克隆项目仓库

   把 ChatTTS_colab 项目代码拉到本地，命令为 README 中的 SSH 地址形式。

   git clone git@github.com:6drf21e/ChatTTS_colab.git

   复制

5. 5装入 ChatTTS 依赖

   按 README 在项目目录内克隆 ChatTTS，切到指定提交 e6412b1，再把 ChatTTS 子目录移到项目根目录。

   cd ChatTTS_colab
   git clone -q https://github.com/2noise/ChatTTS
   cd ChatTTS
   git checkout -q e6412b1
   cd ..
   mv ChatTTS temp
   mv temp/ChatTTS ./ChatTTS
   rm -rf temp

   复制

6. 6安装项目依赖

   在项目目录中按 requirements-macos.txt 安装本项目所需依赖。

   cd ChatTTS_colab
   pip install -r requirements-macos.txt

   复制

7. 7启动 WebUI

   运行启动脚本，首次会等待自动下载 ChatTTS 模型，正常时自动打开浏览器。

   python webui_mix.py

   复制

如何确认成功

启动后日志出现 Loading ChatTTS model...，模型加载完成会自动打开浏览器；Colab 方式则在日志里出现 Running on public URL: https://**********.gradio.live。

常见问题

注意事项

• README 只给出了 Colab 与 macOS 两套明确流程，其他系统未提供命令，请勿自行套用。
• 克隆项目用的是 SSH 地址 git@github.com:6drf21e/ChatTTS_colab.git，未配置 SSH key 时需自行调整访问方式。
• ChatTTS 需检出提交 e6412b1，不要随意换成其他版本，以免与本项目不兼容。
• 长音频生成、音色抽卡、分角色朗读、流式输出均为项目内置功能，启动 WebUI 后即可体验。