如何在5分钟内部署Chatterbox-TTS-Server超详细新手安装指南【免费下载链接】Chatterbox-TTS-ServerSelf-host the powerful Chatterbox TTS model. This server offers a user-friendly Web UI, flexible API endpoints (incl. OpenAI compatible), predefined voices, voice cloning, and large audiobook-scale text processing. Runs accelerated on NVIDIA (CUDA), AMD (ROCm), and CPU.项目地址: https://gitcode.com/gh_mirrors/ch/Chatterbox-TTS-ServerChatterbox-TTS-Server是一款功能强大的本地部署文本转语音服务器支持OpenAI兼容API、Web界面、预设语音、语音克隆和长文本处理可在NVIDIACUDA、AMDROCm和CPU上加速运行。本文将为你提供超详细的新手安装指南让你在5分钟内完成部署。 准备工作系统要求与环境检查在开始安装前请确保你的系统满足以下要求操作系统Windows 10/1164位或LinuxDebian/Ubuntu推荐Python3.10版本必须可从Python官网下载Git用于克隆仓库可从Git官网下载硬件要求推荐配置NVIDIA GPURTX 20/30/40/50系列或AMD GPUROCm兼容最低配置仅CPU性能较慢适合测试存储空间至少10GB可用空间用于依赖和模型缓存️ 硬件兼容性检查硬件类型安装选项驱动要求CPU 仅--cpu无NVIDIA RTX 20/30/40--nvidia525NVIDIA RTX 5090/Blackwell--nvidia-cu128570AMD GPU (Linux)--rocmROCm 6.4Apple Silicon手动安装macOS 12.3⚡ 快速安装5分钟自动化部署Chatterbox-TTS-Server提供了自动化启动器可一键完成环境配置和服务器启动适合大多数用户。1️⃣ 克隆仓库打开终端Windows用户可使用命令提示符或PowerShell执行以下命令git clone https://gitcode.com/gh_mirrors/ch/Chatterbox-TTS-Server cd Chatterbox-TTS-Server2️⃣ 运行自动化启动器根据你的操作系统选择相应命令Windows系统# 双击start.bat或在命令提示符中运行 start.batLinux/macOS系统# 赋予执行权限并运行 chmod x start.sh ./start.sh3️⃣ 选择安装类型启动器会自动检测你的硬件并显示安装菜单══════════════════════════════════════════════════════════════ Hardware Detection ══════════════════════════════════════════════════════════════ NVIDIA GPU: Detected (NVIDIA GeForce RTX 4090) AMD GPU: Not detected ══════════════════════════════════════════════════════════════ Select Installation Type ══════════════════════════════════════════════════════════════ [1] CPU Only No GPU acceleration - works on any system [2] NVIDIA GPU (CUDA 12.1) [DEFAULT] Standard for RTX 20/30/40 series [3] NVIDIA GPU (CUDA 12.8) For RTX 5090 / Blackwell GPUs only [4] AMD GPU (ROCm 6.4) For AMD GPUs on Linux Enter choice [2]:按Enter键选择推荐选项或输入数字选择其他安装类型。4️⃣ 等待安装完成启动器会自动创建Python虚拟环境安装依赖包下载模型文件首次运行需几分钟启动服务器5️⃣ 访问Web界面服务器启动后会自动打开浏览器访问Web界面默认地址http://localhost:8004。如果没有自动打开可手动在浏览器中输入该地址。 Docker安装容器化部署方案如果你熟悉Docker可使用容器化方式部署确保环境一致性。1️⃣ 安装Docker和Docker Compose安装Docker安装Docker Compose2️⃣ 克隆仓库同上git clone https://gitcode.com/gh_mirrors/ch/Chatterbox-TTS-Server cd Chatterbox-TTS-Server3️⃣ 根据硬件启动容器NVIDIA GPU用户# RTX 20/30/40系列 docker compose up -d --build # RTX 5090/Blackwell系列 docker compose -f docker-compose-cu128.yml up -d --buildAMD GPU用户Linuxdocker compose -f docker-compose-rocm.yml up -d --buildCPU用户docker compose -f docker-compose-cpu.yml up -d --build4️⃣ 访问Web界面打开浏览器访问http://localhost:8004️ Chatterbox-TTS-Server界面预览部署完成后你将看到直观友好的Web界面支持文本输入、语音选择、参数调整等功能。深色模式界面提供了丰富的功能选项包括文本输入框、语音模式选择、生成参数调节等。你可以选择预设语音或上传参考音频进行语音克隆还能调整温度、语速等参数获得理想的语音效果。浅色模式界面同样功能齐全适合不同使用习惯的用户。界面上方的引擎选择器可快速切换Original Chatterbox、Chatterbox Multilingual和Chatterbox-Turbo三种模型满足不同场景需求。⚙️ 基本使用指南文本转语音基本操作选择引擎在界面顶部的引擎选择器中选择合适的模型输入文本在Text to synthesize文本框中输入要转换的文字选择语音模式Predefined Voices从下拉菜单选择预设语音Voice Cloning上传参考音频进行语音克隆调整参数可选Temperature控制语音随机性0.0-1.0Speed Factor调整语速0.5-2.0Chunk Size长文本分割大小点击生成点击Generate Speech按钮开始转换播放与下载使用内置播放器听取结果点击下载按钮保存音频 使用Paralinguistic标签Turbo模型当选择Chatterbox-Turbo引擎时可以在文本中加入表情标签使语音更生动Hi there [chuckle] — thanks for calling back. One moment… [cough] sorry about that. Lets get this fixed.支持的标签包括[laugh]、[cough]、[chuckle]等。 常见问题解决安装失败怎么办Python版本问题确保使用Python 3.103.11不支持网络问题检查网络连接确保能访问Hugging Face Hub权限问题尝试以管理员身份运行终端/PowerShell空间不足确保至少有10GB可用空间启动后无法访问Web界面检查终端输出确认服务器是否成功启动确认端口是否被占用可修改config.yaml中的server.port尝试访问http://127.0.0.1:8004替换为实际端口GPU未被识别NVIDIA用户确保安装了最新驱动和NVIDIA Container ToolkitAMD用户检查ROCm驱动是否正确安装用户是否在video和render组尝试使用--cpu选项以CPU模式运行 进阶配置与优化修改配置文件主要配置文件位于项目根目录的config.yaml可调整服务器端口、日志设置模型路径、缓存位置默认生成参数音频输出格式、采样率修改后需重启服务器生效。性能优化建议启用BF16推理设置环境变量TTS_BF16on可提升GPU性能调整 chunk size处理长文本时适当调整chunk_size参数使用Streaming模式对于长文本设置streamtrue可实现边生成边播放 结语通过本指南你已经成功部署了Chatterbox-TTS-Server现在可以开始体验高质量的文本转语音服务了无论是制作有声书、开发语音助手还是创建个性化语音内容Chatterbox-TTS-Server都能满足你的需求。如果在使用过程中遇到问题可查阅项目文档或提交issue寻求帮助。祝你使用愉快【免费下载链接】Chatterbox-TTS-ServerSelf-host the powerful Chatterbox TTS model. This server offers a user-friendly Web UI, flexible API endpoints (incl. OpenAI compatible), predefined voices, voice cloning, and large audiobook-scale text processing. Runs accelerated on NVIDIA (CUDA), AMD (ROCm), and CPU.项目地址: https://gitcode.com/gh_mirrors/ch/Chatterbox-TTS-Server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考