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

# 🚀 Quickstart

> Stream real-time user events into your support AI agents in a couple lines of code.

## ⚡ Add this skill

<CardGroup cols={2}>
  <Card title="One command" icon="terminal">
    Add the shared Autoplay SDK foundation skill for credentials and live-activity reads.

    <CodeGroup>
      ```bash CLI theme={null}
      uvx --from autoplay-sdk autoplay-install-skills
      ```
    </CodeGroup>

    <a className="skill-card-link" href="/quickstart">View the docs →</a>
  </Card>

  <Card title="Agent onboarding" icon="robot">
    Fetch this skill directly so your coding agent gets the same Autoplay SDK setup instructions.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -s https://developers.autoplay.ai/autoplay-core/SKILL.md
      ```
    </CodeGroup>

    <a className="skill-card-link" href="https://developers.autoplay.ai/autoplay-core/SKILL.md" target="_blank">View the skill →</a>
  </Card>
</CardGroup>

{/* HIDDEN (per product feedback — keep, do not delete):
<Tip>
**Want this done for you?** The [⚡ One-command setup](/get-started/one-command-setup)
CLI runs the product registration and creates + verifies the PostHog
destination automatically — you only confirm the small frontend edit. This
page is the manual, step-by-step version of the same wiring.
</Tip>
*/}

## Install the SDK

**Prerequisites — Python 3.10 or later required.**

<Tabs>
  <Tab title="Mac / Linux">
    Check your Python version:

    ```bash theme={null}
    python3 --version
    ```

    If Python is not installed, download it from [python.org](https://www.python.org/downloads/) or install via Homebrew:

    ```bash theme={null}
    brew install python3
    ```

    Then create and activate a virtual environment before installing:

    ```bash theme={null}
    python3 -m venv .venv
    source .venv/bin/activate
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    Check your Python version:

    ```powershell theme={null}
    python --version
    ```

    If Python is not installed, download it from [python.org](https://www.python.org/downloads/) and run the installer — check **"Add Python to PATH"** during setup.

    Then create and activate a virtual environment before installing:

    ```powershell theme={null}
    python -m venv .venv
    .venv\Scripts\Activate.ps1
    ```

    <Note>
      If you see a permissions error, run this once first:
      `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
    </Note>
  </Tab>
</Tabs>

Run this command once from your project root (with your venv active):

```bash theme={null}
pip install autoplay-sdk
# OR
uv add autoplay-sdk
```

Install [Agent skills](/get-started/agent-skills) for Cursor/Claude so your assistant follows the correct integration pattern for your stack. See [Pricing](/who-we-are/pricing) for plans.

## 🎯 Step 1 — Connect your session replay provider

Autoplay needs a live stream of what each user is doing before anything downstream can use it as context. Pick whichever tool you already have — already wired up? The tool's page tells you how to confirm it in seconds instead of redoing setup.

<CardGroup cols={3}>
  <Card href="/recipes/posthog/how-to-setup">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/lzNTbrNZ8NuMh-AW/images/recipes/posthog/logo.png?fit=max&auto=format&n=lzNTbrNZ8NuMh-AW&q=85&s=ab56ad6a4f8f04115a22acc4c3968209" alt="" className="tool-card-logo" width="924" height="512" data-path="images/recipes/posthog/logo.png" />

      <span className="tool-card-title">PostHog</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect an existing PostHog project
  </Card>

  <Card href="/recipes/amplitude/how-to-setup">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/qstpFt_lebOYZSOK/images/recipes/amplitude/logo.svg?fit=max&auto=format&n=qstpFt_lebOYZSOK&q=85&s=1afbdaaf0bbc525c722872bc6151a118" alt="" className="tool-card-logo" width="64" height="64" data-path="images/recipes/amplitude/logo.svg" />

      <span className="tool-card-title">Amplitude</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect an existing Amplitude project
  </Card>

  <Card href="/recipes/fullstory/how-to-setup">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/EOPlL86k5Zml7IdT/images/recipes/fullstory/logo.png?fit=max&auto=format&n=EOPlL86k5Zml7IdT&q=85&s=cbf22f7a1b0ee7bb73d5bebea3e27ba9" alt="" className="tool-card-logo" width="214" height="214" data-path="images/recipes/fullstory/logo.png" />

      <span className="tool-card-title">FullStory</span>
      <span className="tool-card-badge">Coming Soon</span>
    </div>

    Full setup guide coming soon
  </Card>

  <Card href="/recipes/datadog/how-to-setup">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/lzNTbrNZ8NuMh-AW/images/recipes/datadog/logo.png?fit=max&auto=format&n=lzNTbrNZ8NuMh-AW&q=85&s=06fd27f239a3a81f49dd01241bcaaebb" alt="" className="tool-card-logo" width="1024" height="576" data-path="images/recipes/datadog/logo.png" />

      <span className="tool-card-title">Datadog</span>
      <span className="tool-card-badge">Coming Soon</span>
    </div>

    Full setup guide coming soon
  </Card>

  <Card href="/recipes/pendo/how-to-setup">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/EOPlL86k5Zml7IdT/images/recipes/pendo/logo.png?fit=max&auto=format&n=EOPlL86k5Zml7IdT&q=85&s=eff712522f36569d3ca10a141031c057" alt="" className="tool-card-logo" width="337" height="337" data-path="images/recipes/pendo/logo.png" />

      <span className="tool-card-title">Pendo</span>
      <span className="tool-card-badge">Coming Soon</span>
    </div>

    Full setup guide coming soon
  </Card>
</CardGroup>

## 🤖 Step 2 — Connect your AI support agent

This is where Autoplay actually does its job — giving your existing chatbot live context on what the user's been doing, pulled over MCP the moment it needs it.

<CardGroup cols={3}>
  <Card href="/recipes/intercom-tutorial/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/2qdszPph8ETvQ2n_/images/recipes/intercom/logo.png?fit=max&auto=format&n=2qdszPph8ETvQ2n_&q=85&s=d988e2202e32a1f177df5ecf88e5b80a" alt="" className="tool-card-logo" width="500" height="500" data-path="images/recipes/intercom/logo.png" />

      <span className="tool-card-title">Intercom</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect Fin via MCP
  </Card>

  <Card href="/recipes/maven/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/PRbnKTZCqJLbkGlb/images/recipes/maven/logo.png?fit=max&auto=format&n=PRbnKTZCqJLbkGlb&q=85&s=c5da1f766a872604f9799fcdeb7d108f" alt="" className="tool-card-logo" width="200" height="200" data-path="images/recipes/maven/logo.png" />

      <span className="tool-card-title">Maven</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/ada/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/G4GR7HXGv2qkqJrB/images/recipes/ada/logo.png?fit=max&auto=format&n=G4GR7HXGv2qkqJrB&q=85&s=fc07673697600cc5e1f5fd68bbf73e19" alt="" className="tool-card-logo" width="256" height="256" data-path="images/recipes/ada/logo.png" />

      <span className="tool-card-title">Ada</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/botpress/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/2qdszPph8ETvQ2n_/images/recipes/botpress/logo.png?fit=max&auto=format&n=2qdszPph8ETvQ2n_&q=85&s=f8d309c1a948e46f9fce5ed818f9cb5d" alt="" className="tool-card-logo" width="280" height="280" data-path="images/recipes/botpress/logo.png" />

      <span className="tool-card-title">Botpress</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/dify-tutorial/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/2qdszPph8ETvQ2n_/images/recipes/dify/logo.png?fit=max&auto=format&n=2qdszPph8ETvQ2n_&q=85&s=4041a7537f9c8a1dd93f21bbde03f1d8" alt="" className="tool-card-logo" width="500" height="500" data-path="images/recipes/dify/logo.png" />

      <span className="tool-card-title">Dify</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/crisp-ai/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/292bZ8YoZe3L6wuB/images/recipes/crisp/logo.png?fit=max&auto=format&n=292bZ8YoZe3L6wuB&q=85&s=e004089fa756706691ca073c70a3c6d3" alt="" className="tool-card-logo" width="256" height="256" data-path="images/recipes/crisp/logo.png" />

      <span className="tool-card-title">Crisp AI</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/landbot/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/1eO9uobasAmQK6ML/images/recipes/landbot/logo.png?fit=max&auto=format&n=1eO9uobasAmQK6ML&q=85&s=0f3ecb9ac5c06d0b969219037256dc5c" alt="" className="tool-card-logo" width="352" height="351" data-path="images/recipes/landbot/logo.png" />

      <span className="tool-card-title">Landbot</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/rasa/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/nywCI02jGEWh84vX/images/recipes/rasa/logo.png?fit=max&auto=format&n=nywCI02jGEWh84vX&q=85&s=41afea4e06d786f4e621cac0623bcb16" alt="" className="tool-card-logo" width="234" height="234" data-path="images/recipes/rasa/logo.png" />

      <span className="tool-card-title">Rasa</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/inkeep/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/dJWIjUuJsW8Ne6Y3/images/recipes/inkeep/logo.png?fit=max&auto=format&n=dJWIjUuJsW8Ne6Y3&q=85&s=9e412f7fc884a95a53657d2d540c3622" alt="" className="tool-card-logo" width="128" height="128" data-path="images/recipes/inkeep/logo.png" />

      <span className="tool-card-title">Inkeep</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/tidio/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/1mSeFG0ELCSlhxam/images/recipes/tidio/logo.png?fit=max&auto=format&n=1mSeFG0ELCSlhxam&q=85&s=76bd81b74938eedb15a85e945d76c78b" alt="" className="tool-card-logo" width="225" height="225" data-path="images/recipes/tidio/logo.png" />

      <span className="tool-card-title">Tidio</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card href="/recipes/plain-tutorial/step-1-connect-real-time-events">
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/lDu4s5Oo3AUuQi--/images/recipes/plain/logo.png?fit=max&auto=format&n=lDu4s5Oo3AUuQi--&q=85&s=04d948ea5bb127d275fb830b147548a5" alt="" className="tool-card-logo" width="360" height="360" data-path="images/recipes/plain/logo.png" />

      <span className="tool-card-title">Plain</span>
      <span className="tool-card-arrow">→</span>
    </div>

    Connect via MCP
  </Card>

  <Card>
    <div className="tool-card-header">
      <img src="https://mintcdn.com/autoplayai/dJWIjUuJsW8Ne6Y3/images/recipes/zendesk/logo.png?fit=max&auto=format&n=dJWIjUuJsW8Ne6Y3&q=85&s=b7bb9f99047f9d5afae649e80123edaa" alt="" className="tool-card-logo" width="370" height="225" data-path="images/recipes/zendesk/logo.png" />

      <span className="tool-card-title">Zendesk</span>
      <span className="tool-card-badge">Coming Soon</span>
    </div>

    Full setup guide coming soon
  </Card>
</CardGroup>

## 🗺️ What's next

Session replay and your AI support agent are the two required pillars. Add a user tour provider as an optional extra delivery channel, or go deeper on the SDK:

<CardGroup cols={2}>
  <Card title="Visual user tours" icon="map" href="/recipes/user-tour/overview">
    Trigger Pendo, Usertour, and more from the same event stream — optional
  </Card>

  <Card title="Typed payloads" icon="code" href="/sdk/typed-payloads">
    Explore all fields on ActionsPayload and SummaryPayload
  </Card>

  <Card title="RAG pipeline" icon="database" href="/sdk/rag-example">
    Embed events into a vector store in real time
  </Card>

  <Card title="MCP server" icon="plug" href="/mcp/server">
    Connect any agent to pull live activity via the MCP tool
  </Card>

  <Card title="Proactive onboarding agent" icon="robot" href="/sdk/proactive-onboarding-agent">
    Combine real-time events, memory, and golden paths
  </Card>

  <Card title="AI agent skills" icon="wand-magic-sparkles" href="/get-started/agent-skills">
    Browse, install, and download Cursor / Claude skills
  </Card>
</CardGroup>

For structured logging and `extra` field conventions used across the SDK, see [Logging](/sdk/logging). Release history is on the [Changelog](/changelog).
