1. 缺少依赖
ChatTTS-UI 需要 Python 及相关依赖,检查是否已安装:
python -m pip install -r requirements.txt
如果你是 Windows 用户,建议先安装 vc_redist.x64.exe
(Visual C++ 运行库)。
—
2. Python 版本不兼容
有些 ChatTTS-UI 版本需要 Python 3.10 或 3.11,检查你的 Python 版本:
python --version
如果不是 3.10/3.11,可以使用 pyenv
或 conda
创建一个兼容的 Python 版本:
conda create -n chattts python=3.10
conda activate chattts
—
3. 端口被占用
ChatTTS-UI 可能默认监听 5000
端口,可以手动改端口:
python app.py --port 7860
或者检查端口占用:
netstat -ano | findstr :5000
如果有其他进程占用,先终止进程再尝试运行。
—
4. 未正确安装 PyTorch + CUDA
如果你的 GPU 运行环境有问题,导致 torch
不能正确加载,ChatTTS 可能会直接崩溃。
可以尝试运行:
python -c "import torch; print(torch.__version__, torch.cuda.is_available())"
如果 torch.cuda.is_available()
返回 False
,尝试重新安装 GPU 兼容的 PyTorch:
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
或者改为 CPU 运行:
python app.py --device cpu
—
5. 日志排查
ChatTTS-UI 可能会有日志文件,可以查看 logs/
或 stdout
输出:
python app.py --debug
如果运行 python app.py
后没有任何输出,尝试加 --verbose
选项:
python app.py --verbose
—
其他排查方式:
- 确保显卡驱动、CUDA 版本与 PyTorch 兼容。
- 试试
git pull
更新 ChatTTS-UI 到最新版本:
git pull origin main
- 在 Windows 下,可以试试用
cmd
而不是 PowerShell
运行,或者改用 bash
。