droidrun/droidrun

Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

Mobilerun 是一个由 Droidrun 提供支持的云解决方案，Droidrun 是一个强大的框架，旨在通过 LLM Agent 控制 Android 和 iOS 设备。它允许你使用自然语言命令来自动化设备交互。查看我们的基准测试结果。

• 🤖 使用自然语言命令控制 Android 和 iOS 设备
• 🔀 支持多种 LLM 提供商（OpenAI、Anthropic、Gemini、Ollama、DeepSeek）
• 🧠 针对复杂多步骤任务的规划能力
• 💻 易于使用的 CLI，配备增强的调试功能
• 🐍 可扩展的 Python API，用于自定义自动化
• 📸 屏幕截图分析，实现对设备的视觉理解
• 🫆 使用 Arize Phoenix 进行执行追踪

📦 安装

注意： 目前不支持 Python 3.14。请使用 Python 3.11 – 3.13。

pip install droidrun

🚀 快速上手

请阅读我们的文档，了解如何在几秒钟内安装并运行 droidrun！

🎬 演示视频

1. 住宿预订：让 Droidrun 为你搜索公寓

   

2. 潮流猎手：让 Droidrun 帮你寻找热门帖子

   

3. 连续签到助手：让 Droidrun 帮你保持心仪语言学习 App 的连续签到记录

   

💡 使用场景示例

• 移动应用的自动化 UI 测试
• 为非技术用户创建引导式工作流程
• 自动化移动设备上的重复性任务
• 为非技术用户提供远程协助
• 使用自然语言命令探索移动 UI

👥 贡献

欢迎贡献代码！请随时提交 Pull Request。

📄 许可证

本项目采用 MIT 许可证授权 - 查看 LICENSE 文件了解详情。

安全检查

为了确保代码库的安全，我们集成了 bandit 和 safety 安全检查工具。这些工具有助于识别代码和依赖项中潜在的安全问题。

运行安全检查

在提交任何代码之前，请运行以下安全检查：

1. Bandit：用于查找 Python 代码中常见安全问题的工具。

   bandit -r droidrun
   

2. Safety：用于检查已安装依赖项中已知安全漏洞的工具。

   safety scan