Downloads · 30 days
0
matcha-zh-tw-en-8k
Luigi/matcha-zh-tw-en-8k
matcha-zh-tw-en-8k is a text-to-speech model from Luigi. Use it when you need text read aloud. The card lists the license as mit.
A Taiwan-Mandarin reading variant of Luigi/matcha-zh-en-8k (itself an 8 kHz-distilled csukuangfj/matcha-icefall-zh-en). Only the lexicon differs — Taiwan reading choices replace the Mainland ones, so the model says
Access
Public
Updated Jun 14, 2026
Repo size
120 MB
Likes
0
Public
Repo makeup
Click a slice to open those files.
.onnx106 MB · 84%
At a glance
- Task
- Text-to-Speech
- License
- mit
- Access
- Public
- Created
- Jun 14, 2026
- Updated
- Jun 14, 2026
- SHA
- 1236f7e6
Base models
Model card
From the Hugging Face model README
matcha-zh-tw-en-8k — Taiwan-readings zh/en TTS @ 8 kHz
A Taiwan-Mandarin reading variant of Luigi/matcha-zh-en-8k
(itself an 8 kHz-distilled csukuangfj/matcha-icefall-zh-en).
Only the lexicon differs — Taiwan reading choices replace the Mainland ones, so the model says
the right syllables for Taiwan: 垃圾 lèsè (not lājī), 期 qí, 究 jiù, 質 zhí, 危 wéi,
企 qì, 攜 xī, 暫 zhàn, 知識 zhī shì, 法國 fà guó. English and zh/en code-mixing are
unchanged (good). Drop-in for the stock sherpa-onnx-offline-tts.
Scope (be precise): this fixes the readings/word-choice layer (字音), the most jarring "Mainland tell." The accent/腔調 (retroflex, prosody) is still the base model's Mainland Putonghua — a separate acoustic-training effort. For many telephony uses, correct Taiwan readings in a neutral accent is already a clear improvement.
Listen (8 kHz, stock sherpa-onnx)
| text | 8 kHz | through G.711 |
|---|---|---|
| 您好,這個星期的研究進度,請您過目一下。 | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_1_8k.wav"></audio> | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_1_8k_g711.wav"></audio> |
| 記得攜帶證件,這是基本常識,謝謝您的配合。 | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_2_8k.wav"></audio> | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_2_8k_g711.wav"></audio> |
| 幫您轉接給 Kevin 陳經理,他的分機是二一八。 | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_3_8k.wav"></audio> | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_3_8k_g711.wav"></audio> |
| 這款 iPhone 支援 Wi-Fi,品質非常好,目前很受歡迎。 | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_4_8k.wav"></audio> | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_4_8k_g711.wav"></audio> |
| 包括法國在內,很多企業都在做數位轉型。 | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_5_8k.wav"></audio> | <audio controls src="https://huggingface.co/Luigi/matcha-zh-tw-en-8k/resolve/main/samples/sample_5_8k_g711.wav"></audio> |
CN-vs-TW reading A/B: Luigi/zh-en-tts-8k-comparison (Section A).
Usage — stock sherpa-onnx (drop-in)
sherpa-onnx-offline-tts \
--matcha-acoustic-model=matcha-zh-tw-en-8k/model-steps-3.onnx \
--matcha-vocoder=matcha-zh-tw-en-8k/vocos-8khz-univ.onnx \
--matcha-lexicon=matcha-zh-tw-en-8k/lexicon.txt \
--matcha-tokens=matcha-zh-tw-en-8k/tokens.txt \
--matcha-data-dir=matcha-zh-tw-en-8k/espeak-ng-data \
--tts-rule-fsts=matcha-zh-tw-en-8k/date-zh.fst,matcha-zh-tw-en-8k/number-zh.fst,matcha-zh-tw-en-8k/phone-zh.fst \
--num-threads=4 --output-filename=out.wav \
"這個星期的垃圾分類研究,包括很多企業。"
8 kHz mono. Same acoustic model + vocoder + RTF as matcha-zh-en-8k (full-pipeline host 4-thread
RTF ~0.014 → predicted Jetson Nano A57 ~0.18). See DEVICE_ACCEPTANCE.md.
What changed vs matcha-zh-en-8k
lexicon.txt only: 14 systematic single-char overrides + 332 propagated word entries + 9 whole-word
overrides (Taiwan readings). Acoustic model, vocoder, tokens, FSTs, espeak data: identical.
Override tables + script: https://github.com/vieenrose/jetson-tts (data/tw_readings/, scripts/apply_tw_lexicon.py).
Attribution
Base: csukuangfj/matcha-icefall-zh-en, 8k-distilled in [Luigi/matcha-zh-en-8k]. Runtime: k2-fsa/sherpa-onnx (Apache-2.0).
- Task
- Text-to-Speech
- License
- mit
- Languages
- zh, en
- Created
- Jun 14, 2026
- Updated
- Jun 14, 2026