livekit-plugins-sonex 0.1.0

LiveKit Agents plugin for SonexLabs Text-to-Speech (TTS)

livekit-plugins-sonex

LiveKit Agents plugin for SonexLabs Text-to-Speech.

This package allows LiveKit Agents to synthesize speech using SonexLabs' TTS API through the standard LiveKit plugin interface.

---

Features

• Native LiveKit Agents integration
• Async HTTP client
• High-quality SonexLabs voices
• Supports LiveKit AgentSession
• Simple pip installation

---

Installation

pip install livekit-plugins-sonex

For local development:

git clone https://github.com/sonexlabs/livekit-plugins-sonex.git
cd livekit-plugins-sonex

pip install -e .

---

Authentication

The plugin requires a SonexLabs API key.

You can either pass it directly:

tts = sonex.TTS(
    api_key="vsk_xxxxxxxxx",
    voice_id="YOUR_VOICE_ID",
)

or configure it as an environment variable.

Linux/macOS

export SONEX_API_KEY=vsk_xxxxxxxxx

Windows PowerShell

$env:SONEX_API_KEY="vsk_xxxxxxxxx"

---

Usage

from livekit.agents import AgentSession
from livekit.plugins import sonex

session = AgentSession(
    tts=sonex.TTS(
        voice_id="YOUR_VOICE_ID",
    ),
)

---

Parameters

Parameter	Description
api_key	Sonex API key (optional if SONEX_API_KEY is set)
voice_id	Sonex voice ID
model	TTS model (default: panini)
sample_rate	Output sample rate (default: 24000 Hz)

---

Requirements

• Python 3.10+
• livekit-agents

---

License

Apache-2.0