Mobilerun documentation reference. Use when users ask about Mobilerun setup, configuration, SDK usage, CLI commands, device setup, agents, architecture, app cards, credentials, tracing, Docker, migration, structured output, or any Mobilerun "how do I..." questions.
How to install mobilerun?
droidrun/mobilerun
$npx -y skills add droidrun/mobilerun --skill mobilerunInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/droidrun/mobilerun" --skill "droidrun/mobilerun"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/droidrun/mobilerun" that are relevant to the current task. Run `npx skills add "https://github.com/droidrun/mobilerun"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | <picture align="center"> |
| 2 | <source media="(prefers-color-scheme: dark)" srcset="./static/mobilerun-dark.png"> |
| 3 | <source media="(prefers-color-scheme: light)" srcset="./static/mobilerun.png"> |
| 4 | <img src="./static/mobilerun.png" width="full"> |
| 5 | </picture> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <strong>Mobilerun is an open-source framework for controlling Android and iOS devices with LLM agents.</strong><br> |
| 9 | It gives agents mobile-native tools to inspect UI state, understand screenshots, tap, swipe, type, plan multi-step workflows, and return results through a CLI or Python API. |
| 10 | </p> |
| 11 | |
| 12 | <div align="center"> |
| 13 | |
| 14 | <a href="https://docs.mobilerun.ai">📕 Documentation</a> |
| 15 | · |
| 16 | <a href="https://cloud.mobilerun.ai">☁️ Mobilerun Cloud</a> |
| 17 | |
| 18 | [](https://github.com/droidrun/mobilerun/stargazers) |
| 19 | [](https://mobilerun.ai) |
| 20 | [](https://x.com/mobilerun_ai) |
| 21 | [](https://discord.gg/ZZbKEZZkwK) |
| 22 | [](https://mobilerun.ai/benchmark) |
| 23 | |
| 24 | |
| 25 | |
| 26 | <picture> |
| 27 | <source media="(prefers-color-scheme: dark)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810&theme=dark&period=daily&t=1753948032207"> |
| 28 | <source media="(prefers-color-scheme: light)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810&theme=neutral&period=daily&t=1753948125523"> |
| 29 | <a href="https://www.producthunt.com/products/droidrun-framework-for-mobile-agent?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_source=badge-droidrun" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810&theme=neutral&period=daily&t=1753948125523" alt="Droidrun - Give AI native control of physical & virtual phones. | Product Hunt" style="width: 200px; height: 54px;" width="200" height="54" /></a> |
| 30 | </picture> |
| 31 | |
| 32 | |
| 33 | [Deutsch](https://zdoc.app/de/droidrun/mobilerun) | |
| 34 | [Español](https://zdoc.app/es/droidrun/mobilerun) | |
| 35 | [français](https://zdoc.app/fr/droidrun/mobilerun) | |
| 36 | [日本語](https://zdoc.app/ja/droidrun/mobilerun) | |
| 37 | [한국어](https://zdoc.app/ko/droidrun/mobilerun) | |
| 38 | [Português](https://zdoc.app/pt/droidrun/mobilerun) | |
| 39 | [Русский](https://zdoc.app/ru/droidrun/mobilerun) | |
| 40 | [中文](https://zdoc.app/zh/droidrun/mobilerun) |
| 41 | |
| 42 | </div> |
| 43 | |
| 44 | |
| 45 | <p align="center"> |
| 46 | <img src="./static/mobilerun-demo.gif" alt="Mobilerun automating a phone with natural language" width="320"> |
| 47 | </p> |
| 48 | |
| 49 | - 🤖 Control Android and iOS devices with natural language commands |
| 50 | - 🔀 Use OpenAI, Anthropic, Gemini, Ollama, DeepSeek, OpenRouter, and OpenAI-compatible models |
| 51 | - 🧠 Run direct tasks or enable reasoning mode for complex multi-step automation |
| 52 | - 💻 Automate from the CLI, a terminal UI, Docker, or Python code |
| 53 | - 🐍 Extend agents with custom tools, structured output, app cards, and credentials |
| 54 | - 📸 Combine accessibility trees with screenshots for visual understanding |
| 55 | - Trace execution with Arize Phoenix or Langfuse |
| 56 | |
| 57 | Use the framework when you want to run the agent on your machine. Use [Mobilerun Cloud](https://cloud.mobilerun.ai) when you want a ready-to-go solution for your local phones or cloud-hosted virtual/physical phones, managed infrastructure, and API-driven device workflows without running the agent on your local machine. [Check out our benchmark results](https://mobilerun.ai/benchmark). |
| 58 | |
| 59 | ## 📦 Installation |
| 60 | |
| 61 | > **Note:** Python 3.14 is not currently supported. Please use Python `>=3.11,<3.14`. |
| 62 | |
| 63 | Install Mobilerun with [`uv`](https://docs.astral.sh/uv/): |
| 64 | |
| 65 | ```bash |
| 66 | # CLI usage |
| 67 | uv tool install mobilerun |
| 68 | ``` |
| 69 | |
| 70 | ```bash |
| 71 | # CLI + Python integration |
| 72 | uv pip install mobilerun |
| 73 | ``` |
| 74 | |
| 75 | Most LLM prov |
Related
6 picksType
- react-native-skillsReact Native and Expo best practices for building performant mobile apps.Jul 2026
- imagegen-frontend-mobileElite mobile app image-generation skill for creating premium, app-native screen concepts and flows.Jul 2026
- firebase-crashlyticsComprehensive guide for Firebase Crashlytics, including provisioning and SDK usage.Jul 2026
- xcode-project-setupSafely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g.Jul 2026
- expo-tailwind-setupFramework (OSS). Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal stylingJul 2026
- expo-dev-clientFramework (OSS). Build and distribute Expo development clients locally or via TestFlight for internal testing.Jul 2026
