Groq TTS integration guide

Overview

Groq provides fast TTS using models from PlayAI. With LiveKit's Groq integration and the Agents framework, you can build voice AI applications with fluent and conversational voices. Groq TTS supports English and Arabic speech.

Quick reference

This section includes a basic usage example and some reference material. For links to more detailed documentation, see Additional resources.

Installation

Install the plugin from PyPI:

pip install "livekit-agents[groq]~=1.0rc"

Authentication

The Groq plugin requires a Groq API key.

Set GROQ_API_KEY in your .env file.

Usage

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

from livekit.plugins import groq
   
session = AgentSession(
   tts=groq.TTS(
      model="playai-tts",
      voice="Arista-PlayAI",
   ),
   # ... stt, llm, vad, turn_detection, etc.
)

Parameters

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

modelTTSModel | stringOptionalDefault: playai-tts

Name of the TTS model. For a full list, see Models.

voicestringOptionalDefault: Arista-PlayAI

Name of the voice. For a full list, see English and Arabic voices.

Additional resources

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

Python package

The livekit-plugins-groq package on PyPI.

Plugin reference

Reference for the Groq TTS plugin.

GitHub repo

View the source or contribute to the LiveKit Groq TTS plugin.

Groq docs

Groq TTS docs.

Voice AI quickstart

Get started with LiveKit Agents and Groq TTS.

Groq ecosystem guide

Overview of the entire Groq and LiveKit Agents integration.