{"id":28621861,"url":"https://github.com/droidrun/droidrun","last_synced_at":"2026-04-02T23:48:53.711Z","repository":{"id":288272272,"uuid":"965313467","full_name":"droidrun/droidrun","owner":"droidrun","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-08T12:48:38.000Z","size":81133,"stargazers_count":3051,"open_issues_count":12,"forks_count":274,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-06-08T13:19:54.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://droidrun.ai","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":"CHANGELOG.md","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}},"created_at":"2025-04-12T22:03:47.000Z","updated_at":"2025-06-08T12:08:17.000Z","dependencies_parsed_at":"2025-04-16T19:11:45.003Z","dependency_job_id":"7bcdccb2-519f-4ebf-a8b3-bebf12f8be70","html_url":"https://github.com/droidrun/droidrun","commit_stats":null,"previous_names":["droidrun/droidrun"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/droidrun/droidrun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fdroidrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fdroidrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fdroidrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fdroidrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/droidrun","download_url":"https://codeload.github.com/droidrun/droidrun/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/droidrun%2Fdroidrun/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259402056,"owners_count":22851870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-06-12T05:02:23.185Z","updated_at":"2026-04-02T23:48:53.704Z","avatar_url":"https://github.com/droidrun.png","language":"Python","readme":"\u003cpicture align=\"center\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./static/droidrun-dark.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./static/droidrun.png\"\u003e\n  \u003cimg src=\"./static/droidrun.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.droidrun.ai)\n[![Cloud](https://img.shields.io/badge/Cloud-☁️-0D9373?style=for-the-badge)](https://cloud.droidrun.ai/sign-in?waitlist=true)\n\n\n[![GitHub stars](https://img.shields.io/github/stars/droidrun/droidrun?style=social)](https://github.com/droidrun/droidrun/stargazers)\n[![droidrun.ai](https://img.shields.io/badge/droidrun.ai-white)](https://droidrun.ai)\n[![Twitter Follow](https://img.shields.io/twitter/follow/droid_run?style=social)](https://x.com/droid_run)\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://droidrun.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/droidrun) | \n[Español](https://zdoc.app/es/droidrun/droidrun) | \n[français](https://zdoc.app/fr/droidrun/droidrun) | \n[日本語](https://zdoc.app/ja/droidrun/droidrun) | \n[한국어](https://zdoc.app/ko/droidrun/droidrun) | \n[Português](https://zdoc.app/pt/droidrun/droidrun) | \n[Русский](https://zdoc.app/ru/droidrun/droidrun) | \n[中文](https://zdoc.app/zh/droidrun/droidrun)\n\n\u003c/div\u003e\n\n\n\nMobilerun is a cloud solution powered by Droidrun 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://droidrun.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 droidrun\n```\n\n## 🚀 Quickstart\nRead on how to get droidrun up and running within seconds in [our docs](https://docs.droidrun.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 Droidrun search for an apartment for you\n\n   [![Droidrun Accommodation Booking Demo](https://img.youtube.com/vi/VUpCyq1PSXw/0.jpg)](https://youtu.be/VUpCyq1PSXw)\n\n\u003cbr\u003e\n\n2. **Trend Hunter**: Let Droidrun hunt down trending posts\n\n   [![Droidrun Trend Hunter Demo](https://img.youtube.com/vi/7V8S2f8PnkQ/0.jpg)](https://youtu.be/7V8S2f8PnkQ)\n\n\u003cbr\u003e\n\n3. **Streak Saver**: Let Droidrun save your streak on your favorite language learning app\n\n   [![Droidrun 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 droidrun\n   ```\n\n2. **Safety**: A tool to check your installed dependencies for known security vulnerabilities.\n   ```bash\n   safety scan\n   ```\n","funding_links":[],"categories":["A01_文本生成_文本对话","Python","Personal Assistants \u0026 Conversational Agents"],"sub_categories":["大语言对话模型及数据","Chatbots"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidrun%2Fdroidrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdroidrun%2Fdroidrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidrun%2Fdroidrun/lists"}