Skip to main content
Web Only: The current AvatarKit RTC client demo path targets Web. LiveKit ships iOS and Android client SDKs, but Spatius does not yet provide iOS or Android demos for this path.

At a glance

Architecture

  • LiveKit room handles transport.
  • Agent worker runs your voice agent with livekit-plugins-spatius attached.
  • Motion Server generates motion data from the agent audio and publishes the synchronized audio + motion stream back into the room.
  • AvatarKit RTC client joins the room and renders the avatar.
Spatius is not a video streaming service. Even when you use LiveKit as the transport layer and LiveKit Agents as the voice agent framework, LiveKit transports avatar audio and motion data, not finished avatar video. @spatius/avatarkit renders the avatar locally in the browser.

Frontend installation

Frontend setup

1

Toolchain setup

Configure your build tool to load the AvatarKit WebAssembly assets. See Toolchain Setup.
2

Integrate the SDK

1

Initialize SDK

2

Load Avatar & Create View

3

Create Player with LiveKit Provider

4

Connect to LiveKit Server

5

Start voice interaction

Full RTC client API reference: LiveKit Agents Client.

LiveKit Agents plugin installation

Server setup

Spatius plugin is part of LiveKit Agents framework since 1.6.7, see the LiveKit documentation for the setup, and LiveKit Agents Integration Server for the full reference.

Next steps

Quickstart

Run the end-to-end LiveKit Agents voice avatar demo.

Server

Add livekit-plugins-spatius to your LiveKit Agents worker.

Client

Render the avatar in your Web app with @spatius/avatarkit-rtc.