Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+VieNeu-TTS-0_3B-Q4_0.gguf filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,3 +1,140 @@
----
-license: apache-2.0
----
+---
+license: cc-by-nc-4.0
+datasets:
+- pnnbao-ump/VieNeu-TTS-1000h
+- pnnbao-ump/VieNeu-TTS-140h
+language:
+- vi
+base_model:
+- pnnbao-ump/VieNeu-TTS-0.3B
+pipeline_tag: text-to-speech
+tags:
+- realtime
+- tts
+- cpu
+- vietnamese
+- gguf
+---
+
+# 🦜 VieNeu-TTS-0.3B-Q4-0-GGUF (CPU Optimized)
+
+[![GitHub](https://img.shields.io/badge/GitHub-Repository-blue)](https://github.com/pnnbao97/VieNeu-TTS)
+[![Base Model](https://img.shields.io/badge/Hugging%20Face-Base%20Model-yellow)](https://huggingface.co/pnnbao-ump/VieNeu-TTS-0.3B)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/yJt8kzjzWZ)
+
+**VieNeu-TTS-0.3B-Q4-0-GGUF** is a **Q4_0** quantized version of [VieNeu-TTS-0.3B](https://huggingface.co/pnnbao-ump/VieNeu-TTS-0.3B). This model is specifically optimized to run directly on the **CPU**, providing extremely fast speech synthesis without the need for a dedicated GPU.
+
+Author: **Phạm Nguyễn Ngọc Bảo**
+
+## ☕ Support This Project
+
+Training high-quality TTS models requires significant GPU resources. If you find this model useful, please consider supporting the development:
+
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-orange?logo=buy-me-a-coffee)](https://buymeacoffee.com/pnnbao)
+
+---
+
+## 🛠️ Requirements (eSpeak NG)
+eSpeak NG is **mandatory** for phonemization.
+- **Windows:** Download `.msi` from [eSpeak NG Releases](https://github.com/espeak-ng/espeak-ng/releases).
+- **macOS:** `brew install espeak`
+- **Linux:** `sudo apt install espeak-ng`
+
+## 🚀 How to Use
+
+Use the source code from GitHub for the best experience with full text preprocessing support:
+
+```bash
+# 1. Clone repository
+git clone https://github.com/pnnbao97/VieNeu-TTS.git
+cd VieNeu-TTS
+
+# 2. Sync environment (requires uv)
+uv sync
+
+# 3. Launch Web UI
+uv run gradio_app.py
+```
+In the UI, select **Backbone**: `VieNeu-TTS-0.3B-q4-gguf` and **Device**: `CPU`.
+
+---
+
+## 📦 Using Python SDK (vieneu)
+
+Install the SDK to integrate VieNeu-TTS-0.3B into your research or applications:
+
+```bash
+# Windows (Avoid llama-cpp build errors)
+pip install vieneu --extra-index-url https://pnnbao97.github.io/llama-cpp-python-v0.3.16/cpu/
+
+# Linux / MacOS
+pip install vieneu
+```
+
+### Full Features Guide
+```python
+from vieneu import Vieneu
+import os
+
+# Initialization
+tts = Vieneu()  # Default: 0.3B-Q4 GGUF for CPU
+os.makedirs("outputs", exist_ok=True)
+
+# 1. List preset voices
+available_voices = tts.list_preset_voices()
+for desc, name in available_voices:
+    print(f"   - {desc} (ID: {name})")
+
+# 2. Use specific voice (dynamically select second voice)
+if available_voices:
+    _, my_voice_id = available_voices[1] if len(available_voices) > 1 else available_voices[0]
+    voice_data = tts.get_preset_voice(my_voice_id)
+    audio_spec = tts.infer(text="Chào bạn, tôi đang nói bằng giọng của bác sĩ Tuyên.", voice=voice_data)
+    tts.save(audio_spec, f"outputs/standard_{my_voice_id}.wav")
+    print(f"💾 Saved synthesis to: outputs/standard_{my_voice_id}.wav")
+
+# 3. Standard synthesis (uses default voice)
+text = "Xin chào, tôi là VieNeu. Tôi có thể giúp bạn đọc sách, làm chatbot thời gian thực, hoặc thậm chí clone giọng nói của bạn."
+audio = tts.infer(text=text)
+tts.save(audio, "outputs/standard_output.wav")
+print("💾 Saved synthesis to: outputs/standard_output.wav")
+
+# 4. Zero-shot voice cloning
+if os.path.exists("examples/audio_ref/example_ngoc_huyen.wav"):
+    cloned_audio = tts.infer(
+        text="Đây là giọng nói đã được clone thành công từ file mẫu.",
+        ref_audio="examples/audio_ref/example_ngoc_huyen.wav",
+        ref_text="Tác phẩm dự thi bảo đảm tính khoa học, tính đảng, tính chiến đấu, tính định hướng."
+    )
+    tts.save(cloned_audio, "outputs/standard_cloned_output.wav")
+    print("💾 Saved cloned voice to: outputs/standard_cloned_output.wav")
+
+# 5. Cleanup
+tts.close()
+```
+
+## 📊 Technical Specifications
+- **Format**: GGUF (Q4_0)
+- **Size**: ~200 MB
+- **Standard Devices**: Office laptops, Mini PCs, and computers without GPUs.
+- **Performance**: Achieves real-time speed even on standard consumer CPUs.
+
+## ⚠️ Licensing & Copyright
+This model is released under the **CC BY-NC 4.0** license.
+- ✅ **Free:** For students, researchers, and non-profit purposes.
+- ⚠️ **Commercial/Enterprise:** Use for businesses or commercial products is strictly prohibited without prior authorization.
+- **Commercial Licensing:** Please contact the author (**Phạm Nguyễn Ngọc Bảo**) for licensing terms (Estimated: **5,000 USD/year** - negotiable).
+
+## 📑 Citation
+```bibtex
+@misc{vieneutts03bgguf2026,
+  title        = {VieNeu-TTS-0.3B-GGUF: CPU-Optimized Vietnamese Text-to-Speech},
+  author       = {Pham Nguyen Ngoc Bao},
+  year         = {2026},
+  publisher    = {Hugging Face},
+  howpublished = {\url{https://huggingface.co/pnnbao-ump/VieNeu-TTS-0.3B-q4-gguf}}
+}
+```
+
+---
+**Made with ❤️ for the Vietnamese TTS community**

VieNeu-TTS-0_3B-Q4_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d9c588db01565a9607fef7dcc3cce517f2e6c2d3e74e4ac8357d9e70de8ed897
+size 202059392

voices.json

@@ -0,0 +1,268 @@
+{
+  "meta": {
+    "spec": "vieneu.voice.presets",
+    "spec_version": "1.0",
+    "engine": "VieNeu-TTS",
+    "author": "Phạm Nguyễn Ngọc Bảo (pnnbao-ump)",
+    "license": "CC BY-NC 4.0",
+    "homepage": "https://github.com/pnnbao97/VieNeu-TTS",
+    "notice": "Model and voices are for non-commercial use only. Mention pnnbao-ump when using."
+  },
+  "default_voice": "voice_nu",
+  "presets": {
+    "voice_nu": {
+      "codes": [
+        58770,
+        45478,
+        41370,
+        45642,
+        30026,
+        25882,
+        25098,
+        53674,
+        57862,
+        53589,
+        53765,
+        55386,
+        2229,
+        55427,
+        49254,
+        57463,
+        5053,
+        22329,
+        12987,
+        13882,
+        52531,
+        21885,
+        302,
+        32837,
+        23500,
+        9262,
+        5132,
+        9389,
+        44245,
+        24422,
+        2471,
+        6759,
+        27571,
+        38059,
+        28532,
+        32500,
+        44920,
+        40557,
+        14746,
+        47643,
+        5151,
+        2068,
+        1336,
+        34089,
+        51670,
+        23273,
+        26798,
+        6365,
+        1691,
+        31207,
+        27111,
+        22311,
+        44774,
+        56758,
+        52691,
+        9244,
+        27412,
+        11394,
+        9510,
+        5282,
+        546,
+        1811,
+        26903,
+        11289,
+        8193,
+        3117,
+        24600,
+        54530,
+        38601,
+        25687,
+        7513,
+        25415,
+        31049,
+        31117,
+        29319,
+        40584,
+        31511,
+        56743,
+        43491,
+        21107,
+        19185,
+        46915,
+        46087,
+        25,
+        57602,
+        4432,
+        61857,
+        51297,
+        59874,
+        53137,
+        52049,
+        1540,
+        18186,
+        33606,
+        35642,
+        653,
+        20750,
+        12356,
+        22233,
+        22390,
+        46835,
+        8777,
+        45848,
+        31096,
+        13109,
+        12724,
+        12712,
+        12869,
+        40163,
+        56546,
+        18609,
+        36054,
+        59470,
+        55646,
+        55402,
+        55459,
+        57414,
+        53595,
+        37004,
+        25163,
+        20763,
+        37213,
+        38427,
+        53725,
+        42519,
+        53645,
+        61959,
+        53702,
+        58506,
+        42070,
+        11674,
+        1138,
+        51365,
+        23967,
+        1844,
+        11148,
+        13144,
+        5826,
+        49139,
+        8519,
+        516,
+        1352,
+        516,
+        4100,
+        120,
+        4373,
+        7859,
+        8220,
+        54823,
+        4597,
+        12406,
+        39671,
+        39862,
+        49122,
+        30342,
+        41829,
+        5749,
+        30527,
+        27314,
+        60327,
+        16430,
+        45,
+        41350,
+        8732,
+        13388,
+        37928,
+        60898,
+        27354,
+        14755,
+        20467,
+        14844,
+        35640,
+        31485,
+        26536,
+        5786,
+        44770,
+        17799,
+        13144,
+        2776,
+        26473,
+        32169,
+        14205,
+        10685,
+        56426,
+        54350,
+        51577,
+        25738,
+        18054,
+        1541,
+        1418,
+        3288,
+        391,
+        2457,
+        22925,
+        4494,
+        7387,
+        40679,
+        39659,
+        43691,
+        56039,
+        56502,
+        60839,
+        2040,
+        26420,
+        15029,
+        36018,
+        52721,
+        10332,
+        32110,
+        6956,
+        40877,
+        47646,
+        15524,
+        32358,
+        64998,
+        47078,
+        23491,
+        12953,
+        17200,
+        29241,
+        12820,
+        14998,
+        28659,
+        28811,
+        51545,
+        51321,
+        52327,
+        56218,
+        36249,
+        23062,
+        36006,
+        19383,
+        35539,
+        42314,
+        39526,
+        17031,
+        33549,
+        38221,
+        1353,
+        21258,
+        10901,
+        8974,
+        2957,
+        35031,
+        55528,
+        58562,
+        45068,
+        52322
+      ],
+      "text": "Thì chọn màu son tươi sáng thì sẽ rất là đẹp Ở đây thì mình chọn màu đỏ cam của cỏ mềm hôn áp",
+      "description": "voice Nu"
+    }
+  }
+}