vi_voice

Piper Voices Repository (Vietnamese)

Kho giọng nói (voice models) cho Piper TTS ở định dạng .onnx và .onnx.json.

Contents

• voices/ : các model theo ngôn ngữ / giọng
• index.json : danh mục voice để app tải và hiển thị
• (optional) samples/ : file wav/mp3 demo (nếu có)

Voice format

Mỗi voice gồm 2 file:

• *.onnx (model)
• *.onnx.json (config)

Config thường có các trường:

• audio.sample_rate
• phoneme_type = "espeak"
• espeak.voice (ví dụ vi)
• piper_version

Download

File được phục vụ qua Hugging Face resolve/main.

Ví dụ:

• Model: .../resolve/main/voices/vi/vietthao3886.onnx
• Config: .../resolve/main/voices/vi/vietthao3886.onnx.json

App nên tải index.json trước:

• .../resolve/main/index.json

Index schema

index.json chứa:

• schema_version
• engine
• base_url
• danh sách voices[] với:
  • id, name, language, sample_rate
  • đường dẫn file onnx/json
  • size_bytes + sha256 để verify

Versioning strategy (recommended)

• Không sửa trực tiếp file voice cũ (để tránh phá cache người dùng).
• Khi update voice: tạo voice id mới (hoặc thêm suffix _v2).
• App có thể dùng sha256 để phát hiện update.

Notes

• Một số voice yêu cầu phonemizer eSpeak (phoneme_type=espeak). Khi chạy Piper, cần môi trường có eSpeak (thường đã có trong Docker/binary builds).