livekit-plugins-spatius, and the Web RTC Adapter. For Agora Convo AI setup, see Agora Convo AI Integration.
Fastest first demo by path
| Path | Fastest first-run target | Why start there |
|---|---|---|
| Direct Mode | Web SDK quickstart | Lowest setup surface: App ID, Avatar ID, Session Token, sample PCM audio, and browser rendering. |
| LiveKit Agents Integration | LiveKit Agents quickstart | Packaged Web voice-agent path with LiveKit room setup, Gemini Live, livekit-plugins-spatius, and RTC rendering. |
| Agora Convo AI Integration | Convo AI Agent setup plus Agora client setup | Best when you already use Agora Convo AI or TEN Framework; no packaged quickstart lives in this section yet. |
| Backend Mode | Backend Mode demos | Best after you understand the Server SDK and transport responsibilities; it is not a smallest-first quickstart. |
Direct Mode and token servers
Direct Mode clients connect to Motion Server themselves. They still need a short-lived Session Token, but that token must be issued by backend code because issuing it requires yourSPATIUS_API_KEY.
That backend code is only a token endpoint. It is not a Backend Mode runtime server: it does not run ASR, LLM, or TTS; it does not connect to Motion Server; and it does not relay audio or motion data. The Direct Mode demos include token-server examples only to show how to exchange your server-side API Key for a client-safe Session Token.
| Server-shaped code | Used by | Responsibility |
|---|---|---|
| Token endpoint | Direct Mode | Mint short-lived Session Tokens for clients. |
| Runtime server | Backend Mode | Own ASR / LLM / TTS, connect to Motion Server with the Server SDK, and deliver encoded audio payloads + motion data payloads to clients. |
Direct Mode SDK quickstarts
| Platform | Quickstart | What it proves |
|---|---|---|
| Web | Web SDK | App ID, Avatar ID, Session Token, sample PCM audio, optional browser realtime conversation, and local rendering. |
| iOS | iOS SDK | Native iOS AvatarKit setup with runtime Session Token. |
| Android | Android SDK | Native Android AvatarKit setup with runtime Session Token. |
| Flutter | Flutter SDK | Flutter AvatarKit setup on iOS or Android with runtime Session Token. |
Platform integration quickstarts
| Platform integration | Quickstart | What it proves |
|---|---|---|
| LiveKit Agents | LiveKit Agents | LiveKit room setup, Gemini Live voice agent, livekit-plugins-spatius, Web RTC Adapter rendering, and microphone flow. |
Next steps
Browse all demos
Every runnable demo by platform and integration path.
Choose your integration path
Compare latency, production ownership, and developer effort.