[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_115":116},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":48,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","droidrun","moduleId","mobilerun","@droidrun/mobilerun","displayName","tagline","Control real Android and iOS devices with LLM agents — tap, swipe, type, automate flows.","iconKey","https://avatars.githubusercontent.com/u/207381488?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://api.mobilerun.ai/v1/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1784953888000,"updatedAt",1788329694000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.droidrun%2Fmobilerun","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",9169,"upstreamUpdatedAt",1788280943000,"detectedTransport","streamable-http","detectedAuthType","bearer","probeStatus","ok","lastProbedAt",1787633353000,"githubRepoUrl","https://github.com/droidrun/mobilerun","githubRepoFullName","droidrun/mobilerun","releaseId","ext-droidrun-mobilerun","version","1.0.0","descriptionMarkdown","

\n\n

\n Mobilerun is an open-source framework for controlling Android and iOS devices with LLM agents.
\n 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.\n

\n\n

\n\n📕 Documentation\n·\n☁️ Mobilerun Cloud\n·\n🛡️ Mobile Harness\n\n[![GitHub stars](https://img.shields.io/github/stars/droidrun/mobilerun?style=social)](https://github.com/droidrun/mobilerun/stargazers)\n[![mobilerun.ai](https://img.shields.io/badge/mobilerun.ai-white)](https://mobilerun.ai)\n[![Twitter Follow](https://img.shields.io/twitter/follow/mobilerun_ai?style=social)](https://x.com/mobilerun_ai)\n[![Discord](https://img.shields.io/discord/1360219330318696488?color=white&label=Discord&logo=discord&logoColor=white)](https://discord.gg/ZZbKEZZkwK)\n[![Benchmark](https://img.shields.io/badge/Benchmark-91.4﹪-white)](https://mobilerun.ai/benchmark)\n\n\n\n

\n\n\n[Deutsch](https://zdoc.app/de/droidrun/mobilerun) | \n[Español](https://zdoc.app/es/droidrun/mobilerun) | \n[français](https://zdoc.app/fr/droidrun/mobilerun) | \n[日本語](https://zdoc.app/ja/droidrun/mobilerun) | \n[한국어](https://zdoc.app/ko/droidrun/mobilerun) | \n[Português](https://zdoc.app/pt/droidrun/mobilerun) | \n[Русский](https://zdoc.app/ru/droidrun/mobilerun) | \n[中文](https://zdoc.app/zh/droidrun/mobilerun)\n\n

\n\n\n

\n $\"Mobilerun$ \n

\n\n- 🤖 Control Android and iOS devices with natural language commands\n- 🔀 Use OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter, and OpenAI-compatible models\n- 🧠 Run direct tasks or enable reasoning mode for complex multi-step automation\n- 💻 Automate from the CLI, a terminal UI, Docker, or Python code\n- 🐍 Extend agents with custom tools, structured output, app cards, and credentials\n- 📸 Combine accessibility trees with screenshots for visual understanding\n- 🫆 Trace execution with Arize Phoenix or Langfuse\n\nUse 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).\n\n## 📦 Installation\n\n> **Note:** Python 3.14 is not currently supported. Please use Python `>=3.11,<3.14`.\n\nInstall Mobilerun with [`uv`](https://docs.astral.sh/uv/):\n\n```bash\n# CLI usage\nuv tool install mobilerun\n```\n\n```bash\n# CLI + Python integration\nuv pip install mobilerun\n```\n\nMost LLM providers are included by default. For Anthropic support, install the optional extra:\n\n```bash\nuv tool install \"mobilerun[anthropic]\"\n```\n\n## 🚀 Quickstart\n\n```bash\nuv tool install mobilerun\nmobilerun setup\nmobilerun configure\nmobilerun run \"Open settings and turn on dark mode\"\n```\n\nBefore starting, make sure you have [ADB](https://developer.android.com/studio/releases/platform-tools) installed and an Android device with Developer options and USB debugging enabled. iOS setup is supported separately through the iOS Portal flow.\n\n### 1. Install the Portal on your device\n\n```bash\nmobilerun setup\n```\n\nThis installs the Mobilerun Portal app, enables its accessibility service, and prepares the device for local control.\n\n### 2. Verify the connection\n\n```bash\nmobilerun ping\n```\n\nYou should see confirmation that the Portal is installed and accessible.\n\n### 3. Configure your LLM provider\n\n```bash\nmobilerun configure\n```\n\nThe wizard walks you through choosing a provider, auth method, and model. You can also use provider environment variables such as `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `XAI_API_KEY`, or `MINIMAX_API_KEY`.\n\n### 4. Run your first command\n\n```bash\nmobilerun run \"Open the settings app and tell me the Android version\"\n```\n\nUseful run options:\n\n```bash\nmobilerun run \"Open settings and turn on dark mode\"\nmobilerun run \"What app is currently open?\" --vision\nmobilerun run \"Find a contact named John and send him an email\" --reasoning\nmobilerun run \"Take a screenshot\" --ios\nmobilerun run \"Open Settings\" --steps 30 --debug\n```\n\nRead the full [framework documentation](https://docs.mobilerun.ai/framework/quickstart).\n\n## ⚙️ Features\n\n- **CLI:** Run one-off natural language tasks, inspect devices, replay macros, and debug from the terminal.\n- **Python API:** Build custom mobile automation workflows with Python and use custom tools.\n- **Android and iOS support:** Control Android through the Portal app or target iOS through the iOS Portal flow.\n- **Portal-based control:** Use UI trees, screenshots, text input, gestures, app launching, and device state from the Portal runtime.\n- **Vision mode:** Send screenshots to the LLM with `--vision`, or use screenshot-only control with `--vision-only` (useful for the apps that do not have a11y tree information).\n- **Reasoning mode:** Use `--reasoning` for manager-executor planning on longer or more complex tasks.\n- **Tracing and telemetry:** Debug execution with Arize Phoenix, Langfuse, saved trajectories, and detailed logs.\n- **Structured output:** Return structured data from mobile workflows.\n- **App cards and custom tools:** Add app-specific guidance to make agent perform better on your use-cases.\n- **Docker:** Run Mobilerun in a container for repeatable local environments.\n\n## ☁️ Framework vs Cloud\n\n| | Mobilerun Framework | Mobilerun Cloud |\n| --- | --- | --- |\n| Best for | Running agents locally on your own machine and devices | Ready-to-go local phone control, hosted real or virtual devices, API workflows, and managed device operations |\n| Runtime | Your machine | Mobilerun-managed infrastructure |\n| Interface | CLI, Docker, and Python API | Dashboard, REST API, SDKs, and hosted devices |\n\nUse the framework when you want full local control of the agent runtime. Use [Mobilerun Cloud](https://cloud.mobilerun.ai) when you want managed devices, fleet workflows, or cloud APIs without running the agent locally. Learn more in the [framework overview](https://docs.mobilerun.ai/framework/overview) and the [cloud docs](https://docs.mobilerun.ai).\n\n### Which should I choose?\n\n- Choose **Mobilerun Framework** for local agent execution and code-level control.\n- Choose **Mobilerun Cloud** for managed phones, APIs, and scale without running agents locally.\n\n### Cloud Device Types\n\n| Device type | What it is | Best for |\n| --- | --- | --- |\n| Personal | Your own hardware connected to Mobilerun Cloud | Quick automation on devices you own |\n| Cloud Phone (Hosted) | Instantly available cloud-hosted phone | Scalable hosted automation |\n| Physical Phone (Hosted) | Real hardware with stronger identity characteristics | Workflows that need high device authenticity and trust |\n\n### Automate WhatsApp on a Cloud Phone\n\n\n $\"Mobilerun$ \n\n\n## 🧩 Agent Skill\n\nGive Claude Code, Codex, or another coding agent direct control of Android and iOS devices with the [mobile-harness](https://github.com/droidrun/mobile-harness) skill. Copy paste it into your agent:\n\n```text\nSet up https://github.com/droidrun/mobile-harness for me.\n\nRead `install.md` and follow the steps to install `mobile-harness`.\n```\n\nThe skill teaches the agent to drive local devices (ADB, Portal, iOS Simulator) and Mobilerun Cloud phones.\n\n## 🎬 Demo Videos\n\n### Book accommodation from a prompt\n\nShows multi-step navigation, text input, and app-state reasoning while Mobilerun searches for accommodation.\n\n\n $\"Mobilerun$ \n\n\n### Find trending content\n\nShows browsing, app navigation, and result extraction from a natural-language task.\n\n\n $\"Mobilerun$ \n\n\n### Maintain an app streak\n\nShows a short recurring mobile workflow that can be automated from a prompt.\n\n\n $\"Mobilerun$ \n\n\n## 💡 Example Use Cases\n\n- Mobile app QA and regression testing\n- Guided workflows for non-technical users\n- Repetitive task automation on mobile devices\n- Event-driven automation from schedules, notifications, or custom triggers\n- Data extraction from native mobile apps\n- Running automations on multiple devices at once\n\n## 📚 Documentation\n\n- [Framework quickstart](https://docs.mobilerun.ai/framework/quickstart)\n- [Mobilerun cloud quickstart](https://docs.mobilerun.ai/quickstart)\n- [Device setup](https://docs.mobilerun.ai/framework/guides/device-setup)\n- [CLI guide](https://docs.mobilerun.ai/framework/guides/cli)\n- [SDK reference](https://docs.mobilerun.ai/framework/sdk/reference)\n- [Custom tools](https://docs.mobilerun.ai/framework/features/custom-tools)\n- [Agent architecture](https://docs.mobilerun.ai/framework/concepts/architecture)\n- [Structured output](https://docs.mobilerun.ai/framework/features/structured-output)\n- [Tracing](https://docs.mobilerun.ai/framework/features/tracing)\n\n## 👥 Contributing\n\nContributions are welcome. Please feel free to submit a pull request or open an issue.\n\n## 📄 License\n\nThis project is licensed under the MIT License. See [LICENSE](https://github.com/droidrun/mobilerun/blob/main/LICENSE) for details.\n\n## Security Checks\n\nTo help catch security issues before submitting changes, run:\n\n```bash\nbandit -r mobilerun\nsafety scan\n```\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_113":114},"requiredSecrets",[],"tags",[98,99,100,101,102],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","ai-agents","android","android-automation","hacktoberfest","mobile-automation","topics",[98,99,100,101,102],"license","MIT","language","Python","registryName","io.github.droidrun/mobilerun","homepage","https://mobilerun.ai/framework","packages",[],"ENV",{"_117":118,"_119":120,"_121":122},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]