LibreAI / AI Agents / mobilerun
// agents · droidrun/mobilerun

mobilerun

Control Android and iOS devices with natural language — an LLM-agnostic mobile agent framework and CLI.

★ 9.6k stars⑂ 1.0k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mobilerun is an open-source ai agents project by droidrun (droidrun/mobilerun on GitHub). It has 9,590 GitHub stars and 1,021 forks, is released under the MIT license, and was last updated on GitHub on 5 October 2026.

GitHub stars
9,590
Forks
1,021
License
MIT
Last updated on GitHub
5 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the task in plain language, which device (physical, emulator or cloud) you will use, and which LLM provider will drive the agent.

  2. Get the project

    Clone droidrun/mobilerun from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Install the mobilerun package, install the Portal app on the device, and configure your LLM provider credentials.

  4. Run your first task

    Verify the device connection, then run a single natural-language command — for example opening an app and completing a simple flow — and inspect the trace.

// features

Why people love it

Natural-language control

Run one-off tasks from the CLI in plain language, or build custom workflows with the Python API and custom tools.

Android and iOS support

Control Android through the Portal app, or target iOS through the iOS Portal flow.

Portal-based perception

The agent uses UI trees, screenshots, text input, gestures, app launching and device state from the Portal runtime.

Vision and reasoning modes

--vision sends screenshots to the LLM, --vision-only controls by screenshot alone, and --reasoning enables manager-executor planning for longer tasks.

Tracing and telemetry

Debug executions with Arize Phoenix, Langfuse, saved trajectories and detailed logs.

Structured output and app cards

Return structured data from mobile workflows, and add app-specific guidance cards so the agent performs better on your apps.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for mobilerun.

    git clone https://github.com/droidrun/mobilerun.git
    cd mobilerun
  2. Install Mobilerun

    Install the package with uv as the README's installation section shows, then install the Portal on your device.

    uv pip install mobilerun
  3. Run your first command

    After verifying the Portal connection and configuring your LLM provider, run a natural-language task from the CLI.

    mobilerun "Open Settings and turn on Wi-Fi"  # see README quickstart for exact CLI syntax
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains mobilerun?

The droidrun team, through the droidrun/mobilerun repository, with the framework site at mobilerun.ai.

Is mobilerun free to use?

Yes — the project is open source under the MIT license as recorded for this listing. You can use, modify and distribute it under the MIT terms.

Does mobilerun need a paid API key?

The framework is LLM-agnostic but needs an LLM you configure — typically your own API key for a provider, billed by that provider; Mobilerun itself is free.

How does Mobilerun compare to Appium-style test automation?

Appium scripts specify every tap and selector and break when UIs change. Mobilerun describes the goal in natural language and lets an LLM plan through the live UI tree and screenshots — more flexible, but dependent on model quality and cost per run.

How do I get started with mobilerun?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — verify the device connection, then run a single natural-language command — for example opening an app and completing a simple flow — and inspect the trace.

// keep exploring

Similar tools

AI Agents

page-agent

Alibaba's in-page GUI agent: control any web interface with natural language, from one script tag

★ 29.4k starsMIT
View guide →
Agents

OpenGUI

Android GUI agent framework: AI that sees, plans, and taps real mobile apps.

★ 1.8k starsCustom
View guide →
AI Agents

MetaGPT

🌟 The Multi-Agent Framework: First AI Software Company, Towards Natural Language Programming

★ 70.7k starsMIT
View guide →
AI Agents

TradingAgents

Multi-agent LLM framework that mirrors a trading firm: analysts, researchers, trader and risk team

★ 110.3k starsApache-2.0
View guide →
AI Agents

mobile-use

AI agents that use real Android and iOS apps like a human — from minitap.

★ 3.2k starsApache-2.0
View guide →
AI Agents

UFO

Microsoft's GUI agent that grew into UFO³ — orchestrating agents across Windows, Linux and mobile devices.

★ 10.0k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if mobilerun is not the right fit.

Get mobilerun

Free and open — grab the source, star the repo, and start creating.