Skip to main content

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.

Hugging Face v2 Turbo License

✨ 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


Made with ❤️ for the Vietnamese TTS community

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vieneu-2.0.1.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vieneu-2.0.1-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

Details for the file vieneu-2.0.1.tar.gz.

File metadata

  • Download URL: vieneu-2.0.1.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

Hashes for vieneu-2.0.1.tar.gz
Algorithm Hash digest
SHA256 5292b4c1be651bfc9b7110dce1d4b4708bfc1b2d5f280d9c8f9e54176f892b74
MD5 32f0ba47eb3e08cdfabbf6a1dd14e424
BLAKE2b-256 bd0e45159a42036a3a41efbc9bc61a3f9da8f01461efd543db59522a236cc7ed

See more details on using hashes here.

File details

Details for the file vieneu-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: vieneu-2.0.1-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

Hashes for vieneu-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 229ea272da07a6e757c962fc2efe24b6ed3dc15e9c191ee1220843d16c0bcec2
MD5 3ed075ab84d9e26e6ce6096204e0ccd5
BLAKE2b-256 383dd30aefd8855dc423620f790f63574498668537b285b57f57c515bb2e7d0c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page