> ## 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.

# How to integrate

> Choose an integration mode and start from runnable example projects

<Info>
  SpatialReal currently provides **avatar-only** services, focusing on generating and rendering real-time avatar animations based on audio input. Voice conversation logic, speech synthesis, and other agent functionalities are managed by your application or third-party services.
</Info>

## Compare Integration Modes

| Mode                                                            | Characteristic               | Latency     | Dev Effort | Ideal Scenario                                                                                |
| --------------------------------------------------------------- | ---------------------------- | ----------- | ---------- | --------------------------------------------------------------------------------------------- |
| **[SDK Mode](/concepts/integrations#sdk-mode)**                 | Client-centric               | Moderate ⏱️ | Low 🟢     | Easy client-centric integration.                                                              |
| **[Framework Plugin](/concepts/integrations#framework-plugin)** | Voice agent framework plugin | Ultra-Low ⚡ | Low 🟢     | Use [LiveKit Agents](https://docs.livekit.io/agents/) or [TEN Framework](https://theten.ai/). |
| **[RTC Mode](/concepts/integrations#rtc-mode)**                 | Transport via Agora/LiveKit  | Ultra-Low ⚡ | Medium 🟡  | You want to optimize latency, and use LiveKit or Agora as transport layer                     |
| **[Host Mode](/concepts/integrations#host-mode)**               | Use your own transport layer | Low 💨      | High 🔴    | Full control over data transport.                                                             |

## Start from Runnable Examples

<Card title="AvatarKit Voice Agent Demo" icon="code" href="https://github.com/spatialwalk/avatarkit-voice-agent-demo/tree/main/livekit-agents" horizontal>
  A collection of example projects that can work out of the box after API keys are filled in `.env`.
</Card>

```bash theme={null}
git clone https://github.com/spatialwalk/avatarkit-voice-agent-demo.git
cd avatarkit-voice-agent-demo
```

## Guides

<CardGroup cols={2}>
  <Card title="SDK Mode Guide" icon="book-open" href="/guide/sdk-mode">
    Start with client-centric integration.
  </Card>

  <Card title="Host Mode Guide" icon="book-open" href="/guide/host-mode">
    Build custom transport and server orchestration.
  </Card>
</CardGroup>

<Card title="RTC Mode & Framework Plugin Guide" icon="book-open" href="/guide/rtc-mode">
  Use LiveKit or Agora for real-time delivery, including LiveKit Agents and TEN Framework integration.
</Card>

## Want to Learn More?

Read the full [Integration Modes](/concepts/integrations) doc to understand the technical details, service architecture, and best practices for each integration mode.