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公司里有一台接入内网测试环境的机器需要批量把中英混杂文本转成语音但没有外网。ChatTTS-ui 默认启动流程会先检测网络、再从模型仓库拉取模型在内网机器上这一步直接失败。本文带你完成 ChatTTS-ui 离线部署的完整链路离线安装 Python 依赖、拷贝模型目录、启动服务并验收网页与 API 两种调用方式。离线部署前置条件动手前先备齐以下资源两台机器一台可联网的机器负责下载 wheel 包和生成模型一台内网目标机需装好 Python 3.9–3.11硬件内存 8GB 以上如需 GPU 加速需 NVIDIA 显卡且显存 ≥ 4GB、已安装 CUDA 12.8 ToolKit显存低于 4GB 时程序会强制使用 CPU项目代码内网机上执行git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui .拉取先确定方案两种部署方式对比项目纯 CPU 方案GPU 加速方案适用场景验证环境、偶发合成批量生产、高频 API 调用系统附加要求无CUDA 12.8 ToolKit附加依赖包无nvidia-cublas-cu11、nvidia-cudnn-cu11推理速度明显偏慢明显加快阶段一在内网机获取项目代码创建目录并克隆代码git clone仅在此步骤使用一次cd /data/chattts git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui .预期结果终端输出Cloning into .... done目录下出现app.py、requirements.txt、speaker/等文件。创建并激活虚拟环境python3 -m venv venv source ./venv/bin/activate阶段二离线安装 Python 依赖依赖清单见 requirements.txt思路是联网机下载 wheel → 拷贝 → 内网机断网安装。在联网机器上下载全部依赖pip download -r requirements.txt -d ./offline_packages需要 GPU 加速时额外下载 cu128 版 torchpip download torch2.7.1 torchaudio2.7.1 \ --index-url https://download.pytorch.org/whl/cu128 -d ./offline_packages预期结果offline_packages/下生成一批.whl文件无下载失败提示。将offline_packages/拷入内网机项目目录执行离线安装pip install --no-index --find-links./offline_packages -r requirements.txt预期结果日志末尾输出Successfully installed ...且全程没有Retrying联网重试行。阶段三拷贝并放置 ChatTTS 模型文件模型统一存放在项目下的models/目录。app.py 启动时会先尝试纯本地加载本地模型完整时不发起任何网络请求CHATTTS_DIR MODEL_DIR /pzc163/chatTTS huggingface_hub.snapshot_download( repo_id2Noise/ChatTTS, local_dirCHATTTS_DIR, local_files_onlyTrue )最稳妥的做法在联网机上先跑一次python3 app.py生成完整模型再把整个models/目录拷入内网机。目录结构应如下models/pzc163/chatTTS/ ├── asset/ │ ├── GPT.pt │ ├── DVAE.pt │ ├── Decoder.pt │ ├── Vocos.pt │ ├── tokenizer.pt │ └── spk_stat.pt └── config/ ├── path.yaml ├── gpt.yaml ├── dvae.yaml ├── decoder.yaml └── vocos.yaml预期结果ls models/pzc163/chatTTS/asset能列出全部 6 个.pt文件config/下有 5 个 yaml。⚠️spk_stat.pt和config/path.yaml是最容易漏拷的两个文件缺一个启动必报错。阶段四配置 .env 并启动服务编辑项目根目录.env三个变量由 uilib/cfg.py 读取默认值WEB_ADDRESS127.0.0.1:9966 compilefalse devicedefault需要局域网访问时把第一行改为内网机 IP例如WEB_ADDRESS192.168.0.10:9966device默认自动选择显存大于 4GB 的 NVIDIA 卡用 CUDA否则 CPU也可显式写cpu或cuda。启动服务python3 app.py预期结果终端输出Start:192.168.0.10:9966且不出现当前从阿里魔塔下载模型...或 huggingface 下载字样若出现下载提示说明本地模型不完整回到阶段三检查。验收测试确认离线合成生效网页端内网浏览器打开http://192.168.0.10:9966输入离线部署验证成功test 12345点击合成并试听。API 端在内网机执行curl -X POST http://127.0.0.1:9966/tts \ -d text离线部署验证成功voice2222temperature0.3预期结果返回 JSON 中code:0url字段指向/static/wavs/下的 wav 地址浏览器打开即可下载音频。✅ 至此 ChatTTS-ui 离线部署完成。问题速查现象启动报FileNotFoundError: .../config/path.yaml→原因模型拷贝不完整 →修复对照阶段三清单补齐config/目录现象Missing spk_stat.pt→原因asset 目录缺spk_stat.pt→修复把该文件复制进models/pzc163/chatTTS/asset/现象Dynamo is not supported on Python 3.12→原因Python 版本过高 →修复降级到 Python 3.10 并重建虚拟环境现象cannot find a working triton installation→原因torch.compile 编译失败 →修复.env中设compilefalse后重启现象启动时仍尝试从 modelscope 下载模型 →原因本地models/目录文件不全 →修复重跑阶段三的完整性检查更多报错处理方式见项目内 faq.md。收尾完成以上四个阶段内网机即拥有一个完全离线的语音合成服务网页端可人工使用/tts接口可供程序调用全程不产生外网请求。后续如需要固定音色多次合成声音一致把 csv 或 pt 音色文件放入speaker/目录在 API 的voice参数中引用即可若配合 pyVideoTrans 做视频配音直接将其 ChatTTS 请求地址填为本服务地址。【免费下载链接】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），仅供参考