voxtral-tts-q4-gguf

TrevorJS/voxtral-tts-q4-gguf

voxtral-tts-q4-gguf is a text-to-speech model from TrevorJS. Use it when you need text read aloud. The card lists the license as apache-2.0.

Q40 quantized weights for Voxtral 4B TTS in GGUF format. For use with voxtral-mini-realtime-rs.

Downloads · 30 days

378

8% of all-time downloads

All-time downloads

Public

Repo size

5.8 GB

Likes

Public

Hugging Face

Repo makeup

Click a slice to open those files.

Other2.9 GB · 50%

At a glance

Task: Text-to-Speech
License: apache-2.0
Access: Public
Created: Mar 28, 2026
Updated: Mar 28, 2026
SHA: e5bc2315

Base models

mistralai/Voxtral-4B-TTS-2603

Spaces

Model card

From the Hugging Face model README

Voxtral TTS Q4 GGUF

Q4_0 quantized weights for Voxtral 4B TTS in GGUF format. For use with voxtral-mini-realtime-rs.

Try the browser demo — runs entirely client-side via WASM + WebGPU.

Files

File	Size	Description
`voxtral-tts-q4.gguf`	2.67 GB	Full Q4 model (single file, for native use)
`shard-{aa..af}`	6 × ≤512 MB	Sharded for browser (WASM ArrayBuffer limit)
`voice_embedding/*.safetensors`	~50-200 KB each	20 voice presets across 9 languages
`tekken.json`	14.9 MB	Tekken BPE tokenizer

Model Details

Base model: mistralai/Voxtral-4B-TTS-2603
Quantization: Q4_0 (4-bit, 18 bytes per 32 elements)
File size: 2.67 GB (vs ~8 GB BF16 original)
Format: GGUF v3 (381 tensors)
Inference: Burn ML framework with custom WGSL compute shaders

What is Quantized

Component	Quantization
Backbone (Ministral 3B, 26 layers) — attention + FFN	Q4_0
Flow-matching transformer (3 layers) — attention + FFN + projections	Q4_0
Token embeddings [131072, 3072]	Q4_0
Semantic codebook output [8320, 3072]	Q4_0
Codec decoder (8 transformer + 5 conv layers)	F32
RMSNorm, LayerScale, QK-norm, small projections	F32
Audio codebook embeddings [9088, 3072]	F32

Codec weights stored as F32 with pre-fused weight normalization.

Benchmarks

NVIDIA DGX Spark (GB10, LPDDR5x), "The quick brown fox jumps over the lazy dog":

Euler Steps	RTF	Quality (Whisper large-v3)
8 (default)	1.61x	Perfect
4	1.24x	Perfect
3	~1.0x (real-time)	Perfect

Optimizations: batched CFG, fused QKV+gate/up projections, pre-allocated KV cache.

Usage

Native CLI

# Download
uv run --with huggingface_hub \
  hf download TrevorJS/voxtral-tts-q4-gguf voxtral-tts-q4.gguf --local-dir models

# Synthesize (unified voxtral CLI)
cargo run --release --features "wgpu,cli,hub" --bin voxtral -- \
  speak --text "Hello world" --voice casual_female --gguf models/voxtral-tts-q4.gguf

# Real-time with 3 Euler steps
cargo run --release --features "wgpu,cli,hub" --bin voxtral -- \
  speak --text "Hello world" --gguf models/voxtral-tts-q4.gguf --euler-steps 3

# List voices
cargo run --release --features "wgpu,cli,hub" --bin voxtral -- speak --list-voices

Browser (WASM + WebGPU)

Shards are pre-split for browser loading. The TTS demo loads them automatically.

For local dev:

wasm-pack build --target web --no-default-features --features wasm
bun serve.mjs  # serves shards from models/voxtral-tts-q4-shards/

Available Voices

20 presets across 9 languages:

Voice	Language
casual_female, casual_male	English
neutral_female, neutral_male	English
cheerful_female	English
fr_female, fr_male	French
de_female, de_male	German
es_female, es_male	Spanish
it_female, it_male	Italian
pt_female, pt_male	Portuguese
nl_female, nl_male	Dutch
hi_female, hi_male	Hindi
ar_male	Arabic

Quantization Script

uv run --with safetensors --with torch --with numpy --with packaging \
  scripts/quantize_tts_gguf.py models/voxtral-tts/ -o voxtral-tts-q4.gguf

Source: scripts/quantize_tts_gguf.py

Code: TrevorS/voxtral-mini-realtime-rs
ASR Model: TrevorJS/voxtral-mini-realtime-gguf
ASR Demo: TrevorJS/voxtral-mini-realtime
TTS Demo: TrevorJS/voxtral-4b-tts

Task: Text-to-Speech
License: apache-2.0
Languages: en, fr, de, es, pt, ar
Created: Mar 28, 2026
Updated: Mar 28, 2026