MCPcopy
hub / github.com/rsxdalv/TTS-WebUI

github.com/rsxdalv/TTS-WebUI @v1.5.1 sqlite

repository ↗ · DeepWiki ↗ · release v1.5.1 ↗
1,379 symbols 3,713 edges 341 files 265 documented · 19%
README

TTS WebUI

[Download Installer](https://github.com/rsxdalv/TTS-WebUI/releases/download/v0.0.0/tts-webui-installer.zip) || [Installation](#installation) || [Docker Setup](#docker-setup) || [Silly Tavern](#integrations) || [Extensions](#extensions) || [Feedback / Bug reports](https://forms.gle/2L62owhBsGFzdFBC8)

banner

GitHub stars GitHub Discord Open In Colab GitHub forks YouTube

Videos

Watch the video Watch the video Watch the video

Examples

Screenshots

react_1 react_2 react_3
gradio_1 gradio_2 gradio_3

Supported Models

Text-to-speech Audio/Music Generation Audio Conversion/Tools
Bark MusicGen RVC
Tortoise MAGNeT Demucs
Maha TTS Stable Audio Vocos
MMS Riffusion* Whisper
Vall-E X AudioCraft Mac* AP BWE
StyleTTS2 AudioCraft Plus* Resemble Enhance
SeamlessM4T ACE-Step* Audio Separator
XTTSv2* Song Bloom* PyRNNoise*
MARS5* MiMo Audio*
F5-TTS*
Parler TTS*
OpenVoice*
OpenVoice V2*
Kokoro TTS*
DIA*
CosyVoice*
GPT-SoVITS*
Piper TTS*
Kimi Audio 7B Instruct*
Chatterbox*
VibeVoice*
Kitten TTS*
Index-TTS2*
VoxCPM*
FireRedTTS2*
MegaTTS3*
MiniMax Cloud TTS (built-in)

* These models are not installed by default, instead they are available as extensions.

Installation

Using TTS WebUI Ignition (Recommended)

TTS WebUI Ignition is the new installer and launcher for TTS WebUI.

On Windows:

winget install TTS-WebUI.Ignition

For other platforms, download the latest release from the releases page or build it from source using the instructions in the repository.

Using the Installer (Legacy)

Current base installation size is around 10.7 GB. Each model will require 2-8 GB of space in addition.

  • Download the latest version and extract it.
  • Run start_tts_webui.bat or start_tts_webui.sh to start the server. It will ask you to select the GPU/Chip you are using. Once everything has installed, it will start the Gradio server at http://localhost:7770 and the React UI at http://localhost:3000.
  • Output log will be available in the installer_scripts/output.log file.
  • Note: The start script sets up a conda environment and a python virtual environment. Thus you don't need to make a venv before that, and in fact, launching from another venv might break this script.

Manual installation

Prerequisites: * git * Python 3.10 or 3.11 (3.12 not supported yet) * PyTorch * ffmpeg (with vorbis support) * (Optional) NodeJS 22.9.0 for React UI * SQLite (bundled with Python) for database support

  1. Clone the repository: bash git clone https://github.com/rsxdalv/tts-webui.git cd tts-webui
  2. Install required packages: bash pip install -r requirements.txt

  3. Run the server: bash python server.py --no-react

  4. For React UI: bash cd react-ui npm install npm run build cd .. python server.py

For detailed manual installation instructions, please refer to the Manual Installation Guide.

Docker Setup

tts-webui can also be ran inside of a Docker container. Using CUDA inside of docker requires NVIDIA Container Toolkit. To get started, pull the image from GitHub Container Registry:

docker pull ghcr.io/rsxdalv/tts-webui:main

Once the image has been pulled it can be started with Docker Compose: The ports are 7770 (env:TTS_PORT) for the Gradio backend and 3000 (env:UI_PORT) for the React front end.

docker compose up -d

The container will take some time to generate the first output while models are downloaded in the background. The status of this download can be verified by checking the container logs:

docker logs tts-webui

Building the image yourself

If you wish to build your own docker container, you can use the included Dockerfile:

docker build -t tts-webui .

Please note that the docker-compose needs to be edited to use the image you just built.

Changelog

May: * Add virtual environment system (uv), preventing extension conflicts.

April: * Add torchcodec CPU to requirements * Upgrade PyTorch to 2.11.0 * Update pin TorchAudio

Extension points exported contracts — how you extend this code

GenerationRaw (Interface)
(no doc)
react-ui/src/types/Generation.tsx
TortoiseMeta (Interface)
(no doc)
react-ui/src/types/Generation.tsx
NPZOptional (Interface)
(no doc)
react-ui/src/types/NPZ.ts
NPZ (Interface)
(no doc)
react-ui/src/types/NPZ.ts
Payload (Interface)
(no doc)
react-ui/src/types/gradio-client-dist-types.d.ts

Core symbols most depended-on inside this repo

get
called by 152
tts_webui/database/models.py
join
called by 105
tts_webui/decorators/decorator_interrupt.py
cn
called by 89
react-ui/src/lib/utils.ts
displayMessage
called by 60
installer_scripts/js/displayMessage.js
execute_query
called by 41
tts_webui/database/connection.py
useLocalStorage
called by 35
react-ui/src/hooks/useLocalStorage.ts
fn
called by 29
tts_webui/utils/pip_install.py
request
called by 27
react-ui/src/lib/databaseApi.ts

Shape

Function 1,035
Method 212
Class 53
Route 44
Interface 35

Languages

Python53%
TypeScript47%

Modules by API surface

tts_webui/database/api_server.py72 symbols
react-ui/src/lib/databaseApi.ts43 symbols
tts_webui/database/models.py42 symbols
tests/test_minimax_cloud_tts.py36 symbols
react-ui/src/pages/api/gradio/[name].tsx30 symbols
tests/test_extensions_data_loader.py29 symbols
react-ui/src/components/CardBig.tsx29 symbols
installer_scripts/js/initializeApp.js25 symbols
tests/test_decorators.py23 symbols
tests/test_utils.py22 symbols
react-ui/src/pages/tools/_api_config.tsx21 symbols
tts_webui/gradio_proxy_tree/proxy_tree.py20 symbols

Dependencies from manifests, versioned

@emotion/css11.10.8 · 1×
@emotion/react11.10.8 · 1×
@emotion/styled11.10.8 · 1×
@gradio/client1.19.1 · 1×
@material-design-icons/svg0.14.7 · 1×
@radix-ui/react-accordion1.2.10 · 1×
@radix-ui/react-collapsible1.1.0 · 1×
@radix-ui/react-dialog1.1.1 · 1×
@radix-ui/react-icons1.3.2 · 1×
@radix-ui/react-label2.1.0 · 1×
@radix-ui/react-popover1.1.1 · 1×
@radix-ui/react-progress1.1.0 · 1×

For agents

$ claude mcp add TTS-WebUI \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact