Android SDK Quickstart

GitHub Repository

Kotlin + Compose sample implementing the avatar pipeline: VAD → ASR → LLM → TTS → AvatarKit.

This quickstart targets the Direct Mode path on Android. The sample app pastes the Session Token in the UI rather than fetching from a backend — convenient for first-run validation.

Prerequisites

Android Studio (latest stable)
JDK 17
Android API 24+ device or emulator (arm64-v8a, real device recommended)
Spatius credentials. See Credentials.
- App ID — from Spatius Studio
- Avatar ID — from the Avatar Library
- Session Token — see Session token API
An OpenAI API key for the ASR + LLM + TTS pipeline used by the sample.

Run it

Clone and configure

git clone https://github.com/spatius-ai/spatius-avatar-demo.git
cd spatius-avatar-demo/direct-mode/clients/android
cp local.properties.example local.properties

Fill local.properties:

SPATIUS_APP_ID=<your-app-id>
SPATIUS_AVATAR_ID=<your-avatar-id>
OPENAI_API_KEY=<your-openai-api-key>
OPENAI_USE_PROXY=false

Session Token is not configured in files — paste it in the app UI at runtime.

Build

JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home" ./gradlew :app:assembleDebug

Install with Android Studio or adb install.

Start a conversation

In the running app:

Initialize the avatar.
Paste your Session Token.
Tap Start Conversation.
Speak and pause to trigger a round.

What this validates

Check	What it tells you
Avatar renders	App ID + Avatar ID are correct, Maven dependency resolved.
Conversation starts	Session Token is valid, Motion Server connection works.
Avatar speaks	Full pipeline (mic → ASR → LLM → TTS → AvatarKit) is wired up end to end.

Start Here

Quickstarts

Platform Integrations

Standalone Integrations

Concepts

Examples & Support

Android SDK Quickstart

GitHub Repository

Prerequisites

Run it

What this validates

Next steps

Android SDK reference

Browse all demos

GitHub Repository

​Prerequisites

​Run it

​What this validates

​Next steps

Android SDK reference

Browse all demos

Prerequisites

Run it

What this validates

Next steps