droidrun/mobilerun
AI 工程用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。
项目介绍
Mobilerun 是一个开源框架,用于移动 App 测试、QA,以及在真实 Android 和 iOS 设备上运行 AI Agent。它把移动端的原生能力交给大模型:读取无障碍(UI)树、理解截图、点击、滑动、输入、启动应用,并规划多步工作流,结果通过 CLI 或 Python API 返回。
框架对模型供应商保持中立,支持 OpenAI、Anthropic、Gemini、xAI、Ollama、DeepSeek、OpenRouter 以及 OpenAI 兼容接口。reasoning 模式会切换到 manager-executor 规划,适合较长或较复杂的任务;vision 模式会把截图和 UI 树一起送给模型,用于无障碍信息稀少的应用。
快速使用
前置条件:Python >=3.11,<3.14、uv;Android 设备需开启开发者选项和 USB 调试,并安装 ADB。iOS 的设置方式不同(通过 mobilerun-ios 走 USB,或用 iOS Portal 驱动模拟器),详见设备配置指南。
安装并从 CLI 运行:
uv tool install mobilerun
mobilerun setup # 安装 Portal 应用并启用无障碍服务
mobilerun ping # 验证设备连接
mobilerun configure # 选择模型供应商、认证方式和模型
mobilerun run "打开设置,告诉我 Android 版本"
如需 Anthropic 支持,安装额外依赖:uv tool install "mobilerun[anthropic]"。也可以跳过 configure 向导,直接设置 GOOGLE_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY 等环境变量。
常用运行参数:--vision(发送截图)、--vision-only(仅截图控制)、--reasoning(规划器-执行器)、--ios、--steps N --debug。要编写自定义工作流,可执行 uv pip install mobilerun 后使用 Python API,扩展点见 SDK 参考与自定义工具指南。
使用约束
- 暂不支持 Python 3.14。
- Android 控制依赖 Mobilerun Portal 应用及其无障碍服务;iOS 控制需要单独的
mobilerun-ios组件或 iOS Portal 应用。 - 需要模型供应商账号和密钥,Agent 表现取决于所选模型。
- 框架在本地机器上运行;托管手机、车队工作流和 REST/SDK 访问属于单独的云产品,README 明确区分了本地框架与托管方案。
- 可用 Arize Phoenix 或 Langfuse 接入追踪,用于调试保存的执行轨迹。
- 采用 MIT 许可证。
HotRepo 点评
该仓库目前在站内没有排名或增长记录可引用,因此无法据此讨论热度走势。材料能支撑的是一个可实际安装的框架:完整的安装路径、分层的设备支持(ADB、Portal、iOS、模拟器)、多家模型后端,以及自定义工具和结构化输出的文档化扩展点。它处在 LLM Agent 工具链与移动端 QA 的交叉处;README 中的 91.4% 基准分数来自项目自家站点,应视为作者自报数据,而非独立测量结果。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。
- KnifeLemon/Droidline用 Python、Node.js、C#、命令行、HTTP 或 Appium 驱动真实 Android 手机做自动化和测试,无需 ADB、USB 或 root。
- ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。
- mylea1/phongent用自然语言从一台 iOS 或安卓主控管理多台安卓设备 agent,集中查看进度、消息与实时画面。
- mobile-next/mobile-mcp让 AI 代理通过统一接口操作 iOS 与 Android 模拟器、仿真器和真机应用的 MCP 服务器。