mobilerun

说句话就让手机自己点，跨 App 自动跑流程

mobilerun 是一个用自然语言指令驱动移动设备自动化的开源 Agent 框架，核心目标是让用户不必编写 Appium 脚本或坐标点击逻辑，直接用中文或英文描述任务，就能让 LLM 规划并操作 Android 手机完成操作。它解决了传统移动自动化门槛高、脚本脆弱、换机型或换界面就失效的问题。项目采用 LLM 无关设计，可接入不同大模型作为决策大脑，通过视觉理解屏幕内容并生成点击、滑动、输入等动作。技术栈为 Python，标签覆盖 ai-agents、android-automation、mobile-automation，适合做跨 App 流程自动化、批量设备操作和移动端 AI Agent 实验。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 9405

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队droidrun

所属国家

官网地址https://mobilerun.ai/framework

GitHubhttps://github.com/droidrun/mobilerun

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai-agents,android,android-automation,hacktoberfest,mobile-automation

GitHub 星标★ 9405

30天Star增速

HF 下载量

上线时间2025-04-12 00:00:00

最近更新2026-09-18 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-16

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python >=3.11,<3.14（3.14 暂不支持）
已安装 uv 包管理工具（docs.astral.sh/uv）
Android 设备需开启开发者选项与 USB 调试
电脑已安装 ADB（Android Platform Tools）
iOS 设备需走单独的 iOS Portal 流程

安装与启动步骤

1安装 mobilerun

用 uv 以全局工具方式安装 mobilerun CLI，注意 Python 版本需为 3.11 到 3.13，3.14 不支持。
```
uv tool install mobilerun
```
2连接并检查设备

用数据线连接 Android 设备，确认已开启开发者选项和 USB 调试，先用 adb 确认设备被识别。
```
adb devices
```
3安装设备端 Portal

执行 setup 会在设备上安装 Mobilerun Portal 应用并开启其无障碍服务，为本地控制做准备。
```
mobilerun setup
```
4配置模型与运行参数

运行 configure 进入配置流程，按提示填写所选大模型与相关运行参数（项目为 LLM 无关设计）。
```
mobilerun configure
```
5执行第一条指令

用自然语言描述任务，Agent 会理解屏幕并自动点击、滑动、输入，完成多步流程。
```
mobilerun run "Open settings and turn on dark mode"
```
6可选：高级运行参数

按需追加参数：--vision 启用视觉、--reasoning 启用推理、--ios 走 iOS、--steps 限制步数、--debug 调试。
```
mobilerun run "Open Settings" --steps 30 --debug
```

如何确认成功

执行 mobilerun run "What app is currently open?" --vision，能返回当前前台应用即表示链路正常。

常见问题

Q：安装时报 Python 版本错误怎么办？

A：项目要求 Python >=3.11,<3.14，3.14 尚未支持。请切换到 3.11~3.13 的环境后重新执行 uv tool install mobilerun。

Q：运行时报找不到设备？

A：确认已装 ADB、数据线连接正常、设备已开启开发者选项与 USB 调试；可用 adb devices 检查设备是否被识别。

Q：可以控制 iOS 设备吗？

A：可以。README 说明 iOS 支持通过独立的 iOS Portal 流程配置，运行命令时加 --ios 参数，例如 mobilerun run "Take a screenshot" --ios。

Q：Agent 点错或任务太复杂怎么办？

A：可加 --vision 提升屏幕理解、加 --reasoning 增强多步规划，并用 --steps 30 限制最大步数、加 --debug 查看执行细节。

注意事项

README 明确说明 iOS 需单独走 iOS Portal 流程，配置方式与 Android 不同。
安装前务必确保 ADB 可用且设备已完成 USB 调试授权，否则 setup 与 run 都会失败。
项目为 LLM 无关设计，具体可接入的模型清单与配置项请参考 mobilerun configure 的交互提示及官方文档。

核心亮点

LLM 无关设计，可自由切换不同大模型作为决策引擎，避免绑定单一厂商
用自然语言描述任务即可驱动手机操作，省去编写和维护 Appium/坐标脚本的成本
面向真实 Android 设备自动化，覆盖点击、滑动、输入等完整交互动作链

不足之处

移动端自动化依赖屏幕视觉识别，界面复杂或动态加载时稳定性仍需验证
项目处于成长阶段，文档与社区生态相对早期，长期维护情况待观察

适用场景

自动完成跨 App 的重复操作，如签到、领券、批量消息发送
移动端 AI Agent 研究与实验，验证 LLM 在真实设备上的规划执行能力
测试或运营场景下批量操作多台 Android 设备，减少人工点击

替代项目

Appium、Maestro、DroidBot

项目介绍

mobilerun 是一个自动化工作流领域的开源项目，官方简介：Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent。项目使用 Python 开发，在 GitHub 上获得 9378 星标。

上一篇：mixamo-llm-mocap

下一篇：wexflow