https://github.com/droidrun/droidrun

https://github.com/droidrun/droidrun

Last synced: 30 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/droidrun/droidrun
• Owner: droidrun
• License: mit
• Created: 2025-04-12T22:03:47.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-08T12:48:38.000Z (11 months ago)
• Last Synced: 2025-06-08T13:19:54.571Z (11 months ago)
• Language: Python
• Homepage: https://droidrun.ai
• Size: 77.4 MB
• Stars: 3,051
• Watchers: 20
• Forks: 274
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• StarryDivineSky - droidrun/droidrun
• awesome-ai-agents - droidrun/droidrun - DroidRun is a powerful framework that enables control and automation of Android and iOS devices using natural language commands through large language model agents. (Personal Assistants & Conversational Agents / Chatbots)
• my-awesome - droidrun/droidrun - agents,android,android-automation,hacktoberfest,mobile-automation pushed_at:2026-04 star:8.2k fork:0.8k Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖 (Python)

README

          

  

  

  



[![Docs](https://img.shields.io/badge/Docs-📕-0D9373?style=for-the-badge)](https://docs.droidrun.ai)

[![Cloud](https://img.shields.io/badge/Cloud-☁️-0D9373?style=for-the-badge)](https://cloud.droidrun.ai/sign-in?waitlist=true)

[![GitHub stars](https://img.shields.io/github/stars/droidrun/droidrun?style=social)](https://github.com/droidrun/droidrun/stargazers)

[![droidrun.ai](https://img.shields.io/badge/droidrun.ai-white)](https://droidrun.ai)

[![Twitter Follow](https://img.shields.io/twitter/follow/droid_run?style=social)](https://x.com/droid_run)

[![Discord](https://img.shields.io/discord/1360219330318696488?color=white&label=Discord&logo=discord&logoColor=white)](https://discord.gg/ZZbKEZZkwK)

[![Benchmark](https://img.shields.io/badge/Benchmark-91.4﹪-white)](https://droidrun.ai/benchmark)

  

  

  

[Deutsch](https://zdoc.app/de/droidrun/droidrun) | 

[Español](https://zdoc.app/es/droidrun/droidrun) | 

[français](https://zdoc.app/fr/droidrun/droidrun) | 

[日本語](https://zdoc.app/ja/droidrun/droidrun) | 

[한국어](https://zdoc.app/ko/droidrun/droidrun) | 

[Português](https://zdoc.app/pt/droidrun/droidrun) | 

[Русский](https://zdoc.app/ru/droidrun/droidrun) | 

[中文](https://zdoc.app/zh/droidrun/droidrun)



Mobilerun 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)

- 🤖 Control Android and iOS devices with natural language commands

- 🔀 Supports multiple LLM providers (OpenAI, Anthropic, Gemini, Ollama, DeepSeek)

- 🧠 Planning capabilities for complex multi-step tasks

- 💻 Easy to use CLI with enhanced debugging features

- 🐍 Extendable Python API for custom automations

- 📸 Screenshot analysis for visual understanding of the device

- 🫆 Execution tracing with Arize Phoenix

## 📦 Installation

> **Note:** Python 3.14 is not currently supported. Please use Python 3.11 – 3.13.

```bash

pip install droidrun

```

## 🚀 Quickstart

Read on how to get droidrun up and running within seconds in [our docs](https://docs.droidrun.ai/v3/quickstart)!   

[![Quickstart Video](https://img.youtube.com/vi/4WT7FXJah2I/0.jpg)](https://www.youtube.com/watch?v=4WT7FXJah2I)

## 🎬 Demo Videos

1. **Accommodation booking**: Let Droidrun search for an apartment for you

   [![Droidrun Accommodation Booking Demo](https://img.youtube.com/vi/VUpCyq1PSXw/0.jpg)](https://youtu.be/VUpCyq1PSXw)




2. **Trend Hunter**: Let Droidrun hunt down trending posts

   [![Droidrun Trend Hunter Demo](https://img.youtube.com/vi/7V8S2f8PnkQ/0.jpg)](https://youtu.be/7V8S2f8PnkQ)




3. **Streak Saver**: Let Droidrun save your streak on your favorite language learning app

   [![Droidrun Streak Saver Demo](https://img.youtube.com/vi/B5q2B467HKw/0.jpg)](https://youtu.be/B5q2B467HKw)

## 💡 Example Use Cases

- Automated UI testing of mobile applications

- Creating guided workflows for non-technical users

- Automating repetitive tasks on mobile devices

- Remote assistance for less technical users

- Exploring mobile UI with natural language commands

## 👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details. 

## Security Checks

To 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.

### Running Security Checks

Before submitting any code, please run the following security checks:

1. **Bandit**: A tool to find common security issues in Python code.

   ```bash

   bandit -r droidrun

   ```

2. **Safety**: A tool to check your installed dependencies for known security vulnerabilities.

   ```bash

   safety scan

   ```