Mobilerun 是一个基于 Droidrun 的云解决方案，Droidrun 是一个强大的框架，可通过 LLM 代理控制 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 在您最喜欢的语言学习应用中帮您保持连胜

   

💡 示例用例

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

👥 贡献

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

📄 许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

安全检查

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

运行安全检查

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

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

   bandit -r droidrun
   

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

   safety scan
   

DroidRun 快速上手指南

DroidRun 是一个强大的框架，允许你通过大语言模型（LLM）智能体使用自然语言命令来控制 Android 和 iOS 设备，实现自动化操作。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：支持 Windows、macOS 或 Linux。
• Python 版本：必须使用 Python 3.11 – 3.13。

  ⚠️ 注意：目前暂不支持 Python 3.14。

• 设备连接：
  • Android：需开启开发者选项中的"USB 调试”，并通过 USB 连接电脑（或使用 adb connect 无线连接）。
  • iOS：需配合 Mac 使用，并确保设备已信任电脑（部分功能可能需要额外配置）。
• LLM API Key：准备好你所选大模型提供商的 API Key（支持 OpenAI, Anthropic, Gemini, Ollama, DeepSeek 等）。

安装步骤

使用 pip 即可快速安装 DroidRun。国内用户建议使用国内镜像源以加速下载。

pip install droidrun -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，可通过以下命令验证安装是否成功：

droidrun --version

基本使用

DroidRun 的核心是通过命令行界面（CLI）使用自然语言下达指令。

1. 配置 API Key

在使用前，你需要设置环境变量来配置你的 LLM 提供商和密钥。以使用 OpenAI 为例：

Linux/macOS:

export OPENAI_API_KEY="your-api-key-here"
export DROIDRUN_LLM_PROVIDER="openai"

Windows (PowerShell):

$env:OPENAI_API_KEY="your-api-key-here"
$env:DROIDRUN_LLM_PROVIDER="openai"

若使用其他模型（如 DeepSeek 或 Ollama），请参考官方文档设置对应的环境变量。

2. 运行第一个任务

确保手机已连接并被 adb 识别（运行 adb devices 确认），然后执行以下命令让 AI 控制你的手机：

droidrun run "打开设置应用，并检查当前的 Wi-Fi 名称"

或者执行更复杂的任务，例如：

droidrun run "在浏览器中搜索今天的天气，并截图保存"

3. 进阶用法（Python API）

你也可以在 Python 脚本中调用 DroidRun 以实现自定义自动化流程：

from droidrun import DeviceAgent

# 初始化设备代理
agent = DeviceAgent()

# 执行自然语言指令
result = agent.run("打开相机应用并拍摄一张照片")

print(result)

---

更多详细功能和参数配置，请访问 官方文档。