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-spatiusattached. - 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/avatarkit renders the avatar locally in the browser.
Frontend installation
- pnpm
- npm
- yarn
- bun
Frontend setup
1
Toolchain setup
Configure your build tool to load the AvatarKit WebAssembly assets. See Toolchain Setup.
2
Integrate the SDK
Step-by-step JS API setup
Step-by-step JS API setup
1
Initialize SDK
2
Load Avatar & Create View
3
Create Player with LiveKit Provider
4
Connect to LiveKit Server
5
Start voice interaction
LiveKit Agents plugin installation
- pip
- uv
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.
