Skip to main content

Installation

Prerequisites​

  • Python 3.10+
  • eSpeak NG — Required for phonemization

Install eSpeak NG​

# macOS
brew install espeak

# Ubuntu/Debian
sudo apt install espeak-ng

# Fedora/Amazon Linux
sudo dnf install espeak

# Windows
# Download .msi from https://github.com/espeak-ng/espeak-ng/releases

Optional: NVIDIA GPU​

For maximum speed via LMDeploy or GGUF GPU acceleration:

git clone https://github.com/pnnbao97/VieNeu-TTS.git
cd VieNeu-TTS

GPU Support (Default)​

uv sync

CPU-Only (Lightweight)​

# Linux/macOS
cp pyproject.toml pyproject.toml.gpu
cp pyproject.toml.cpu pyproject.toml
uv sync

Install as Python Package​

# Windows (CPU optimized)
pip install vieneu --extra-index-url https://pnnbao97.github.io/llama-cpp-python-v0.3.16/cpu/

# macOS (Metal GPU accelerated)
pip install vieneu --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/metal/

# Linux / Generic
pip install vieneu

Verify Installation​

from vieneu import Vieneu

tts = Vieneu()
audio = tts.infer(text="Xin chào")
tts.save(audio, "test.wav")
print("Installation successful!")