LiveKit docs › Models › TTS › Additional models › Speechmatics

---

# Speechmatics TTS plugin guide

> How to use the Speechmatics TTS plugin for LiveKit Agents.

Available in:
- [ ] Node.js
- [x] Python

## Overview

This plugin allows you to use [Speechmatics](https://www.speechmatics.com/) as a TTS provider for your voice agents. The plugin uses the Speechmatics preview TTS API and doesn't support streaming.

## Quick reference

This section includes a brief overview of the Speechmatics TTS plugin. For more information, see [Additional resources](#additional-resources).

### Installation

Install the plugin from PyPI:

```shell
uv add "livekit-agents[speechmatics]~=1.5"

```

### Authentication

The Speechmatics plugin requires a [Speechmatics API key](https://docs.speechmatics.com/introduction/authentication).

Set `SPEECHMATICS_API_KEY` in your `.env` file.

### Usage

Use Speechmatics TTS within an `AgentSession` or as a standalone speech generator. For example, you can use this TTS in the [Voice AI quickstart](https://docs.livekit.io/agents/start/voice-ai.md).

```python
from livekit.plugins import speechmatics

session = AgentSession(
   tts=speechmatics.TTS(
      voice="sarah",
   ),
   # ... llm, stt, etc.
)

```

### Parameters

This section describes some of the available parameters. See the [plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/speechmatics/index.html.md#livekit.plugins.speechmatics.TTS) for a complete list of all available parameters.

- **`voice`** _(string)_ (optional) - Default: `sarah`: Voice model to use for synthesis. Valid values: `sarah`, `theo`, and `megan`.

## Additional resources

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

- **[Python package](https://pypi.org/project/livekit-plugins-speechmatics/)**: The `livekit-plugins-speechmatics` package on PyPI.

- **[Plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/speechmatics/index.html.md#livekit.plugins.speechmatics.TTS)**: Reference for the Speechmatics TTS plugin.

- **[GitHub repo](https://github.com/livekit/agents/tree/main/livekit-plugins/livekit-plugins-speechmatics)**: View the source or contribute to the LiveKit Speechmatics TTS plugin.

- **[Speechmatics docs](https://docs.speechmatics.com/)**: Speechmatics documentation.

- **[Voice AI quickstart](https://docs.livekit.io/agents/start/voice-ai.md)**: Get started with LiveKit Agents and Speechmatics TTS.

---

This document was rendered at 2026-06-07T11:35:48.148Z.
For the latest version of this document, see [https://docs.livekit.io/agents/models/tts/speechmatics.md](https://docs.livekit.io/agents/models/tts/speechmatics.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).