mobilerun

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

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

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

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

Q: 可以控制 iOS 设备吗？

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

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

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

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

开源 🏷️定价信息待确认 ✅ 目前可打开自动化工作流 🍴 复刻 1068 🐛 待处理 33 👀 关注 55

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 9919

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类自动化工作流

开发团队droidrun

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

GitHubhttps://github.com/droidrun/mobilerun

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 9919

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

代码更新2026-11-02

仓库体积105.8 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-16

浏览次数3

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 9919

技术标签

ai-agents android hacktoberfest mobile-automation

使用教程

难度：入门约 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
```