Mistral Voxtral STT Plugin
Mistral Voxtral realtime speech-to-text integration for Vision Agents.
Features
- Real-time speech recognition via WebSocket streaming
- Low-latency transcription using Voxtral models
- Automatic language detection
- Partial transcript streaming for responsive UX
- Sentence-level final transcripts (triggered by
.,?,!)
Installation
uv add "vision-agents[mistral]"
# or directly
uv add vision-agents-plugins-mistral
Usage
from vision_agents.core import Agent, Runner, User
from vision_agents.core.agents import AgentLauncher
from vision_agents.plugins import deepgram, gemini, getstream, mistral
async def create_agent(**kwargs) -> Agent:
return Agent(
edge=getstream.Edge(),
agent_user=User(name="Assistant", id="agent"),
instructions="You're a helpful voice AI assistant. Keep replies short and conversational.",
stt=mistral.STT(),
tts=deepgram.TTS(),
llm=gemini.LLM(),
)
async def join_call(agent: Agent, call_type: str, call_id: str, **kwargs) -> None:
call = await agent.create_call(call_type, call_id)
async with agent.join(call):
await agent.run()
if __name__ == "__main__":
Runner(AgentLauncher(create_agent=create_agent, join_call=join_call)).cli()
Run with:
uv run plugins/mistral/example/mistral_stt_example.py run
Turn Detection
Mistral Voxtral STT does not include built-in turn detection (turn_detection=False). You'll need to pair it with an external turn detection plugin.
Configuration
| Parameter | Description | Default |
|---|---|---|
api_key |
Mistral API key | MISTRAL_API_KEY env var |
model |
Model identifier | voxtral-mini-transcribe-realtime-2602 |
sample_rate |
Audio sample rate (Hz): 8000, 16000, 22050, 44100, 48000 | 16000 |
client |
Pre-configured Mistral client | None |
Events
The plugin emits standard STT events:
STTTranscriptEvent: Final transcript (emitted at sentence boundaries or stream end)STTPartialTranscriptEvent: Partial word/delta as transcription streams
Dependencies
mistralai[realtime]>=1.12.0vision-agents
Metadata
Release files for vision-agents-plugins-mistral 0.6.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vision_agents_plugins_mistral-0.6.9.tar.gz | 4.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vision_agents_plugins_mistral-0.6.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.8 kB
Release files / vision_agents_plugins_mistral-0.6.9.tar.gz
| Download URL | vision_agents_plugins_mistral-0.6.9.tar.gz |
|---|---|
| Size | 4.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f091627e1233858dcd6359dd11d0a5cf0496ae2927ca537fa11f10de90dd1923
|
|
BLAKE2b-256 checksum How to use checksums |
a13773a65ba92e49e47b7a4ed1354ee5900306a78c1ea6620ad8120dd2ef8a80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / vision_agents_plugins_mistral-0.6.9-py3-none-any.whl
| Download URL | vision_agents_plugins_mistral-0.6.9-py3-none-any.whl |
|---|---|
| Size | 5.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
72a8e4ef181a28e07487d2f86cc966ab6dc69ce0775409918439e21a8e38653d
|
|
BLAKE2b-256 checksum How to use checksums |
a4b0d8961339f93b6b28c84ba0376d74dd7732526f1509a73fd3cb6d05808059
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|