ChatTTS Deployment Guide

Windows Pre-packaged Version
- Download the compressed package from Releases, extract it, and double-click
app.exeto use it.
Source Code Deployment on Linux
Set up a Python 3.9+ environment.
Create an empty directory
/data/chatttsand execute the command:cd /data/chattts && git clone https://github.com/jianchang512/chatTTS-ui .Create a virtual environment:
python3 -m venv venvActivate the virtual environment:
source ./venv/bin/activateInstall dependencies:
pip3 install -r requirements.txtIf CUDA acceleration is not needed, execute:
pip3 install torch torchaudioIf CUDA acceleration is needed, execute:
pip install torch torchaudio --index-url https://download.pytorch.org/whl/cu118 pip install nvidia-cublas-cu11 nvidia-cudnn-cu11Additionally, install the CUDA 11.8 Toolkit. Please search for the installation method yourself.
Execute
python3 app.pyto start. It will automatically open a browser window at the default addresshttp://127.0.0.1:9966.
Source Code Deployment on macOS
- Set up a Python 3.9+ environment and install Git. Execute the command:
brew install git [email protected]Then continue with:export PATH="/usr/local/opt/[email protected]/bin:$PATH" source ~/.bash_profile source ~/.zshrc - Create an empty directory
/data/chatttsand execute the command:cd /data/chattts && git clone https://github.com/jianchang512/chatTTS-ui . - Create a virtual environment:
python3 -m venv venv - Activate the virtual environment:
source ./venv/bin/activate - Install dependencies:
pip3 install -r requirements.txt - Install torch:
pip3 install torch torchaudio - Execute
python3 app.pyto start. It will automatically open a browser window at the default addresshttp://127.0.0.1:9966.
Source Code Deployment on Windows
Download Python 3.9+. During installation, make sure to select
Add Python to environment variables.Download and install Git from: https://github.com/git-for-windows/git/releases/download/v2.45.1.windows.1/Git-2.45.1-64-bit.exe
Create an empty folder
D:/chatttsand navigate into it. Typecmdin the address bar and press Enter. In the opened cmd window, execute the command:git clone https://github.com/jianchang512/chatTTS-ui .Create a virtual environment by executing:
python -m venv venvActivate the virtual environment by executing:
.\venv\scripts\activateInstall dependencies by executing:
pip install -r requirements.txtIf CUDA acceleration is not needed, execute:
pip install torch torchaudioIf CUDA acceleration is needed, execute:
pip install torch torchaudio --index-url https://download.pytorch.org/whl/cu118Additionally, install the CUDA 11.8 Toolkit. Please search for the installation method yourself.
Execute
python app.pyto start. It will automatically open a browser window at the default addresshttp://127.0.0.1:9966.
Common Issues
- Missing
spk_stat.ptafter downloading the model from modelscope
After downloading the model from modelscope, you might encounter the error: AssertionError: Missing spk_stat.pt: **/pzc163/chatTTS/asset/spk_stat.pt
Download spk_stat.pt from https://huggingface.co/2Noise/ChatTTS/blob/main/asset/spk_stat.pt and copy it to the asset directory to resolve the issue.
- If you encounter errors on macOS, please try:
brew install libomp
- If prompted "not support python3.12+"
Please downgrade to Python 3.10.
