TTS-Audio-Suite

环境要求

• 已安装并可正常运行的 ComfyUI（便携版或 venv/conda 版均可）
• Git 命令行工具，用于克隆仓库
• Python 环境与 ComfyUI 一致（便携版用其自带 python_embeded）
• 可选：安装 FFmpeg 以获得更好的音频处理效果
• 可选：Python 3.13 也受支持，MediaPipe 不可用时自动改用 OpenSeeFace

安装与启动步骤

1. 1进入节点目录

   先切换到 ComfyUI 的 custom_nodes 目录，所有自定义节点都装在这里。

   cd ComfyUI/custom_nodes

   复制

2. 2克隆项目仓库

   从 GitHub 拉取 TTS-Audio-Suite 源码，并进入项目目录。

   git clone https://github.com/diodiogod/TTS-Audio-Suite.git
   cd TTS-Audio-Suite

   复制

3. 3升级打包工具

   官方强烈建议先升级 pip、setuptools、wheel，可减少 s3tokenizer 等依赖的安装报错。

   python -m pip install --upgrade pip setuptools wheel

   复制

4. 4运行智能安装脚本

   安装脚本会自动处理依赖冲突和 Python 版本兼容。venv/conda 用户先激活 ComfyUI 环境再执行 python install.py。

   python install.py

   复制

5. 5便携版专用安装

   ComfyUI 便携版必须使用其自带解释器：Windows 为 ......python_embededpython.exe，Linux/Mac 为 ../../../python_embeded/python.exe。

   ......python_embededpython.exe install.py

   复制

6. 6重启 ComfyUI

   重启后节点才会加载，在节点列表里应能看到 TTS Audio Suite 分类。

7. 7导入示例工作流

   下载并拖入 ChatterBox 集成工作流即可开始生成，模型在首次使用时自动下载。

如何确认成功

重启 ComfyUI 后，在节点菜单中能看到 TTS Audio Suite 节点分类，即表示安装成功。

常见问题

注意事项

• 官方建议为 TTS-Audio-Suite 单独建一个干净的 ComfyUI 便携安装，安装更顺、初始化更快。
• 有依赖问题时先激活正确的 ComfyUI 虚拟环境再运行 install.py，否则包会装错位置。
• FFmpeg 为可选项，但推荐安装以获得高质量音频拉伸效果。
• 首次使用会下载模型，建议保证网络通畅或提前按文档准备离线模型目录。