ChatTTS-ui离线部署指南5个任务搞定无网络语音合成【免费下载链接】ChatTTS-ui一个简单的本地网页界面使用ChatTTS将文字合成为语音同时支持对外提供API接口。A simple native web interface that uses ChatTTS to synthesize text into speech, along with support for external API interfaces.项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui在船上看台、涉密机房这类没有网络的地方你依然想把文字变成人声。ChatTTS-ui是一个本地网页工具用ChatTTS做文字转语音还能对外提供API。把ChatTTS-ui离线部署一次它就能整机脱网工作。开始之前离线怎么跑离线模式不需要什么复杂原理文本输入 → 本地模型推理 → 输出wav音频全部计算都在你机器上完成全程不碰外网。所以部署只干一件事——把本地模型和离线依赖搬上机器再确认程序不会试图联网。部署前准备模型文件与依赖清单先备齐下面这些东西条目它的作用gpt/ 语言模型决定说什么语音合成的核心DVAE.safetensors音频变分自编码器Decoder.safetensors音频解码器Vocos.safetensors声码器负责最终波形输出Embed.safetensors嵌入层tokenizer/分词器spk_stat.pt说话人统计量用来生成随机音色requirements.txt packages/ 目录离线依赖程序所需的全部Python包.env启动配置监听地址、设备、编译开关前7项构成完整的本地模型文件统一放在models/pzc163/chatTTS/asset/下。任务一趁有网预下载模型和离线依赖任务目标联网阶段把资源拿全到了离线环境一次下载都不用触发。在有网的机器上跑一遍python app.py程序会自动把整套模型拉到项目根目录的 models 下等它正常启动即可。接着生成离线依赖包pip download -r requirements.txt -d packagespip download只下载不安装生成的 packages/ 就是能直接搬走的离线依赖库。完成判据asset/ 下7个条目齐全packages/ 里有几十到上百个 .whl 文件。任务二把模型文件放到位任务目标离线机器的程序能在本地命中模型启动时不再发起任何联网动作。把有网机器上的 models/ 整个目录拷到离线项目根目录层级原样保留models/pzc163/chatTTS/asset/ ├── gpt/ tokenizer/ ├── DVAE.safetensors Decoder.safetensors ├── Vocos.safetensors Embed.safetensors └── spk_stat.pt⚠️ 路径是命门app.py 启动时优先查本地目录只有本地命中才会跳过联网。位置放错程序启动就会去连网在离线环境里直接卡死。默认模型路径已在ChatTTS/config/config.py里定义好不用改代码。完成判据和有网机器逐项对照7个条目一个不少。任务三断网安装离线依赖任务目标不联网装齐全部Python包。pip install --no-index --find-linkspackages -r requirements.txt--no-index的意思是禁止碰网络--find-links指向本地包目录所有包都从 packages/ 里装。完成判据python -c import torch, flask执行无报错。任务四配置启动环境起服务任务目标启动后本机、局域网内的其他机器都能用。在项目根目录新建 .env写入两行WEB_ADDRESS0.0.0.0:9966 compilefalse前者让局域网内其他机器能访问页面纯CPU机器把 compile 设为 false能省掉首次编译的开销。然后运行python app.py启动。完成判据浏览器打开http://127.0.0.1:9966/页面正常渲染启动日志里没有 Downloading 之类的联网输出。自查验证一次真实合成确认离线语音合成可用先确认页面可达再跑一次真实合成curl -I http://127.0.0.1:9966/ curl http://127.0.0.1:9966/tts?text离线合成测试voice2222wav1 -o test.wav第一条是健康检查第二条发起合成请求并把音频存成 test.wav。文件能播放且人声正常离线语音合成就算打通了。性能基线参考单机单请求项目在线模式离线模式响应时间200-500ms300-800ms音频质量优秀良好并发能力高中稳定性依赖网络完全稳定避坑卡常见故障按现象 → 原因 → 解法处理⚠️ 遇到问题先对号入座启动卡在Downloading model...或报网络错误现象启动日志长时间停在下载提示或直接报网络异常原因本地模型文件不全触发了联网拉取解法逐一核对models/pzc163/chatTTS/asset/下的7个条目局域网其他机器访问不了现象本机能打开页面别的机器访问超时原因WEB_ADDRESS 还是 127.0.0.1解法.env 里改成 0.0.0.0:9966 后重启并放行防火墙对应端口合成中途崩溃、报内存错误现象进程消失或提示 out of memory原因内存不足或并发请求过多解法降低并发CPU机器保持 compilefalse内存升到16GB以上合成报找不到音色现象API 返回错误没有音频输出原因指定的音色名在 speaker/ 目录里不存在解法改用 speaker/ 目录下已有的 .csv 文件名调优与日常硬件选型和维护备份硬件选型个人使用8GB内存、4核CPU即可企业内网部署建议16GB以上、8核起步高并发场景配32GB以上加独立GPU。参数调优想在GPU上跑把 .env 里的 device 改掉编译开关打开可缩短热启动延迟。temperature、top_p、top_k 等合成参数通过API传参就能调不用动配置。日常维护做三件事定期核对模型文件完整性和源机对比文件数量与大小备份 models/ 目录和 .env换机器时快速重建定期清理 static/wavs/ 里的历史音频翻一翻 logs/ 下的日志有无报错写在最后做到这一步彻底断网的环境下ChatTTS-ui依然能稳定吐出语音。模型、依赖、配置都在自己机器上业务不用怕断网等网络恢复离线语音合成能力也一直待命。【免费下载链接】ChatTTS-ui一个简单的本地网页界面使用ChatTTS将文字合成为语音同时支持对外提供API接口。A simple native web interface that uses ChatTTS to synthesize text into speech, along with support for external API interfaces.项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考