DroidRun

DroidRun is an open-source (MIT) framework for controlling Android and iOS devices through LLM agents. It enables mobile automation using natural language commands.

• GitHub: https://github.com/droidrun/droidrun
• Docs site: https://docs.droidrun.ai
• License: MIT
• Install: uv tool install droidrun (Google Gemini, OpenAI, Ollama, OpenRouter included by default)
• Optional extras: anthropic, deepseek, langfuse
• Requires: Python 3.11+, ADB, Portal APK on device

Architecture

DroidRun uses a multi-agent architecture coordinated by DroidAgent:

• Reasoning mode (reasoning=True): Manager plans → Executor acts → loop until done
• Direct mode (reasoning=False): CodeActAgent generates and executes Python code directly