Murf AI TTS plugin guide | LiveKit Documentation

Available in

Python

Overview

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

Installation

Install the plugin from PyPI:

uv add "livekit-agents[murf]~=1.5"

Authentication

The Murf AI plugin requires a Murf AI API key.

Set MURF_API_KEY in your .env file.

Usage

Use Murf AI 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 murf

session = AgentSession(
   tts=murf.TTS(
      voice="en-US-matthew",
      style="Conversational",
      model="FALCON",
   )
   # ... llm, stt, etc.
)

Parameters

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

modelstringDefault: FALCON

The Murf AI TTS model to use. Valid values are:

FALCON
GEN2

voicestringDefault: en-US-matthew

The voice ID from Murf AI's voice library. Voice IDs follow the format {locale}-{name}. Refer to the Murf AI API docs for a complete list of available voices.

stylestringDefault: Conversation

The voice style to apply. Refer to the Murf AI API docs for a complete list of available styles.

localestring

The locale for synthesis, for example en-US or fr-FR. If not provided, the locale is inferred from the voice ID. See the Murf AI API docs for a complete list of supported locales.

speedint

Controls the speech speed. Positive values increase speed, negative values decrease it. Valid range: -50 to 50.

pitchint

Controls the speech pitch. Positive values raise pitch, negative values lower it. Valid range: -50 to 50.

Additional resources

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

Python package

The livekit-plugins-murf package on PyPI.

Plugin reference

Reference for the Murf AI TTS plugin.

Murf AI API docs

Murf AI's full API documentation.

Voice AI quickstart

Get started with LiveKit Agents and Murf AI TTS.