HiggsTTS.cpp

ggml port of bosonai/higgs-tts-3-4b.

See LICENSE-HIGGS.

Build

Personally I recommend Vulkan — it's fast and supports all platforms. CUDA and HIP work too.

# Vulkan (recommended)
cmake -B build-vk -DGGML_VULKAN=ON
cmake --build build-vk --config Release -j

# CUDA
cmake -B build-cu -DGGML_CUDA=ON
cmake --build build-cu --config Release -j

# HIP (AMD)
cmake -B build-hip -DGGML_HIP=ON -DHIP_PLATFORM=amd
cmake --build build-hip --config Release -j

Model

Download GGUF from NeemaShioSe/HiggsTTS3.gguf.

or you can convert the model yourself, see here

Usage

# CLI: WAV → WAV
higgs_cli --model higgs-v3-tts.gguf --ref-wav ref.wav --text "Hello world" --out out.wav

# CLI with emotion tags (optional, requires tokenizer.json)
higgs_cli --model higgs-v3-tts.gguf --ref-wav ref.wav --text "Hello world" --tokenizer tokenizer.json --out out.wav

# Simple TCP server: accepts text + temperature → returns float32 PCM
higgs_server --model higgs-v3-tts.gguf --ref-wav ref.wav --ref-text "reference transcript" --port 9989

# Server with emotion tags (optional, requires tokenizer.json)
higgs_server --model higgs-v3-tts.gguf --ref-wav ref.wav --ref-text "reference transcript" --tokenizer tokenizer.json --port 9989

--tokenizer is optional. It enables recognition of special emotion / style / prosody tags (e.g. <|style:whispering|>) when they appear in the prompt text. Without it, the model falls back to the built-in GGUF BPE tokenizer.

GUI

PyQt GUI (Python + TCP server)

A simple PyQt6 GUI that connects to higgs_server over TCP: python_gui/simple_tts_gui.py.

pip install pyqt6 numpy sounddevice
# Start the server first, then launch the GUI
python python_gui/simple_tts_gui.py

Configure model paths in Model Config, launch the server from the GUI, then type text and click Synthesize.

Windows GUI (WPF + C# bindings)

A native WPF GUI with direct C ABI bindings is provided in CSharpBinding/. Runs local inference — no server needed.

# Build the native DLL
cmake --build build --target higgs_tts --config Release

# Build the .NET GUI
dotnet build CSharpBinding/HiggsTTS.net/HiggsTTSGUI/HiggsTTSGUI.csproj -c Release

Copy higgs_tts.dll and its dependencies (e.g. ggml.dll, ggml-cpu.dll, ggml-vulkan.dll) from build/bin/ to the GUI output directory before running.

The Tag dropdown gives quick access to all emotion / style / prosody tokens. Built-in audio player supports play / pause / seek.

Special Token Reference

See PROMPTING.md for full details.

Category	Examples
Emotion (21)	emotion:elation emotion:anger emotion:sadness emotion:fear ...
Style (3)	style:singing style:shouting style:whispering
SFX (9)	sfx:laughter sfx:cough sfx:sigh sfx:sneeze ...
Prosody (10)	prosody:speed_slow prosody:pitch_high prosody:pause ...

Tags are used as <|category:name|> in the prompt, e.g. <|emotion:elation|> Hello world!

Prepend a tag to your text to control delivery: <|emotion:elation|> Hello world!