Integriere einen Avaluma-Avatar in deinen LiveKit-Agenten – in weniger als 30 Minuten.
Falls du bereits einen LiveKit-Agenten hast, kannst du diesen Schritt überspringen. Andernfalls empfehlen wir das offizielle Agent Starter Repo von LiveKit als Einstieg.
Für den schnellen Einstieg empfehlen wir LiveKit Cloud im Free Tier – keine Infrastruktur nötig. Wer eine vollständig selbst gehostete Lösung bevorzugt, kann LiveKit auch on-prem betreiben.
Installiere das offizielle Avaluma LiveKit Plugin über pip.
pip install git+https://github.com/avaluma-ai/avaluma-livekit-plugin.git@remote_onlyFüge die folgenden Imports hinzu und ersetze await session.start durch den Avatar-Setup-Block.
from avaluma_livekit_plugin import AvatarSession
from livekit.agents import RoomOutputOptions# Avatar
avatar = AvatarSession(
license_key=YOUR_API_KEY,
avatar_id="2025-09-06-Kadda_very_long_DS_v2_release_v5_gcs", # Avatar identifier without .hvia ("string" -> test stream)
avaluma_server_url="https://api.avaluma.ai",
)
# Start the avatar and wait for it to join
await avatar.start(room=ctx.room, agent_session=session)
# Start the session, which initializes the voice pipeline and warms up the models
await session.start(
agent=Assistant(),
room=ctx.room,
room_input_options=RoomInputOptions(
# For telephony applications, use `BVCTelephony` for best results
noise_cancellation=noise_cancellation.BVC(),
),
room_output_options=RoomOutputOptions(audio_enabled=False),
)Der Api kann in Login Bereich auf erstellt werden.
Starte deinen Agenten und teste ihn direkt im LiveKit Agents Playground.
LiveKit Playground öffnen