搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

droidrun/mobilerun

AI 工程

用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。

10,059
1,097
Python
MIT
创建于 1 年前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。Python812
  2. KnifeLemon/Droidline用 Python、Node.js、C#、命令行、HTTP 或 Appium 驱动真实 Android 手机做自动化和测试,无需 ADB、USB 或 root。Go547
  3. ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。TypeScript355
  4. mylea1/phongent用自然语言从一台 iOS 或安卓主控管理多台安卓设备 agent,集中查看进度、消息与实时画面。Kotlin362
  5. mobile-next/mobile-mcp让 AI 代理通过统一接口操作 iOS 与 Android 模拟器、仿真器和真机应用的 MCP 服务器。TypeScript10,647