{"id":49012482,"url":"https://github.com/droidrun/mobilerun","last_synced_at":"2026-04-22T20:00:50.517Z","repository":{"id":288272272,"uuid":"965313467","full_name":"droidrun/mobilerun","owner":"droidrun","description":"Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖","archived":false,"fork":false,"pushed_at":"2026-04-16T13:55:23.000Z","size":85531,"stargazers_count":8171,"open_issues_count":33,"forks_count":850,"subscribers_count":50,"default_branch":"main","last_synced_at":"2026-04-16T15:29:12.856Z","etag":null,"topics":["ai-agents","android","android-automation","hacktoberfest","mobile-automation"],"latest_commit_sha":null,"homepage":"https://mobilerun.ai/framework","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/droidrun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-12T22:03:47.000Z","updated_at":"2026-04-16T14:08:18.000Z","dependencies_parsed_at":"2025-04-16T19:11:45.003Z","dependency_job_id":"7bcdccb2-519f-4ebf-a8b3-bebf12f8be70","html_url":"https://github.com/droidrun/mobilerun","commit_stats":null,"previous_names":["droidrun/droidrun"],"tags_count":82,"template":false,"template_full_name":null,"purl":"pkg:github/droidrun/mobilerun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fmobilerun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fmobilerun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fmobilerun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fmobilerun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/droidrun","download_url":"https://codeload.github.com/droidrun/mobilerun/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fmobilerun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32152607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","android","android-automation","hacktoberfest","mobile-automation"],"created_at":"2026-04-19T00:00:56.406Z","updated_at":"2026-04-22T20:00:50.493Z","avatar_url":"https://github.com/droidrun.png","language":"Python","funding_links":[],"categories":["Python","AI Agent Frameworks \u0026 SDKs"],"sub_categories":["Multi-Agent Collaboration Systems"],"readme":"\u003cpicture align=\"center\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./static/mobilerun-dark.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./static/mobilerun.png\"\u003e\n  \u003cimg src=\"./static/mobilerun.png\"  width=\"full\"\u003e\n\u003c/picture\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\n[![Docs](https://img.shields.io/badge/Docs-📕-0D9373?style=for-the-badge)](https://docs.mobilerun.ai)\n[![Cloud](https://img.shields.io/badge/Cloud-☁️-0D9373?style=for-the-badge)](https://cloud.mobilerun.ai/sign-in?waitlist=true)\n\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\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://discord.gg/ZZbKEZZkwK)\n[![Benchmark](https://img.shields.io/badge/Benchmark-91.4﹪-white)](https://mobilerun.ai/benchmark)\n\n\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810\u0026theme=dark\u0026period=daily\u0026t=1753948032207\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810\u0026theme=neutral\u0026period=daily\u0026t=1753948125523\"\u003e\n  \u003ca href=\"https://www.producthunt.com/products/droidrun-framework-for-mobile-agent?embed=true\u0026utm_source=badge-top-post-badge\u0026utm_medium=badge\u0026utm_source=badge-droidrun\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983810\u0026theme=neutral\u0026period=daily\u0026t=1753948125523\" alt=\"Droidrun - Give\u0026#0032;AI\u0026#0032;native\u0026#0032;control\u0026#0032;of\u0026#0032;physical\u0026#0032;\u0026#0038;\u0026#0032;virtual\u0026#0032;phones\u0026#0046; | Product Hunt\" style=\"width: 200px; height: 54px;\" width=\"200\" height=\"54\" /\u003e\u003c/a\u003e\n\u003c/picture\u003e\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\u003c/div\u003e\n\n\nMobilerun a powerful framework for controlling Android and iOS devices through LLM agents. It allows you to automate device interactions using natural language commands. [Checkout our benchmark results](https://mobilerun.ai/benchmark)\n\n\n- 🤖 Control Android and iOS devices with natural language commands\n- 🔀 Supports multiple LLM providers (OpenAI, Anthropic, Gemini, Ollama, DeepSeek)\n- 🧠 Planning capabilities for complex multi-step tasks\n- 💻 Easy to use CLI with enhanced debugging features\n- 🐍 Extendable Python API for custom automations\n- 📸 Screenshot analysis for visual understanding of the device\n- 🫆 Execution tracing with Arize Phoenix\n\n## 📦 Installation\n\n\u003e **Note:** Python 3.14 is not currently supported. Please use Python 3.11 – 3.13.\n\n```bash\npip install mobilerun\n```\n\n## 🚀 Quickstart\n\n### 1. Install the portal on your device\n```bash\nmobilerun setup\n```\n\n### 2. Configure your LLM provider\n```bash\nmobilerun configure\n```\nThis walks you through choosing a provider (Gemini, OpenAI, Anthropic, etc.), auth method (API key or OAuth), and model.\n\n### 3. Run a command\n```bash\nmobilerun run \"open settings and turn on dark mode\"\n```\n\nRead the full guide in [our docs](https://docs.mobilerun.ai/v3/quickstart)!\n\n[![Quickstart Video](https://img.youtube.com/vi/4WT7FXJah2I/0.jpg)](https://www.youtube.com/watch?v=4WT7FXJah2I)\n\n## 🎬 Demo Videos\n\n1. **Accommodation booking**: Let Mobilerun search for an apartment for you\n\n   [![Mobilerun Accommodation Booking Demo](https://img.youtube.com/vi/VUpCyq1PSXw/0.jpg)](https://youtu.be/VUpCyq1PSXw)\n\n\u003cbr\u003e\n\n2. **Trend Hunter**: Let Mobilerun hunt down trending posts\n\n   [![Mobilerun Trend Hunter Demo](https://img.youtube.com/vi/7V8S2f8PnkQ/0.jpg)](https://youtu.be/7V8S2f8PnkQ)\n\n\u003cbr\u003e\n\n3. **Streak Saver**: Let Mobilerun save your streak on your favorite language learning app\n\n   [![Mobilerun Streak Saver Demo](https://img.youtube.com/vi/B5q2B467HKw/0.jpg)](https://youtu.be/B5q2B467HKw)\n\n\n## 💡 Example Use Cases\n\n- Automated UI testing of mobile applications\n- Creating guided workflows for non-technical users\n- Automating repetitive tasks on mobile devices\n- Remote assistance for less technical users\n- Exploring mobile UI with natural language commands\n\n## 👥 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details. \n\n## Security Checks\n\nTo ensure the security of the codebase, we have integrated security checks using `bandit` and `safety`. These tools help identify potential security issues in the code and dependencies.\n\n### Running Security Checks\n\nBefore submitting any code, please run the following security checks:\n\n1. **Bandit**: A tool to find common security issues in Python code.\n   ```bash\n   bandit -r mobilerun\n   ```\n\n2. **Safety**: A tool to check your installed dependencies for known security vulnerabilities.\n   ```bash\n   safety scan\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidrun%2Fmobilerun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdroidrun%2Fmobilerun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidrun%2Fmobilerun/lists"}