Python SDK

pip install openspline

For Cloud, set OPENSPLINE_API_KEY. For a local service, leave it unset or set OPENSPLINE_URL.

from openspline import Openspline

async with Openspline().avatar("portrait.jpg", quality="low") as avatar:
    print(avatar.viewer_url)
    await avatar.stream(agent.audio_stream(), sample_rate=24000)

Play a WAV or MP3 file:

async with Openspline().avatar("portrait.jpg") as avatar:
    print(avatar.viewer_url)
    await avatar.play_file("speech.wav")

For callback based audio:

await avatar.send_audio(chunk, sample_rate=24000)
await avatar.end_turn()
await avatar.interrupt()  # when the user interrupts

send_audio() defaults to mono PCM16. Use encoding="pcm_f32le" for Float32 or encoding="mp3" for MP3 chunks. stream() ends the turn and waits for playback. Call await avatar.wait_for_viewer() if your agent should wait until someone opens the player. Runnable Python example · Configuration · Backgrounds

Start here

Build an avatar

Connect your agent

Reference