LiveKit docs › Models › TTS › Additional models › Simplismart

---

# Simplismart TTS plugin guide

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

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

## Overview

This plugin allows you to use [Simplismart](https://www.simplismart.ai/) as a TTS provider for your voice agents. Simplismart hosts multiple TTS model families: Orpheus (the default) and Qwen 3. Orpheus models run on Simplismart's shared inference endpoint, while Qwen 3 TTS runs on a dedicated deployment you create.

### Installation

Install the plugin from PyPI:

**Python**:

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

```

### Authentication

The Simplismart plugin requires a [Simplismart API key](https://docs.simplismart.ai/model-suite/settings/api-keys).

Set `SIMPLISMART_API_KEY` in your `.env` file.

## Orpheus models

Orpheus models run on Simplismart's shared inference endpoint.

### Usage

Use Simplismart 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**:

```python
from livekit.plugins import simplismart

session = AgentSession(
   tts=simplismart.TTS(
      model="canopylabs/orpheus-3b-0.1-ft",
      voice="tara",
   )
   # ... llm, stt, etc.
)

```

### Parameters

This section describes some of the parameters for Orpheus models. For a complete list, see the [plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/simplismart/index.html.md#livekit.plugins.simplismart.TTS).

- **`model`** _(str | TTSModels)_ (optional) - Default: `canopylabs/orpheus-3b-0.1-ft`: Model identifier for the backend TTS model. Examples include `canopylabs/orpheus-3b-0.1-ft` and `maya-research/Veena`.

- **`voice`** _(str)_ (optional) - Default: `tara`: Voice identifier to use for generation.

- **`temperature`** _(float)_ (optional) - Default: `0.7`: Controls the randomness in the model output. Lower values make output more deterministic.

- **`top_p`** _(float)_ (optional) - Default: `0.9`: Nucleus sampling probability threshold. Limits the sampling pool of predicted tokens.

- **`repetition_penalty`** _(float)_ (optional) - Default: `1.5`: Penalty applied to repeated text to reduce repetition.

- **`max_tokens`** _(int)_ (optional) - Default: `1000`: Maximum number of output tokens allowed in the synthesized speech.

## Qwen 3 TTS

Qwen 3 TTS runs on a dedicated Simplismart deployment.

### Model deployment

Deploy the `qwen-tts` model from your Simplismart dashboard before using it with LiveKit Agents. Your deployment includes a model endpoint URL. Pass this URL as `base_url`, including the `/v1/audio/speech` path. Authenticate with the same `SIMPLISMART_API_KEY`.

### Usage

Set `model="qwen-tts"` to use the Qwen request format and the default `Chelsie` voice. Pass `language` and `leading_silence` to configure Qwen-specific behavior.

**Python**:

```python
from livekit.plugins import simplismart

session = AgentSession(
   tts=simplismart.TTS(
      model="qwen-tts",
      voice="Chelsie",
      base_url="https://<your-deployment-endpoint>/v1/audio/speech",
      language="English",
      leading_silence=True,
   )
   # ... llm, stt, etc.
)

```

### Parameters

This section describes some of the parameters for Qwen 3 TTS. For a complete list, see the [plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/simplismart/index.html.md#livekit.plugins.simplismart.TTS).

- **`base_url`** _(str)_: Endpoint URL for your deployed model. Takes the shape `https://<your-deployment-endpoint>/v1/audio/speech`. Find your deployment endpoint in your Simplismart dashboard.

- **`model`** _(str | TTSModels)_ (optional): Model identifier for the backend TTS model. Set to `qwen-tts` to use Qwen 3 TTS.

- **`voice`** _(str)_ (optional) - Default: `Chelsie`: Voice identifier to use for generation.

- **`language`** _(str)_ (optional) - Default: `English`: Language for synthesis.

- **`leading_silence`** _(bool)_ (optional) - Default: `True`: Whether to include leading silence in the generated audio.

## Additional resources

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

- **[Simplismart docs](https://docs.simplismart.ai/)**: Simplismart TTS docs.

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

---

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

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