livekit-plugins-reson8 0.2.0

Reson8 STT plugin for LiveKit Agents

livekit-plugins-reson8

Reson8 STT plugin for LiveKit Agents.

A single reson8.STT class that adapts to how LiveKit uses it:

• Streaming (stream(), used by voice agents) connects to the turn-aware endpoint. Reson8 detects conversational turn boundaries server-side: it emits a preflight transcript (an eager guess that the turn is over) that your agent can start responding to, then confirms it as a final transcript — or cancels it if the speaker keeps talking. Great for low-latency voice agents.
• Batch (recognize()) transcribes pre-recorded audio and returns the full transcript.

Any language

Reson8 supports any language. Leave language unset to auto-detect the spoken language, or pass any language code (e.g. "en", "nl", "es", "de", "fr", ...) to pin it.

reson8.STT()                 # auto-detects the spoken language
reson8.STT(language="en")    # English
reson8.STT(language="es")    # Spanish
reson8.STT(language="nl")    # Dutch

Installation

pip install livekit-plugins-reson8

Usage

from livekit.plugins import reson8

stt = reson8.STT(
    api_key="your-api-key",   # or set RESON8_API_KEY
    # language is auto-detected when omitted; pass any code to pin it
)

With a Voice Agent

from livekit.agents.voice import VoiceAgent
from livekit.plugins import openai, reson8

agent = VoiceAgent(
    stt=reson8.STT(),          # streaming + turn detection, any language
    llm=openai.LLM(),
    tts=openai.TTS(),
)

Transcribing a file

event = await reson8.STT().recognize(audio_buffer)
print(event.alternatives[0].text)

Configuration

Parameter	Env var	Default
api_key	RESON8_API_KEY	required
api_url	RESON8_API_URL	https://api.reson8.dev
language	—	None (auto-detect; accepts any language code)
sample_rate	—	16000
encoding	—	"pcm_s16le"
channels	—	1
custom_model_id	—	None (custom model for recognition biasing)
include_timestamps	—	False
include_words	—	False
include_confidence	—	False (batch recognition)
include_language	—	False (report detected language while streaming)

STT.update_options(...) changes settings at runtime; active streaming sessions reconnect automatically to apply them.

Running the example

cp .env.example .env
# Fill in your keys
python examples/voice_agent.py dev