Advanced on-device Vietnamese TTS with instant voice cloning
Project description
🦜 VieNeu-TTS
VieNeu-TTS is an advanced on-device Vietnamese Text-to-Speech (TTS) model with instant voice cloning and English-Vietnamese bilingual support.
✨ Key Features
- Bilingual (English-Vietnamese): Seamless transitions between languages (Code-switching) in version 2.0+.
- Ultra-Fast Turbo Mode: Optimized for CPU/Mobile using GGUF and ONNX. No dedicated GPU required!
- Instant Voice Cloning: Clone any voice with just 3-5s of reference audio (GPU mode).
- Production Ready: High-fidelity 24 kHz audio generation, fully offline.
- AI Identification: Built-in audio watermarking for responsible AI use.
📦 Quick Install
# Minimal installation (Turbo/CPU Only)
pip install vieneu
# Optional: Pre-built llama-cpp-python for CPU (if building fails)
pip install vieneu --extra-index-url https://pnnbao97.github.io/llama-cpp-python-v0.3.16/cpu/
# Optional: macOS Metal acceleration
pip install vieneu --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/metal/
🚀 Quick Start (Python SDK)
The SDK now defaults to Turbo mode for maximum out-of-the-box compatibility.
from vieneu import Vieneu
# Initialize - Minimal dependencies required!
tts = Vieneu()
# Synthesis with Bilingual support (Vietnamese + English)
text = "Trước đây, hệ thống điện chủ yếu sử dụng direct current, nhưng Tesla đã chứng minh rằng alternating current is more efficient."
audio = tts.infer(text=text)
# Save output
tts.save(audio, "output.wav")
print("💾 Saved synthesis to output.wav")
Advanced Usage (Remote API)
Connect to a remote VieNeu-TTS server without loading heavy models locally:
tts = Vieneu(mode='remote', api_base='http://your-server:23333/v1')
audio = tts.infer(text="Xin chào!")
🔬 Model Overview
| Model | Format | Device | Bilingual | Cloning | Speed |
|---|---|---|---|---|---|
| VieNeu-v2-Turbo | GGUF/ONNX | CPU/GPU | ✅ | ❌ (Ssoon) | Extreme |
| VieNeu-TTS-v2 | PyTorch | GPU | ✅ | ✅ | Standard (Ssoon) |
| VieNeu-TTS 0.3B | PyTorch | GPU/CPU | ❌ | ✅ | Very Fast |
| VieNeu-TTS | PyTorch | GPU/CPU | ❌ | ✅ | Standard |
🤝 Support & Links
- GitHub: pnnbao97/VieNeu-TTS
- Hugging Face: pnnbao-ump
- Discord: Join our community
Made with ❤️ for the Vietnamese TTS community
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vieneu-2.0.2.tar.gz.
File metadata
- Download URL: vieneu-2.0.2.tar.gz
- Upload date:
- Size: 1.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3cbe7b0e74e26d0339a0f0c4db724a6775ca0a0f1ad53675633b2f45fc430806
|
|
| MD5 |
525ded43e5437a0a706df99d9a59ea4a
|
|
| BLAKE2b-256 |
f6580713429c25da2d2357a0882db017616681f7576dd0cdab84fe19ac9b62e7
|
File details
Details for the file vieneu-2.0.2-py3-none-any.whl.
File metadata
- Download URL: vieneu-2.0.2-py3-none-any.whl
- Upload date:
- Size: 1.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
412e0ef5d8ff999b4a4b89c6cc594ef19591198e5bdfbf8d25817928ad25b690
|
|
| MD5 |
e625f26a7f4b081303b4844b90eddc11
|
|
| BLAKE2b-256 |
e2dd2be969056b3ffc77a709ad34edac8bfe8312f8811e2469fc7e56fd132387
|