Voxtral-Mini-4B-Realtime-2602-GGUF

Voxtral Mini 4B Realtime 2602

Voxtral Mini 4B Realtime 2602 is a multilingual, realtime speech-transcription model and among the first open-source solutions to achieve accuracy comparable to offline systems with a delay of <500ms. It supports 13 languages and outperforms existing open-source baselines across a range of tasks, making it ideal for applications like voice assistants and live subtitling.

Built with a natively streaming architecture and a custom causal audio encoder - it allows configurable transcription delays (240ms to 2.4s), enabling users to balance latency and accuracy based on their needs. At a 480ms delay, it matches the performance of leading offline open-source transcription models, as well as realtime APIs.

As a 4B-parameter model, is optimized for on-device deployment, requiring minimal hardware resources. It runs in realtime with on devices minimal hardware with throughput exceeding 12.5 tokens/second.

This model is released in BF16 under the Apache-2 license, ensuring flexibility for both research and commercial use.

For more details, see our:

• Blog post
• Demo
• Technical report
• vLLM's blog on streaming input

Key Features

Voxtral Mini 4B Realtime consists of two main architectural components:

• ≈3.4B Language Model
• ≈970M Audio Encoder
• The audio encoder was trained from scratch with causal attention enabling streaming capability
• Both the audio encoder as well as the LLM backbone use sliding window attention allowing for "infinite" streaming
• For more details, refer to the technical report

The Voxtral Mini 4B Realtime model offers the following capabilities:

• High-Quality Transcription: Transcribe audio to text with confidence.
• Multilingual: Supports dozens of languages, making it perfect for multilingual transcription tasks.
• Real-Time: Fast streaming ASR model, enabling real-time transcription use cases.
• Configurable Transcription Delays: Customize the transcription delay to balance quality and latency, from 80ms to 2.4s.

Use Cases

Real-Time Transcription Purposes:

• Private meeting transcriptions
• Live subtitle creation
• Real-time assistants with speech understanding
• And more

Bringing real-time transcription capabilities to all.

Recommended Settings

We recommend deploying with the following best practices:

• Always set the temperature to 0.0
• A single text-token is worth 80ms. Hence, make sure to set your --max-model-len accordingly. To live-record a 1h meeting, you need to set --max-model-len >= 3600 / 0.8 = 45000. In theory, you should be able to record with no limit; in practice, pre-allocations of RoPE parameters among other things limits --max-model-len. For the best user experience, we recommend to simply instantiate vLLM with the default parameters which will automatically set a maximum model length of 131072 (~ca. 3h).
• We strongly recommend using websockets to set up audio streaming sessions. For more info on how to do so, check Usage.
• We recommend using a delay of 480ms as we found it to be the sweet spot of performance and low latency. If, however, you want to adapt the delay, you can change the "transcription_delay_ms": 480 parameter in the tekken.json file to any multiple of 80ms between 80 and 1200, as well as 2400 as a standalone value.

Benchmark Results

We compare Voxtral Mini 4B Realtime to similar models - both offline models and realtime. Voxtral Mini 4B Realtime is competitive to leading offline models and shows significant gains over existing open-source realtime solutions.

Fleurs

Long-form English

Short-form English

Usage

The model can also be deployed with the following libraries:

• vllm (recommended): See here

• transformers: See here

• executorch (untested): See here

• Community Contributions: See here

vLLM (recommended)

[!Tip] We've worked hand-in-hand with the vLLM team to have production-grade support for Voxtral Mini 4B Realtime 2602 with vLLM. Special thanks goes out to Joshua Deng, Yu Luo, Chen Zhang, Nick Hill, Nicolò Lucchesi, Roger Wang, and Cyrus Leung for the amazing work and help on building a production-ready audio streaming and realtime system in vLLM.

[!Warning] Due to its novel architecture, Voxtral Realtime is currently only support in vLLM. We very much welcome community contributions to add the architecture to Transformers and Llama.cpp.

We've worked hand-in-hand with the vLLM team to have production-grade support for Voxtral Mini 4B Realtime 2602 with vLLM. vLLM's new Realtime API is perfectly suited to run audio streaming sessions with the model.

Installation

Make sure to install vllm from the nightly pypi package. See here for a full installation guide.

uv pip install -U vllm

Doing so should automatically install mistral_common >= 1.9.0.

To check:

python -c "import mistral_common; print(mistral_common.__version__)"

You can also make use of a ready-to-go docker image or on the docker hub.

Make sure to also install all required audio processing libraries:

uv pip install soxr librosa soundfile

Also we recommend using Transformers v5 as v4 can clutter the terminal with unnecessary warnings (see here)

uv pip install --upgrade transformers

Serve

Due to size and the BF16 format of the weights - Voxtral-Mini-4B-Realtime-2602 can run on a single GPU with >= 16GB memory.

The model can be launched in both "eager" mode:

VLLM_DISABLE_COMPILE_CACHE=1 vllm serve mistralai/Voxtral-Mini-4B-Realtime-2602 --compilation_config '{"cudagraph_mode": "PIECEWISE"}'

Additional flags:

• You can set --max-num-batched-tokens to balance throughput and latency, higher means higher throughput but higher latency.
• You can reduce the default --max-model-len to allocate less memory for the pre-computed RoPE frequencies, if you are certain that you won't have to transcribe for more than X hours. By default the model uses a --max-model-len of 131072 (> 3h).

Client

After serving vllm, you should see that the model is compatible with vllm's new realtime endpoint:

...
(APIServer pid=3246965) INFO 02-03 17:04:43 [launcher.py:58] Route: /v1/realtime, Endpoint: realtime_endpoint
...

We have added two simple example files that allow you to:

• Stream audio files
• Simple gradio live transcription demo

To try out a demo, click here

Transformers

Starting with transformers >= 5.2.0, you can run Voxtral Realtime natively in Transformers!

For more details, refer to the Transformers documentation.

Installation

Install Transformers:

pip install --upgrade transformers

Make sure to have mistral-common installed with audio dependencies:

pip install --upgrade "mistral-common[audio]"

Usage

from transformers import VoxtralRealtimeForConditionalGeneration, AutoProcessor
from mistral_common.tokens.tokenizers.audio import Audio
from huggingface_hub import hf_hub_download

repo_id = "mistralai/Voxtral-Mini-4B-Realtime-2602"

processor = AutoProcessor.from_pretrained(repo_id)
model = VoxtralRealtimeForConditionalGeneration.from_pretrained(repo_id, device_map="auto")

repo_id = "patrickvonplaten/audio_samples"
audio_file = hf_hub_download(repo_id=repo_id, filename="bcn_weather.mp3", repo_type="dataset")

audio = Audio.from_file(audio_file, strict=False)
audio.resample(processor.feature_extractor.sampling_rate)

inputs = processor(audio.audio_array, return_tensors="pt")
inputs = inputs.to(model.device, dtype=model.dtype)

outputs = model.generate(**inputs)
decoded_outputs = processor.batch_decode(outputs, skip_special_tokens=True)

print(decoded_outputs[0])

ExecuTorch (Untested)

[!Warning] Running Voxtral-Realtime on-device with ExecuTorch is not throughly tested and hence there might be some sharp edges. If you encounter any problems, please file a bug report directly on ExecuTorch's GitHub

ExecuTorch enables you to deploy Voxtral-Realtime locally—either on-device or on your laptop.

For a quick, offline demo on your MacBook, check out Voxtral-Mini-4B-Realtime-2602-ExecuTorch.

To deploy Voxtral-Realtime in a custom environment or on any device, refer to the Official Readme.

[!Tip] If you're looking for an implementation that is purely written in C, we recommend to take a look at voxtral.c

Community Contributions (Untested)

Voxtral Realtime integrations in:

• Pure C - thanks Salvatore Sanfilippo
• mlx-audio framework - thanks Shreyas Karnik
• MLX - thanks Awni Hannun
• Rust - thanks TrevorS

License

This model is licensed under the Apache 2.0 License.

You must not use this model in a manner that infringes, misappropriates, or otherwise violates any third party’s rights, including intellectual property rights.