DroidRun是一个强大的框架,可以使用自然语言命令控制Android设备。它允许您使用自然语言命令自动化Android设备交互。

主要功能点

• 使用自然语言命令控制Android设备
• 支持多个LLM提供商(OpenAI、Anthropic、Gemini)
• 易于使用的命令行界面
• 可扩展的Python API用于自定义自动化
• 屏幕截图分析,以视觉方式了解设备

技术栈

• Python
• Android Debug Bridge (ADB)
• 大语言模型(LLM)提供商API

安装步骤

DroidRun 可以通过两种主要方式安装：从 PyPI 安装或从源代码安装。

选项 1：从 PyPI 安装（推荐）

1. 打开终端或命令提示符。
2. 运行以下命令：pip install droidrun

选项 2：从源代码安装

1. 克隆仓库：git clone https://github.com/droidrun/droidrun.git
2. 进入项目目录：cd droidrun
3. 安装依赖：pip install -e .

前提条件

在安装 DroidRun 之前，请确保满足以下要求：

• 连接到 USB 的 Android 设备或通过 TCP/IP 的 ADB（Android Debug Bridge）。
• 安装并配置 ADB。
• 在 Android 设备上安装 DroidRun Portal 应用。
• 获取至少一个支持的 LLM 提供商的 API 密钥（如 OpenAI、Anthropic、Google Gemini）。

设置 ADB

1. 安装 ADB：

   • Windows：下载 Android SDK Platform Tools 并解压缩 ZIP 文件。
   • macOS：运行 brew install android-platform-tools。
   • Linux：
     • Ubuntu/Debian：sudo apt install adb
     • Arch：sudo pacman -S android-tools

2. 将 ADB 添加到 PATH：

   • Windows：将提取的 platform-tools 文件夹路径添加到系统的 PATH 环境变量中。
   • macOS/Linux：在 ~/.bashrc 或 ~/.zshrc 中添加：
     export PATH=$PATH:/path/to/platform-tools


3. 验证 ADB 安装：adb version

4. 启用 USB 调试：

   • 前往设置 → 关于手机 → 连续点击版本号 7 次以启用开发者选项。
   • 前往设置 → 系统 → 开发者选项（位置可能因设备而异） → 启用 USB 调试。

按照这些步骤，您就可以成功安装并设置 DroidRun！

许可证

本项目采用MIT许可证。