Instructions to use Inigomf/chatterbox-multilingual-meanflow-streaming with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Chatterbox
How to use Inigomf/chatterbox-multilingual-meanflow-streaming with Chatterbox:
# pip install chatterbox-tts import torchaudio as ta from chatterbox.tts import ChatterboxTTS model = ChatterboxTTS.from_pretrained(device="cuda") text = "Ezreal and Jinx teamed up with Ahri, Yasuo, and Teemo to take down the enemy's Nexus in an epic late-game pentakill." wav = model.generate(text) ta.save("test-1.wav", wav, model.sr) # If you want to synthesize with a different voice, specify the audio prompt AUDIO_PROMPT_PATH="YOUR_FILE.wav" wav = model.generate(text, audio_prompt_path=AUDIO_PROMPT_PATH) ta.save("test-2.wav", wav, model.sr) - Notebooks
- Google Colab
- Kaggle
Chatterbox Multilingual MeanFlow Streaming (experimental)
Private experimental package combining Chatterbox's Spanish-specialized T3 text-to-speech token generator with Chatterbox Flash's distilled two-step MeanFlow S3Gen decoder. The package is configured for warm, low-latency inference on an NVIDIA L4.
Tested setting
- First decode at four speech tokens (40 ms playable audio).
- Two MeanFlow steps.
- Three look-ahead tokens, one duplicated boundary token, 40 ms crossfade.
- Preferred two-step configuration measured 172.21 ms p95 to its first 40 ms of playable audio in the controlled L4 test.
- The full 4.4-second streamed decode ran about 7.0 times faster than playback.
This is experimental, single-request, warm-GPU evidence. Network transport, telephony buffers, cold start, concurrency, WER, speaker similarity, and formal listening quality are not yet validated.
Before/after audio
The voice in every player below is the selected Mateo project voice:
CML-TTS speaker 12367, using the user-selected
ref_04_cml_8860.wav.
All three samples use this same
conditioning audio, Spanish text, and exact T3 speech-token sequence, so the
comparison isolates the decoder change as closely as possible.
1. Before - original Spanish s3gen_v3 decoder
Open or download the original-decoder sample
2. After - two-step MeanFlow, full decode
Open or download the two-step MeanFlow sample
3. After - two-step MeanFlow, streamed and crossfaded
Open or download the final streamed sample
Test sentence: Su reserva está confirmada para el viernes tres a las ocho y media de la tarde. Le enviaremos un recordatorio al móvil el día anterior.
In blind listening, the user described these three preferred-token samples as barely distinguishable. An earlier disliked draw sounded equally poor through the original, full MeanFlow, and streamed decoders; this indicates that T3 sampling/prosody consistency is the remaining quality risk, not the stream joins.
For listening criteria and raw amplitude measurements, see the
audio_comparison guide.
Installation
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python apply_callback_patch.py
Test
Use a clean reference WAV containing one speaker:
python inference_streaming.py \
--voice reference_voice/ref_04_cml_8860.wav \
--language es \
--text "Hola, le llamo para confirmar su cita." \
--output test.wav
For live calling, pass clause-sized text to TTS as it becomes available. Supplying an entire paragraph increases T3 prefill and can push first audio above 200 ms.
Reference voice provenance
The included Mateo reference is an excerpt associated with CML-TTS speaker
12367, selected by the user from the Mateo_TTS project's
Castilian-Spanish references. CML-TTS is LibriVox-derived and is
distributed under CC BY 4.0; this excerpt has been selected and processed for
voice conditioning. Attribution: CML-TTS contributors and the source LibriVox
recording. Do not use this package to identify the original narrator.
Files
t3_es_es.safetensors: Spanish-specialized T3 weights.s3gen_meanflow.safetensors: distilled Flash MeanFlow decoder weights.ve.pt: voice encoder.grapheme_mtl_merged_expanded_v1.json: multilingual tokenizer vocabulary.config.json: tested streaming and sampling settings.inference_streaming.py: integrated callback, streaming decode, and crossfade.apply_callback_patch.py: minimal callback installer for the pinned source revision.
Based on Resemble AI's Chatterbox and Chatterbox Flash repositories. Preserve and review upstream licensing and model-card requirements before redistribution or production use.
- Downloads last month
- -