mobilerun
Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖
What is mobilerun?
Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖
Overview of mobilerun
What it is
Mobilerun is an open-source framework for mobile app testing, QA, and running AI agents on real Android and iOS devices. 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.
Key features
- 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 cases
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.
Getting started
See the repository README for installation and quick-start instructions. Note: Python 3.14 is not currently supported. Please use Python >=3.11.
License and pricing
License: MIT. Pricing: open source.
Based on the project's public README and repository metadata.