# droidrun/mobilerun

Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖

Repository: https://github.com/droidrun/mobilerun
Canonical: https://ross.abutalabs.com/products/mobilerun
Homepage: https://mobilerun.ai/framework
Language: Python
License: MIT
License Family: permissive
Topics: ai-agents, android, android-automation, hacktoberfest, mobile-automation
Last push: 2026-08-25T11:05:21+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 36
- inputs: {"age_days": 508, "days_push": 8, "days_rel": 19, "gap_med": 3.0, "n_releases_24m": 59}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9127, forks 980 (observed 2026-08-28T04:10:28.521497+00:00)

## What it is
Mobilerun is an open-source Python framework for controlling Android and iOS devices with LLM-powered agents using natural language commands. It provides mobile-native tools for tapping, swiping, typing, and inspecting UI state, with a CLI, Python API, and an optional hosted cloud service.

## Use cases
- automate android apps with natural language commands
- control an iphone with an llm agent
- write mobile app tests in plain english instead of appium
- scrape data from mobile apps without a public api
- run multi-step workflows across mobile apps
- give claude or cursor control of a real phone via mcp

## When to choose
- you need to automate tasks on real Android or iOS devices with an LLM agent
- you want an LLM-agnostic framework where you can swap providers like OpenAI, Anthropic, Gemini, or Ollama
- you want to self-host automation against your own device over adb
- you need mobile app testing or data extraction without public APIs

## When to avoid
- you only need web browser automation rather than native mobile apps
- you need a fully free solution and cannot afford LLM API costs or the hosted device cloud
- you require deterministic, script-based mobile testing without LLM nondeterminism
- your target platform is desktop or non-mobile

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, workflow-automation, llm-inference, cli, sdk, mcp
- domain: mobile-development, large-language-models, developer-tools
- platform: python, cli, cross-platform
- tags: mobile-automation, android-automation, llm-agent, adb, device-control, ui-automation, mobile-testing, data-extraction, ai-agents, automation, android, ios

## Member repositories
- droidrun/mobilerun (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:28.521497+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:23:25.330987+00:00, confidence not recorded.
  - readme: https://github.com/droidrun/mobilerun (fetched 2026-08-28T04:10:28.521497+00:00, sha 6ef28dfdd971)
  - homepage: https://mobilerun.ai/framework (fetched 2026-08-29T08:23:38.379452+00:00, sha 1f981f985142)
  - site_page: https://docs.mobilerun.ai (fetched 2026-08-29T08:23:38.390790+00:00, sha fd36d11d4dd9)
  - registry_pypi: https://pypi.org/pypi/mobilerun/json (fetched 2026-08-29T08:23:38.397332+00:00, sha 02c5fbf902c6)
  - site_page: https://mobilerun.ai/pricing (fetched 2026-08-29T08:23:38.388730+00:00, sha 44abe62654d2)
  - site_page: https://mobilerun.ai/changelog (fetched 2026-08-29T08:23:38.392780+00:00, sha c1a59b9e41b1)
  - site_page: https://mobilerun.ai/integrations (fetched 2026-08-29T08:23:38.395039+00:00, sha 30cc6f4e9699)
- Data as of 2026-08-30T08:39:29.467469+00:00.