VieNeu-TTS

![GitHub](https://github.com/pnnbao97/VieNeu-TTS)

![Model](https://huggingface.co/pnnbao-ump/VieNeu-TTS)

Overview

VieNeu-TTS is an advanced on-device Vietnamese Text-to-Speech (TTS) model with instant voice cloning.

Trained on ~1000 hours of high-quality Vietnamese speech, this model represents a significant upgrade from VieNeu-TTS-140h with the following improvements:

Enhanced pronunciation: More accurate and stable Vietnamese pronunciation
Code-switching support: Seamless transitions between Vietnamese and English
Better voice cloning: Higher fidelity and speaker consistency
Real-time synthesis: 24 kHz waveform generation on CPU or GPU

VieNeu-TTS-1000h delivers production-ready speech synthesis fully offline.

Author: Phạm Nguyễn Ngọc Bảo

Support This Project

Training high-quality TTS models requires significant GPU resources and compute time. If you find this model useful, please consider supporting the development:

![Buy Me a Coffee](https://buymeacoffee.com/pnnbao)

Your support helps maintain and improve VieNeu-TTS! 🙏

Voice Cloning Inference

Reference Voice (Speaker Example):

Input Text:

Trên bầu trời xanh thẳm, những đám mây trắng lửng lờ trôi như những chiếc thuyền nhỏ đang lướt nhẹ theo dòng gió. Dưới mặt đất, cánh đồng lúa vàng rực trải dài tới tận chân trời, những bông lúa nghiêng mình theo từng làn gió.

Generated Output (Cloned Voice):

Installation

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

Gradio Demo

uv run gradio_app.py

Open your browser at http://127.0.0.1:7860.

Demo Video:

Reference Voices

|-------------------------|--------|--------|--------------------|

Model Architecture

| Component | Description |

|----------|-------------|

| Backbone | Qwen 0.5B (chat-format LM) |

| Codec | NeuCodec (supports ONNX + quantization) |

| Output | 24 kHz waveform synthesis |

| Context Window | 2048 tokens shared text + speech |

| Watermark | Enabled |

| Training Data | VieNeuCodec-dataset + Emilia dataset pretraining |

Features

High-quality Vietnamese speech
Instant voice cloning (3–5 second reference audio)
Fully offline
Runs real-time or faster
Multi-voice reference support
Python API + CLI + Gradio

Troubleshooting

| Issue | Cause | Solution |

|------|-------|----------|

| Missing libespeak | System dependency | Install eSpeak NG |

| GPU OOM | VRAM too small | Use CPU or quantized model |

| Poor voice match | Bad reference sample | Try a clearer reference clip |

License

Apache 2.0

Citation

@misc{vieneutts2025,
  title        = {VieNeu-TTS: Vietnamese Text-to-Speech with Instant Voice Cloning},
  author       = {Pham Nguyen Ngoc Bao},
  year         = {2025},
  publisher    = {Hugging Face},
  howpublished = {\url{https://huggingface.co/pnnbao-ump/VieNeu-TTS}}
}

Please also cite the base model:

@misc{neuttsair2025,
  title        = {NeuTTS Air: On-Device Speech Language Model with Instant Voice Cloning},
  author       = {Neuphonic},
  year         = {2025},
  publisher    = {Hugging Face},
  howpublished = {\url{https://huggingface.co/neuphonic/neutts-air}}
}

pnnbao-ump/VieNeu-TTS-q4-gguf