Python SDK

pip install avatarkit

import asyncio
from datetime import datetime, timedelta, timezone

from avatarkit import new_avatar_session


async def main():
    session = new_avatar_session(
        api_key="your-api-key",
        app_id="your-app-id",
        avatar_id="your-avatar-id",
        expire_at=datetime.now(timezone.utc) + timedelta(minutes=5),
        console_endpoint_url="https://console.us-west.spatialwalk.cloud/v1/console",
        ingress_endpoint_url="wss://api.us-west.spatialwalk.cloud/v2/driveningress",
        transport_frames=lambda frame, last: print(f"Received frame: {len(frame)} bytes, last={last}"),
        on_error=lambda err: print(f"Error: {err}"),
        on_close=lambda: print("Session closed"),
    )

    await session.init()
    connection_id = await session.start()
    print(f"Connected: {connection_id}")

    # Send audio
    audio_data = b"..."  # Your PCM audio data
    request_id = await session.send_audio(audio_data, end=True)
    print(f"Sent audio: {request_id}")

    await asyncio.sleep(10)

    await session.close()


if __name__ == "__main__":
    asyncio.run(main())

from avatarkit import new_avatar_session, LiveKitEgressConfig

session = new_avatar_session(
    # ... other options ...
    livekit_egress=LiveKitEgressConfig(
        url="wss://your-livekit-server.com",
        api_key="livekit-api-key",
        api_secret="livekit-api-secret",
        room_name="your-room-name",
        publisher_id="avatar-publisher",
    ),
)

from avatarkit import new_avatar_session, AgoraEgressConfig

session = new_avatar_session(
    # ... other options ...
    agora_egress=AgoraEgressConfig(
        channel_name="your-channel-name",
        token="agora-token",
        uid=0,
    ),
)