Views
No views yet
openai/whisper-large-v3 for Traditional Chinese (zh-TW) / Taiwanese Mandarin ASR. Fine-tuned
with LoRA via Unsloth on the adi-gov-tw/Taiwan-Tongues-ASR-CE-dataset-zhtw dataset, then converted to faster-whisper format for
efficient CPU and GPU inference. Source code: https://github.com/shooding/taiwan-finetunefaster-whisper library, providing
significantly faster inference with lower memory footprint compared to the original PyTorch model.faster-whisper library.language=zh1from faster_whisper import WhisperModel
2
3model = WhisperModel(
4 "shooding/faster-whisper-large-v3-zh-TW",
5 device="cuda",
6 compute_type="float16",
7)
8
9segments, info = model.transcribe("audio.wav", language="zh", task="transcribe")
10for segment in segments:
11 print(f"[{segment.start:.2f}s → {segment.end:.2f}s] {segment.text}")
12
13CPU (int8 quantization):
14
15model = WhisperModel(
16 "shooding/faster-whisper-large-v3-zh-TW",
17 device="cpu",
18 compute_type="int8",
19)
20
21Training Details
22
23Training Data
24
25Dataset: adi-gov-tw/Taiwan-Tongues-ASR-CE-dataset-zhtw
26
27A Taiwanese Mandarin speech corpus from the Taiwanese government, covering diverse speakers and domains. Loaded in streaming mode to
28avoid local disk download.
29
30Training Procedure
31
32Build Pipeline
33
341. Load openai/whisper-large-v3 via unsloth.FastModel — auto-patches the conv1d fp16 type mismatch bug (RuntimeError: Input type
35(float) and bias type (c10::Half))
362. Apply LoRA adapters (r=64, α=64, target modules: q_proj, v_proj)
373. Set generation_config: language=zh, task=transcribe, forced_decoder_ids=None
384. Fine-tune with Seq2SeqTrainer on the streaming dataset
395. Merge LoRA → full model via save_pretrained_merged (merged_16bit)
406. Convert to CTranslate2: ct2-transformers-converter --quantization float16
41
42LoRA Configuration
43
44┌────────────────┬─────────────────────────────┐
45│ Parameter │ Value │
46├────────────────┼─────────────────────────────┤
47│ r │ 64 │
48├────────────────┼─────────────────────────────┤
49│ lora_alpha │ 64 │
50├────────────────┼─────────────────────────────┤
51│ target_modules │ q_proj, v_proj │
52├────────────────┼─────────────────────────────┤
53│ lora_dropout │ 0 │
54├────────────────┼─────────────────────────────┤
55│ bias │ none │
56├────────────────┼─────────────────────────────┤
57│ task_type │ None (required for Whisper) │
58└────────────────┴─────────────────────────────┘
59
60Training Hyperparameters
61
62- Training regime: fp16 mixed precision (T4) / bf16 (A100+)
63
64┌─────────────────────────────┬──────────────────────────┐
65│ Hyperparameter │ Value │
66├─────────────────────────────┼──────────────────────────┤
67│ max_steps │ 2000 │
68├─────────────────────────────┼──────────────────────────┤
69│ per_device_train_batch_size │ 4 │
70├─────────────────────────────┼──────────────────────────┤
71│ gradient_accumulation_steps │ 4 (effective batch = 16) │
72├─────────────────────────────┼──────────────────────────┤
73│ learning_rate │ 1e-4 │
74├─────────────────────────────┼──────────────────────────┤
75│ warmup_steps │ 100 │
76├─────────────────────────────┼──────────────────────────┤
77│ lr_scheduler_type │ cosine │
78├─────────────────────────────┼──────────────────────────┤
79│ optimizer │ adamw_8bit (Unsloth) │
80├─────────────────────────────┼──────────────────────────┤
81│ weight_decay │ 0.001 │
82├─────────────────────────────┼──────────────────────────┤
83│ eval_steps / save_steps │ 200 │
84├─────────────────────────────┼──────────────────────────┤
85│ best model metric │ CER (lower is better) │
86└─────────────────────────────┴──────────────────────────┘
87
88Evaluation
89
90Testing Data, Factors & Metrics
91
92Testing Data
93
94Held-out split of adi-gov-tw/Taiwan-Tongues-ASR-CE-dataset-zhtw (200 samples).
95
96Metrics
97
98CER (Character Error Rate): edit distance between predicted and reference character sequences divided by reference length. Lower is
99better. Chinese has no word boundaries, making CER more appropriate than WER.
100
101Note: Training-time CER is computed via argmax over decoder logits (greedy decoding). Production inference with beam search will
102typically yield lower CER.
103
104Results
105
106The model improves CER on Taiwanese Mandarin compared to the untuned whisper-large-v3 baseline. Exact numbers on a standardized zh-TW
107 benchmark are planned for a future update.
108
109Summary
110
111Improved zh-TW ASR accuracy vs. baseline Whisper large-v3, trainable on a single T4 GPU via LoRA.
112
113Environmental Impact
114
115- Hardware Type: Google Colab T4 GPU (16 GB VRAM)
116- Hours used: ~2–4 hours
117- Cloud Provider: Google (Colab)
118- Compute Region: Not specified
119- Carbon Emitted: Not measured. Use ML CO2 Impact calculator for estimation.
120
121Technical Specifications
122
123Model Architecture and Objective
124
125Whisper large-v3 encoder-decoder transformer (~1.5B parameters). Fine-tuned with cross-entropy on (mel spectrogram, Chinese
126transcript) pairs. LoRA keeps only ~2% of parameters trainable, reducing VRAM by 50%+.
127
128Compute Infrastructure
129
130Hardware
131
132Google Colab T4 GPU (16 GB VRAM). Unsloth's LoRA + adamw_8bit optimizer fit the large-v3 model within T4 budget.
133
134Software
135
136- Unsloth — FastModel, LoRA, gradient checkpointing
137- Transformers 4.56.2
138- TRL 0.22.2
139- CTranslate2 — float16 conversion
140- faster-whisper — inference
141
142Citation
143
144BibTeX:
145
146@misc{shooding2026fasterwhisper_zhtw,
147 author = {shooding},
148 title = {faster-whisper-large-v3-zh-TW: LoRA fine-tune of Whisper large-v3 for Taiwanese Mandarin},
149 year = {2026},
150 howpublished = {\url{https://huggingface.co/shooding/faster-whisper-large-v3-zh-TW}},
151}
152
153Glossary
154
155- CER: Character Error Rate — edit distance / reference length. Standard metric for Chinese ASR.
156- LoRA: Low-Rank Adaptation — trains injected rank-decomposition matrices, leaving base weights frozen.
157- CTranslate2: Fast transformer inference engine supporting quantization and optimized CUDA/CPU kernels.
158- faster-whisper: Whisper reimplemented with CTranslate2; typically 4× faster with lower memory usage.
159
160Model Card Authors
161
162shooding
163
164Model Card Contact
165
166Open an issue on the model repository.