ChatTTS本地部署教程：5分钟搭一套免费的文字转语音服务-北京尧图网络

ChatTTS本地部署教程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 就是为此而生的本地方案一个网页界面把中英文混杂、带数字符号的文本合成为自然语音同时对外暴露 REST 接口方便接进你现有的程序。按下面的步骤走从空机器到第一条语音大概 5 分钟。先确认你属于哪类人这个项目适合三种情况内容制作要批量合成中文、中英混杂的旁白且希望同一句子的音色可固定复用开发者字幕、配音、朗读类应用需要一个可私有的 TTS 接口隐私敏感文本不能离开本机或团队内部部署、多人共用一台机器如果你的需求只是偶尔转几句话云 TTS API 反而更省事没必要折腾本地部署。5分钟跑通预打包版最快Windows 用户从 Releases 下载压缩包解压后直接双击app.exe浏览器会自动打开http://127.0.0.1:9966。两个注意点部分安全软件会误报病毒可临时放行或改走源码部署英伟达显卡显存大于 4G 且安装了 CUDA 12.8 才会启用 GPU 加速否则自动回退 CPU源码部署Linux / macOS / Windows 三条路三种系统的流程一致只是装 torch 的方式不同。以 Linux 为例要求 Python 3.9–3.113.12 以上会报 Dynamo 错误mkdir -p /data/chattts cd /data/chattts git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui . python3 -m venv venv source ./venv/bin/activate pip3 install -r requirements.txtCPU 版直接装基础 torchGPU 版追加--index-url https://download.pytorch.org/whl/cu128并装好 CUDA 12.8pip3 install torch2.7.1 torchaudio2.7.1 --index-url https://download.pytorch.org/whl/cu128最后一步统一是python3 app.py启动后浏览器自动打开默认地址http://127.0.0.1:9966。macOS 用户额外执行brew install libsndfile libompDocker 用户则只需一条命令docker compose -f docker-compose.gpu.yaml up -d # CPU 换成 docker-compose.cpu.yaml首次启动会自动下载 ChatTTS 模型优先从魔塔 modelscope 拉取连不上再走 huggingface。这一步是唯一耗时的环节下完就缓存在本地了。网页界面能做什么界面由 templates/index.html 渲染按系统语言自动切换中英文核心控件就这几类控件说明文本框按行输入每行合成一段支持数字、符号与控制符混杂音色选择读取speaker/目录下的 csv / pt 音色文件也可填一个数字随机取音色控制符 prompt如[oral_2][laugh_0][break_6]控制口语度、笑声、停顿采样参数temperature默认 0.3、top_p0.7、top_k20自定义音色种子填大于 0 的整数比voice参数优先级更高合成结果统一是 24kHz 的 wav落在static/wavs/目录页面上可直接试听和下载。接入你的程序/tts 接口对外接口定义在 app.pyPOST http://127.0.0.1:9966/tts唯一必填参数是textimport requests res requests.post( http://127.0.0.1:9966/tts, data{text: 你好这是 ChatTTS 本地合成的语音, voice: 3333} ) print(res.json()) # 成功: {code:0, msg:ok, audio_files:[{filename:本地wav路径, url:可下载地址, ...}]} # 失败: {code:1, msg:错误原因}按需再加这些可选参数prompt控制符如[oral_2][break_6]custom_voice自定义音色种子设置后忽略voicetemperature/top_p/top_k随机性控制speed语速默认 5wav1直接返回 wav 文件而不是 JSONaudio_files里同时给了本地绝对路径和 http 下载地址按你的场景取一个即可。常见报错怎么解九成问题都能在下面这条清单里对号入座完整列表见 faq.md症状处理modelscope 下载报 ProxyError从魔塔下模型时关闭代理国内连不上它才会回退 huggingface缺spk_stat.pt或path.yaml模型不完整手动补齐到models/pzc163/chatTTS/对应子目录cannot find a working triton installation打开.env把compiletrue改成compilefalse有 GPU 却慢、走 CPU显存低于 4G 会强制 CPU否则卸载 torch 重装 cu128 版本同种子音色对不上正常现象跨机器、甚至同机器多次合成音色都可能漂移地址和端口想改就编辑 .env 里的WEB_ADDRESS比如改成192.168.0.10:9966让局域网访问device字段可手动指定cpu/mps/cuda。上线前检查清单Python 在 3.9–3.11 区间3.12 会报 Dynamo 不支持torch 版本 2.7.1GPU 用户确认装的是 cu128 版本首次启动已让模型下载完毕models/目录.env中WEB_ADDRESS是你想要的监听地址浏览器打开http://127.0.0.1:9966成功合成出一句语音机器只启动这一次最费时之后每一次合成都是本地免费完成——文本不出门接口随你调。【免费下载链接】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本地部署教程：5分钟搭一套免费的文字转语音服务

相关推荐

保姆级 ComfyUI 工作流实战：文生图、3D 建模到图像修复，16 套预置配方开箱即用

Anthropic Console 用量不更新？Claude Code 的 Base URL 填 TaoToken 再发测试请求

Evidently 快速上手：100+ 指标一站式评测、测试与监控 ML 与 LLM 系统

更多资讯

Atlas 300V 24G部署YOLO：模型转换、推理优化与性能调优实战

UE5.2升级C4756警告：INFINITY宏常量折叠冲突与解决方案

医学知识图谱与DeepSeek如何赋能医疗损害责任鉴定

SasView小角散射数据分析实战：从模型选择到参数拟合全攻略

LLVM不是编译器？一文搞懂编译器基础设施与自定义Pass

手机EMC测试实战：辐射骚扰、desense与ESD整改思路全解析

今日更新

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？