2026/9/20 20:53:10
FEATURED · 精选文章 
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-uiChatTTS-ui 是一款基于 ChatTTS 的本地网页语音合成工具既能用浏览器直接「打字变语音」也对外提供 API 接口。本文带你完成 ChatTTS-ui 的离线部署把模型提前备齐之后整个合成过程不依赖任何网络适合涉密环境、内网机房、野外作业和断网区域。为什么能「无网运行」先搞懂它的联网逻辑很多人以为离线部署需要复杂的开关配置其实不用。翻看主程序 app.py 会发现它的模型加载逻辑很朴素启动时先检查本地models/pzc163/chatTTS目录里的模型是否完整完整则直接加载全程不碰网络只有本地文件缺失时才会尝试联网从模型仓库下载。也就是说所谓离线部署只有一件事在还连着网的那台机器上让模型完整落盘一次。之后无论是拷到内网、U 盘还是光盘程序都只读本地文件。合成链路「文本 → 本地分词 → 模型推理 → 音频输出」全部在机器内部完成断网对音质和速度零影响。模型文件本身放在 ChatTTS/config/config.py 里定义了相对路径全部位于asset/子目录下这也是我们稍后核对文件的依据。准备工作联网窗口期完成这三件事把时间线倒过来想只有一段联网时间要把它用在刀刃上。第一步拿到源码克隆一份代码即可Windows、Linux、macOS 通用git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui第二步离线安装 Python 依赖ChatTTS-ui 的依赖清单见 requirements.txt核心是 torch、Flask、transformers、vocos 等。在联网机器上先按平台把所有 wheel 包下载下来再连同源码一起打包拷走pip download -r requirements.txt -d ./offline_packages到离线机器上Python 3.9–3.11别用 3.12会报 Dynamo 不支持pip install --no-index --find-links./offline_packages -r requirements.txt第三步让模型完整落盘一次在联网机器上直接启动一次程序python app.py看到模型下载完成、页面能正常合成后models/目录就已经齐活了。整个models/文件夹就是你离线部署的「弹药库」连同源码一起拷走。动手配置三步让离线环境跑起来核对模型文件离线机器上启动前先对照 ChatTTS/config/config.py 确认models/pzc163/chatTTS/asset/下这些成员都在Vocos.safetensors声码器负责还原波形DVAE.safetensors变分自编码器gpt/目录主语言模型权重Decoder.safetensors、tokenizer/、Embed.safetensorsspk_stat.pt音色统计参数缺了它音色无法生成config/path.yaml配置入口缺了会直接启动失败任何一项缺失都会导致启动时报文件找不到补全后重启即可。用 .env 声明运行方式项目根目录的.env文件控制运行行为离线部署建议这样填WEB_ADDRESS127.0.0.1:9966 devicecpu compilefalsedevice默认是default显存大于 4G 的 NVIDIA 显卡自动走 GPU纯 CPU 机器显式写cpu最省心compile是模型编译开关离线 CPU 环境关掉可避免一些 triton 相关的报错WEB_ADDRESS决定服务监听地址单机自用保持默认即可。启动并观察日志python app.py启动时会打印Starting...随后加载模型CPU 上需要十几秒到半分钟不等浏览器自动打开http://127.0.0.1:9966。运行日志按天滚动写在logs/目录出问题时从这里找答案。启动验证怎么确认服务真的能用了网页端验证打开页面输入一段中文点合成。能听到自然的人声读出文字中英文、数字混杂都没问题网页端就通了。API 端验证ChatTTS-ui 同时是 API 服务离线环境下的自动化调用比如接入剪辑软件走同一个入口。最简调用只需要一个text参数curl -X POST http://127.0.0.1:9966/tts -d text离线语音合成测试成功返回 JSON 中code: 0且带audio_files数组内含 wav 路径和下载地址说明接口可用。音色用voice参数指定项目自带了 20 多个预设音色如2222、7869、6653文件都放在 speaker/ 目录下。终极验证拔网线最后一步最直观——断开这台机器的网络再跑一次合成。一切照常恭喜离线部署完成。局域网共享让内网同事一起用如果希望办公室多台电脑共用一台离线语音合成服务器只需改.env里的监听地址WEB_ADDRESS192.168.1.100:9966写成服务器内网 IP或0.0.0.0:9966放行所有网卡后重启同事访问http://192.168.1.100:9966即可。另外项目自带 CPU 版 Docker 部署方案在容器化环境里执行docker compose -f docker-compose.cpu.yaml up -d也能跑容器会把./整个挂载进去models/自然被带上记得先把模型目录拷进项目。常见问题速查症状大概率原因与解法启动报FileNotFoundError ... path.yaml模型不完整从联网机器补拷models/pzc163/chatTTS/config/path.yaml报Missing spk_stat.ptasset/目录漏拷了spk_stat.pt补上即可报cannot find a working triton installation.env里把compiletrue改为compilefalse报Dynamo is not supported on Python 3.12Python 版本过高降到 3.9–3.11合成很慢CPU 推理本就比 GPU 慢长文本可拆短内存紧张时减少并发请求同一音色值每次声音略有差别属正常现象官方说明不同设备、甚至同设备不同时间同一种子音色会有漂移更完整的报错对照见项目自带的 faq.md离线排障时它就是本地说明书。进阶优化与日常维护性能调优改.env即可有 4G 以上显存的 NVIDIA 显卡把device设为default或cuda并装好 CUDA 12.8速度提升明显GPU 机器可试compiletrue进一步加速。磁盘卫生每次合成的 wav 都存在static/wavs/长期跑服务会越攒越多页面提供「清空」按钮也可定期手动清理logs/目录日志自动滚动单文件 1MB、保留 5 份无需人工干预。备份三件套models/模型本体、speaker/你收藏的固定音色 csv/pt 文件、.env运行配置。定期打包这三样换机迁移只需十分钟。音色管理喜欢的声音以.csv或.pt形式丢进speaker/目录即可被网页和 API 直接选用固定音色不随种子漂移适合做「专属配音」场景。照以上流程走一遍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），仅供参考
ChatTTS-ui 离线部署指南：让语音合成就此告别断网焦虑
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-uiChatTTS-ui 是一款基于 ChatTTS 的本地网页语音合成工具既能用浏览器直接「打字变语音」也对外提供 API 接口。本文带你完成 ChatTTS-ui 的离线部署把模型提前备齐之后整个合成过程不依赖任何网络适合涉密环境、内网机房、野外作业和断网区域。为什么能「无网运行」先搞懂它的联网逻辑很多人以为离线部署需要复杂的开关配置其实不用。翻看主程序 app.py 会发现它的模型加载逻辑很朴素启动时先检查本地models/pzc163/chatTTS目录里的模型是否完整完整则直接加载全程不碰网络只有本地文件缺失时才会尝试联网从模型仓库下载。也就是说所谓离线部署只有一件事在还连着网的那台机器上让模型完整落盘一次。之后无论是拷到内网、U 盘还是光盘程序都只读本地文件。合成链路「文本 → 本地分词 → 模型推理 → 音频输出」全部在机器内部完成断网对音质和速度零影响。模型文件本身放在 ChatTTS/config/config.py 里定义了相对路径全部位于asset/子目录下这也是我们稍后核对文件的依据。准备工作联网窗口期完成这三件事把时间线倒过来想只有一段联网时间要把它用在刀刃上。第一步拿到源码克隆一份代码即可Windows、Linux、macOS 通用git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui第二步离线安装 Python 依赖ChatTTS-ui 的依赖清单见 requirements.txt核心是 torch、Flask、transformers、vocos 等。在联网机器上先按平台把所有 wheel 包下载下来再连同源码一起打包拷走pip download -r requirements.txt -d ./offline_packages到离线机器上Python 3.9–3.11别用 3.12会报 Dynamo 不支持pip install --no-index --find-links./offline_packages -r requirements.txt第三步让模型完整落盘一次在联网机器上直接启动一次程序python app.py看到模型下载完成、页面能正常合成后models/目录就已经齐活了。整个models/文件夹就是你离线部署的「弹药库」连同源码一起拷走。动手配置三步让离线环境跑起来核对模型文件离线机器上启动前先对照 ChatTTS/config/config.py 确认models/pzc163/chatTTS/asset/下这些成员都在Vocos.safetensors声码器负责还原波形DVAE.safetensors变分自编码器gpt/目录主语言模型权重Decoder.safetensors、tokenizer/、Embed.safetensorsspk_stat.pt音色统计参数缺了它音色无法生成config/path.yaml配置入口缺了会直接启动失败任何一项缺失都会导致启动时报文件找不到补全后重启即可。用 .env 声明运行方式项目根目录的.env文件控制运行行为离线部署建议这样填WEB_ADDRESS127.0.0.1:9966 devicecpu compilefalsedevice默认是default显存大于 4G 的 NVIDIA 显卡自动走 GPU纯 CPU 机器显式写cpu最省心compile是模型编译开关离线 CPU 环境关掉可避免一些 triton 相关的报错WEB_ADDRESS决定服务监听地址单机自用保持默认即可。启动并观察日志python app.py启动时会打印Starting...随后加载模型CPU 上需要十几秒到半分钟不等浏览器自动打开http://127.0.0.1:9966。运行日志按天滚动写在logs/目录出问题时从这里找答案。启动验证怎么确认服务真的能用了网页端验证打开页面输入一段中文点合成。能听到自然的人声读出文字中英文、数字混杂都没问题网页端就通了。API 端验证ChatTTS-ui 同时是 API 服务离线环境下的自动化调用比如接入剪辑软件走同一个入口。最简调用只需要一个text参数curl -X POST http://127.0.0.1:9966/tts -d text离线语音合成测试成功返回 JSON 中code: 0且带audio_files数组内含 wav 路径和下载地址说明接口可用。音色用voice参数指定项目自带了 20 多个预设音色如2222、7869、6653文件都放在 speaker/ 目录下。终极验证拔网线最后一步最直观——断开这台机器的网络再跑一次合成。一切照常恭喜离线部署完成。局域网共享让内网同事一起用如果希望办公室多台电脑共用一台离线语音合成服务器只需改.env里的监听地址WEB_ADDRESS192.168.1.100:9966写成服务器内网 IP或0.0.0.0:9966放行所有网卡后重启同事访问http://192.168.1.100:9966即可。另外项目自带 CPU 版 Docker 部署方案在容器化环境里执行docker compose -f docker-compose.cpu.yaml up -d也能跑容器会把./整个挂载进去models/自然被带上记得先把模型目录拷进项目。常见问题速查症状大概率原因与解法启动报FileNotFoundError ... path.yaml模型不完整从联网机器补拷models/pzc163/chatTTS/config/path.yaml报Missing spk_stat.ptasset/目录漏拷了spk_stat.pt补上即可报cannot find a working triton installation.env里把compiletrue改为compilefalse报Dynamo is not supported on Python 3.12Python 版本过高降到 3.9–3.11合成很慢CPU 推理本就比 GPU 慢长文本可拆短内存紧张时减少并发请求同一音色值每次声音略有差别属正常现象官方说明不同设备、甚至同设备不同时间同一种子音色会有漂移更完整的报错对照见项目自带的 faq.md离线排障时它就是本地说明书。进阶优化与日常维护性能调优改.env即可有 4G 以上显存的 NVIDIA 显卡把device设为default或cuda并装好 CUDA 12.8速度提升明显GPU 机器可试compiletrue进一步加速。磁盘卫生每次合成的 wav 都存在static/wavs/长期跑服务会越攒越多页面提供「清空」按钮也可定期手动清理logs/目录日志自动滚动单文件 1MB、保留 5 份无需人工干预。备份三件套models/模型本体、speaker/你收藏的固定音色 csv/pt 文件、.env运行配置。定期打包这三样换机迁移只需十分钟。音色管理喜欢的声音以.csv或.pt形式丢进speaker/目录即可被网页和 API 直接选用固定音色不随种子漂移适合做「专属配音」场景。照以上流程走一遍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），仅供参考 
