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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/droidrunmobilerun.svg)](https://yunodb.com/tools/droidrunmobilerun?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/droidrunmobilerun?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/droidrunmobilerun.svg" alt="Featured on YunoDB" height="20"></a>