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

# Speech-to-Avatar

> Run the Speech-to-Avatar demo directly from the official repository

Use this quickstart to run a ready-made **Speech-to-Avatar** demo in a few minutes.
This page focuses on running the demo fast. Code-level explanation is in the Guide page.

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="github" href="https://github.com/spatialwalk/avatarkit-voice-agent-demo/tree/main/spatialreal-speech-to-avatar-quickstart">
    Source code for this quickstart.
  </Card>

  <Card title="Code Walkthrough" icon="book-open" href="/guide/speech-to-avatar-walkthrough">
    File-by-file explanation of the implementation.
  </Card>
</CardGroup>

## Prerequisites

* Node.js 18+
* `pnpm`
* SpatialReal credentials:
  * `VITE_SPATIALREAL_APP_ID`
  * `VITE_SPATIALREAL_AVATAR_ID`
  * `VITE_SPATIALREAL_SESSION_TOKEN` ([how to generate](/studio/aki-key#temporary-session-token))

<Steps>
  <Step title="Clone the repo and enter the quickstart folder">
    ```bash theme={null}
    git clone https://github.com/spatialwalk/avatarkit-voice-agent-demo.git
    cd avatarkit-voice-agent-demo/spatialreal-speech-to-avatar-quickstart
    ```
  </Step>

  <Step title="Create env file">
    ```bash theme={null}
    cp .env.example .env
    ```

    Update `.env` with your own values:

    ```bash title=".env" theme={null}
    VITE_SPATIALREAL_APP_ID=your_app_id # https://app.spatialreal.ai/apps
    VITE_SPATIALREAL_AVATAR_ID=your_avatar_id # https://app.spatialreal.ai/avatars/library
    VITE_SPATIALREAL_SESSION_TOKEN=your_temporary_session_token # https://app.spatialreal.ai/apps -> details -> Generate Temporary Token
    ```
  </Step>

  <Step title="Install and run">
    ```bash theme={null}
    pnpm install
    pnpm dev
    ```

    Open `http://localhost:3000`, click **Connect Avatar**, then click **Send Audio**.
  </Step>
</Steps>

## Next

* Want to understand the code structure and runtime flow? See [Speech-to-Avatar Walkthrough](/guide/speech-to-avatar-walkthrough).