> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spatialreal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Step-by-step guides for integrating SpatialReal avatars into your application

The **Guide** walks you through integrating SpatialReal avatars by **integration mode**. Choose the mode that matches your architecture, then follow the linked guides for your platform (Web, iOS, Android) or backend (LiveKit, Server SDK).

## Integration Modes

<CardGroup cols={2}>
  <Card title="SDK Mode" icon="code" href="/guide/sdk-mode">
    Client sends audio; SDK handles networking and rendering. Best for simple, client-centric apps.
  </Card>

  <Card title="RTC Mode & Framework Plugins" icon="tower-broadcast" href="/guide/rtc-mode">
    Real-time voice via LiveKit. Use framework plugins or Server SDK with egress.
  </Card>

  <Card title="Host Mode" icon="server" href="/guide/host-mode">
    You control the transport. Server SDK sends audio and relays animation to the client SDK.
  </Card>

  <Card title="Agent Mode" icon="robot" href="/guide/agent-mode">
    Fully managed voice agent (coming soon).
  </Card>
</CardGroup>

## Where to Start

* **New to SpatialReal?** Start with [Overview → Speech-to-Avatar Quickstart](/overview/speech-to-avatar), then open the guide for your chosen mode.
* **Already chose a mode?** Use the sidebar: pick **SDK Mode**, **RTC Mode**, or **Host Mode**, then follow the platform-specific quickstarts (Web, iOS, Android) or server guides (LiveKit).
* **Want working code?** Check out our [Demo Projects](/overview/demo-projects) for complete examples you can run immediately.

## Quickstart Code Walkthroughs

<CardGroup cols={2}>
  <Card title="Speech-to-Avatar Walkthrough" icon="book-open" href="/guide/speech-to-avatar-walkthrough">
    Understand the SDK Mode quickstart code structure and runtime flow.
  </Card>

  <Card title="Agent Quickstart Walkthrough" icon="book-open" href="/guide/agent-quickstart-walkthrough">
    Understand the LiveKit agent quickstart backend and frontend architecture.
  </Card>
</CardGroup>

<Card title="AvatarKit Voice Agent Demo" icon="github" href="https://github.com/spatialwalk/avatarkit-voice-agent-demo" horizontal>
  A full reference repository with implementation details, including different frontend UI options and multiple backend agent patterns.
</Card>

## Quick Links

| Mode     | Client / Platform                                                                            | Server                                                                                                                    |
| -------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **SDK**  | [Web](/guide/sdk-mode-web) · [iOS](/ios-sdk/quickstart) · [Android](/android-sdk/quickstart) | Session token from your backend only                                                                                      |
| **RTC**  | [LiveKit Client](/guide/rtc-livekit-client)                                                  | [LiveKit Server](/guide/rtc-livekit-server)                                                                               |
| **Host** | [Web](/web-sdk/host-mode) · [iOS](/ios-sdk/host-mode) · [Android](/android-sdk/host-mode)    | [Python](/server/python-sdk/python-host-mode) · [Golang](/server/go-sdk/go-host-mode) · [JS](/server/js-sdk/js-host-mode) |
