droidrun/mobilerun

这是什么？

核心功能

• 01通过自然语言指令控制 Android 和 iOS 设备
• 02兼容 OpenAI、Anthropic、Gemini、Ollama、DeepSeek 等模型及 OpenAI 兼容接口
• 03结合无障碍树与截图理解界面，也支持仅截图模式
• 04提供 CLI、Docker 镜像和带自定义工具的 Python API
• 05支持推理模式处理多步任务，并可通过 Phoenix 或 Langfuse 追踪执行过程

适用场景

• 用自然语言描述步骤进行移动应用测试与回归验证
• 自动化一台或多台手机上的重复性操作
• 从没有公开 API 的原生移动应用中提取数据
• 通过 Python API 在脚本或定时任务中运行手机自动化流程

快速上手

1. 1

   使用 uv 安装命令行工具

   uv tool install mobilerun
2. 2

   在 Android 设备上安装 Portal 应用并启用其无障碍服务（需要 ADB 和 USB 调试）

   mobilerun setup
3. 3

   配置你的大模型提供商

   mobilerun configure
4. 4

   运行第一个自然语言任务

   mobilerun run "Open settings and turn on dark mode"

使用前须知

• !需要付费的大模型提供商 API 密钥，或自行配置本地模型。
• !不支持 Python 3.14，请使用 Python 3.11 至 3.13。
• !控制 Android 设备需要 ADB 以及开启了 USB 调试的设备。

标签

常见问题

mobilerun 是什么？

开源 Python 框架，让 LLM 智能体通过自然语言、CLI 或 Python API 操控 Android 和 iOS 手机。 Mobilerun 是一个让大语言模型智能体操作移动设备的框架。给定一条自然语言指令，例如“打开设置并开启深色模式”，智能体会读取设备的界面状态，必要时结合截图，逐步完成点击、滑动和文字输入，直到任务结束。

mobilerun 可以免费使用吗？用的什么许可证？

mobilerun 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mobilerun 还在维护吗？

活跃维护中。mobilerun 最近一次提交是在 2026年10月16日。

mobilerun 适合用来做什么？

用自然语言描述步骤进行移动应用测试与回归验证 自动化一台或多台手机上的重复性操作 从没有公开 API 的原生移动应用中提取数据 通过 Python API 在脚本或定时任务中运行手机自动化流程

mobilerun 怎么安装和运行？

使用 uv 安装命令行工具: uv tool install mobilerun 在 Android 设备上安装 Portal 应用并启用其无障碍服务（需要 ADB 和 USB 调试）: mobilerun setup 配置你的大模型提供商: mobilerun configure 运行第一个自然语言任务: mobilerun run "Open settings and turn on dark mode"

在哪里获取 mobilerun？

源代码和安装说明在 GitHub 上：https://github.com/droidrun/mobilerun