ElevenLabs Text-to-Speech Plugin

A high-quality Text-to-Speech (TTS) plugin for GetStream that uses the ElevenLabs API.

Installation

uv add "vision-agents[elevenlabs]"
# or directly
uv add vision-agents-plugins-elevenlabs

Usage

from getstream.plugins.elevenlabs import ElevenLabsTTS
from getstream.video.rtc.audio_track import AudioStreamTrack

# Initialize with API key from environment variable
tts = ElevenLabsTTS()

# Or specify API key directly
tts = ElevenLabsTTS(api_key="your_elevenlabs_api_key")

# Create an audio track to output speech
track = AudioStreamTrack(framerate=16000)
tts.set_output_track(track)

# Register event handlers
@tts.on("audio")
def on_audio(audio_data, user):
    print(f"Received audio chunk: {len(audio_data)} bytes")

# Send text to be converted to speech
async for chunk in tts.send_iter("Hello, this is a test of the ElevenLabs text-to-speech plugin."):
    pass

Configuration Options

• api_key: ElevenLabs API key (default: reads from ELEVENLABS_API_KEY environment variable)
• voice_id: The voice ID to use for synthesis (default: "VR6AewLTigWG4xSOukaG")
• model_id: The model ID to use for synthesis (default: "eleven_multilingual_v2")

Requirements

• Python 3.10+
• elevenlabs>=2.5.0