d
droidrun/mobilerun
Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖
ai-agentsandroidandroid-automationhacktoberfestmobile-automation
PythonMIT创建于 2025/4/12更新于 今天
README
由 Gemini 翻译整理
Mobilerun
Mobilerun 是一个开源框架，旨在通过 LLM Agent 控制 Android 和 iOS 设备。 它为 Agent 提供了原生移动端工具，用于检查 UI 状态、理解屏幕截图、执行点击、滑动、输入、规划多步骤工作流，并通过 CLI 或 Python API 返回结果。
📕 文档 · ☁️ Mobilerun Cloud
Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文
- 🤖 通过自然语言指令控制 Android 和 iOS 设备
- 🔀 支持 OpenAI、Anthropic、Gemini、Ollama、DeepSeek、OpenRouter 以及兼容 OpenAI 格式的模型
- 🧠 可直接执行任务，或开启推理模式处理复杂的多步骤自动化
- 💻 支持从 CLI、终端 UI、Docker 或 Python 代码进行自动化操作
- 🐍 可通过自定义工具、结构化输出、应用卡片和凭证来扩展 Agent
- 📸 结合辅助功能树（Accessibility Trees）与屏幕截图，实现更精准的视觉理解
- 使用 Arize Phoenix 或 Langfuse 追踪执行过程
当你想在本地机器上运行 Agent 时，请使用该框架。如果你需要为本地手机或云端托管的虚拟/物理手机提供即用型解决方案，且希望在无需在本地运行 Agent 的前提下管理基础设施和 API 驱动的设备工作流，请使用 Mobilerun Cloud。查看我们的基准测试结果。
📦 安装
注意： 目前不支持 Python 3.14。请使用 Python
>=3.11。
查找趋势内容
展示浏览、应用导航以及从自然语言任务中提取结果的过程。
保持应用活跃度 (App Streak)
展示一个可通过提示词触发自动化的短周期移动端工作流。
💡 典型应用场景
- 移动应用 QA 和回归测试
- 面向非技术用户的引导式工作流
- 移动设备上的重复性任务自动化
- 基于日程安排、通知或自定义触发器的事件驱动自动化
- 从原生移动应用中提取数据
- 同时在多台设备上运行自动化任务
📚 文档
👥 贡献
欢迎提交贡献。请随时提交 Pull Request 或开启 Issue。
📄 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。
安全检查
为了在提交更改前捕获安全问题，请运行：
bandit -r mobilerun
safety scan