ChatTTS 自带的 Gradio WebUI 启动与使用
启动命令
从源码仓库启动(PyPI 安装的 ChatTTS 包不带示例):
git clone 仓库地址(GitHub 上搜索 ChatTTS)
cd ChatTTS
pip install -r requirements.txt
pip install gradio
python examples/web/webui.py
启动成功后,终端会显示本地访问地址,默认是端口 7860(浏览器打开 127.0.0.1:7860)。
网络部署(远端服务器)
如果在云端 GPU 上运行,需要开放端口并设置 --server_name:
python examples/web/webui.py --server_name 0.0.0.0 --server_port 7860
然后通过服务器 IP:7860 访问。如果用 Clore.ai 这类云 GPU 平台,面板里会提供对外访问地址。
WebUI 提供的功能
官方 WebUI 是一个基础演示:
- 文本输入框(支持多行)
- 说话人选择
- 生成按钮
- 音频播放(Gradio Audio 组件)
- 音频下载
模型首次加载
WebUI 启动后第一次生成音频时,ChatTTS 会执行模型加载(含权重下载)。这个过程可能几十秒到几分钟,取决于网络速度。后续生成就很快了。
常见问题
| 问题 | 解决方案 |
|---|---|
| 启动报 gradio 未安装 | pip install gradio |
| 端口被占用 | 加 --server_port 8080 等换端口 |
| 模型下载慢 | 用 HuggingFace CLI 预下载(见 HuggingFace模型获取) |
| 浏览器打不开 | 检查防火墙是否放行对应端口 |