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

# iOS

> Run Equos characters natively on iPhone and iPad with on-device rendering.

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/equos/RV3tbha5YUecIT-t/images/ios.png?fit=max&auto=format&n=RV3tbha5YUecIT-t&q=85&s=a2ce365ed919672c0821f30a7646227d" alt="Equos character rendered inside an iOS app" width="828" height="1792" data-path="images/ios.png" />
  </Frame>

  <div>
    <p>The Equos iOS SDK brings the full character experience to native iOS apps, with <strong>rendering running directly on the device</strong> for real-time performance at any scale.</p>
    <p> </p>
    <p>It runs smoothly on consumer hardware going back to the <strong>iPhone 11</strong>, and can be used either with the full Equos voice pipeline or paired with your own audio stack.</p>
    <p> </p>
    <p><strong>Drop-in simple.</strong> A single component handles video rendering, audio capture, and session lifecycle—no WebRTC wiring, no custom track management, no boilerplate. Your app starts a conversation in a few lines of Swift.</p>
    <p> </p>
    <p><strong>Lowest possible latency.</strong> Because video is rendered directly on the phone, there's no cloud round-trip for every frame. Responses feel instant, even on cellular networks—and entirely network-free when paired with your own on-device audio stack.</p>
  </div>
</Columns>

***

## Two ways to use it

<CardGroup cols={2}>
  <Card icon="headset" title="Full pipeline">
    Connect to the Equos voice agent and get the full experience: character video, audio, and conversational AI—the same flow as the Web and Next.js integrations.
  </Card>

  <Card icon="video" title="Video rendering only">
    Use the SDK purely for on-device character rendering and plug in **your own voice pipeline**. No network required for video—and no per-minute cost.
  </Card>
</CardGroup>

### Full pipeline

Ideal if you want the fastest path to a complete character experience on mobile.

Unlike the web integration, **you do not create a conversation up front**. Instead:

1. Your backend generates a short-lived **consumer access token** by calling the dedicated Equos API endpoint.
2. Your app passes the token to the iOS SDK.
3. The SDK starts the conversation directly—audio, video, and AI all managed by Equos.

<Note>
  This removes a round-trip: there's no "create conversation, then join" dance. The token alone is enough for the SDK to stand up the live session.
</Note>

### Video-only, bring your own voice

Ideal if you already run your own voice stack (STT/LLM/TTS, or a real-time audio model) and only need a high-quality animated face.

In this mode, **no token, no backend call, no network required**. The iOS SDK renders the character on-device from your audio stream the moment you start it—**no Equos network calls, no per-user cost, unlimited usage**.

This is what makes Equos unique: our rendering model runs in real time on consumer iPhones (including iPhone 11), which means you can ship an animated AI character to millions of users without provisioning a single GPU.

<Card icon="bolt" title="Learn more about on-device rendering" href="/on-device-rendering">
  How Equos scales to millions of users by running on the device itself.
</Card>

***

## Availability

The iOS SDK is currently **private**. We work directly with teams to integrate it into their apps.

<Card title="Request a demo" icon="envelope" href="https://docs.google.com/forms/d/e/1FAIpQLSdoK7LvORdQf7KOQKvhhlESStJcKc3bDB9HPsEet6LuOmVUfQ/viewform">
  Get in touch for a walkthrough, early access, and integration support.
</Card>
