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

# Quickstart

> Run your first AI agent on a real mobile device, in the cloud or on your own hardware.

Mobilerun runs AI agents that control real Android and iOS devices. Give the agent a natural
language goal such as *"open Settings and turn on dark mode"* and it taps, swipes, and types its
way to the result.

There are two ways to use Mobilerun. Pick the path that matches your project and then follow its
quickstart.

<CardGroup cols={2}>
  <Card title="Cloud API, SDK and MCP" icon="cloud" href="/cloud/quickstart">
    Hosted devices with zero local setup. Authenticate with a `dr_sk_` key and call the REST API,
    the TypeScript or Python SDK, or the MCP server. **Start here for most integrations.**
  </Card>

  <Card title="Framework, open source and local" icon="terminal" href="/framework/quickstart">
    Run the open source `mobilerun` Python package on your own machine against your own Android
    device over adb. Bring your own LLM provider key.
  </Card>
</CardGroup>

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/Gz1wSeYVlB0" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Which path is right for me?

|               | Cloud                                                | Framework                                     |
| ------------- | ---------------------------------------------------- | --------------------------------------------- |
| Where it runs | Mobilerun's hosted devices                           | Your machine and your device                  |
| Setup         | None, you provision a device in the dashboard        | Install Python, adb, and the Portal APK       |
| Auth          | Mobilerun key (`dr_sk_...`) plus [credits](/credits) | Your own LLM provider key                     |
| Languages     | TypeScript, Python, REST, MCP                        | Python                                        |
| Best for      | Production automation, CI, scaling                   | Local development, full control, self hosting |

## Two kinds of API keys

Mobilerun involves two **separate** credentials. Knowing which one you need avoids the most
common setup mistake.

* **Mobilerun cloud key (`dr_sk_...`)** authenticates you to the Cloud API, SDK, and MCP server.
  The agent's LLM calls are billed from your [credit](/credits) balance, so you do **not** need
  your own model key. Create one on the [API Keys](/api-keys) page.
* **LLM provider key (`GOOGLE_API_KEY`, `OPENAI_API_KEY`, and similar)** is used only by the open
  source [Framework](/framework/quickstart) running on your own machine. The Framework calls the
  model provider directly, so there are no Mobilerun credits and no `dr_sk_` key involved.

<Note>
  If you use the Cloud you only need a `dr_sk_` key. If you run the Framework locally you only need
  an LLM provider key. A single path never needs both.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Cloud Quickstart" icon="rocket" href="/cloud/quickstart">
    Run your first cloud task in TypeScript, Python, or cURL.
  </Card>

  <Card title="Framework Quickstart" icon="rocket" href="/framework/quickstart">
    Install the open source package and run a local agent.
  </Card>

  <Card title="API Keys" icon="key" href="/api-keys">
    Create and manage your `dr_sk_` cloud keys.
  </Card>

  <Card title="Agent configuration" icon="sliders-horizontal" href="/agent">
    Every task parameter, including models, vision, reasoning, stealth, memory, and structured
    output.
  </Card>
</CardGroup>