droidrun / mobilerun

Mobilerun is an open-source framework for controlling Android and iOS devices with LLM agents. 
 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.
 📕 Documentation 
·
 ☁️ Mobilerun Cloud 
·
 🛡️ Mobile Harness 
Deutsch | 
Español | 
français | 
日本語 | 
한국어 | 
Português | 
Русский | 
中文
- 🤖 Control Android and iOS devices with natural language commands
- 🔀 Use OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter, and OpenAI-compatible models
- 🧠 Run direct tasks or enable reasoning mode for complex multi-step automation
- 💻 Automate from the CLI, a terminal UI, Docker, or Python code
- 🐍 Extend agents with custom tools, structured output, app cards, and credentials
- 📸 Combine accessibility trees with screenshots for visual understanding
- 🫆 Trace execution with Arize Phoenix or Langfuse
Use the framework when you want to run the agent on your machine. Use Mobilerun Cloud 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.
## 📦 Installation
> **Note:** Python 3.14 is not currently supported. Please use Python `>=3.11, 
### Generate leads with Google Maps on a Cloud Phone
## 🧩 Agent Skill
Give Claude Code, Codex, or another coding agent direct control of Android and iOS devices with the mobile-harness skill. Copy paste it into your agent:
 [code] 
The skill teaches the agent to drive local devices (ADB, Portal, iOS Simulator) and Mobilerun Cloud phones.
## 🎬 Demo Videos
### Book accommodation from a prompt
Shows multi-step navigation, text input, and app-state reasoning while Mobilerun searches for accommodation.
### Find trending content
Shows browsing, app navigation, and result extraction from a natural-language task.
## 💡 Example Use Cases
- Mobile app QA and regression testing
- Guided workflows for non-technical users
- Repetitive task automation on mobile devices
- Event-driven automation from schedules, notifications, or custom triggers
- Data extraction from native mobile apps
- Running automations on multiple devices at once
## 📚 Documentation
- Framework quickstart
- Mobilerun cloud quickstart
- Device setup
- CLI guide
- SDK reference
- Custom tools
- Agent architecture
- Structured output
- Tracing
## 👥 Contributing
Contributions are welcome. Please feel free to submit a pull request or open an issue.
## 📄 License
This project is licensed under the MIT License. See LICENSE for details.
## Security Checks
To help catch security issues before submitting changes, run:
 [code]