Skip to main content

Mistral TTS plugin guide

How to use the Mistral TTS plugin for LiveKit Agents.

Available in
Python

Overview

This plugin allows you to use Voxtral as a TTS provider for your voice agents.

Installation

Install the LiveKit Mistral AI plugin from PyPI:

pip install "livekit-agents[mistralai]~=1.5"

Authentication

The Mistral plugin requires a Mistral AI API key.

Set MISTRAL_API_KEY in your .env file.

Usage

Use Mistral TTS within an AgentSession or as a standalone speech generator. For example, you can use this TTS in the Voice AI quickstart.

from livekit.plugins import mistralai
session = AgentSession(
tts=mistralai.TTS(
),
# ... llm, stt, etc.
)

Parameters

This section describes some of the available parameters. See the plugin reference for a complete list of all available parameters.

modelTTSModels | stringDefault: voxtral-mini-tts-2603

Voxtral TTS model to use. To learn more, see TTS model options.

voiceTTSVoices | stringDefault: en_paul_neutral

Voxtral TTS voice to use.

ref_audiostr

Base64-encoded audio sample for zero-shot voice cloning. Mutually exclusive with voice.

response_formatRESPONSE_FORMAT

The audio format of synthesized speech, between mp3, wav, pcm, opus or flac. Defaults to pcm.

Additional resources

The following resources provide more information about using Mistral with LiveKit Agents.