English | 中文

android-use 是一个开源版的豆包手机项目，旨在通过自然语言驱动实现 Android 手机的自动化操作。它可以将任意 Android 手机变身为智能 AI 手机，极大提升操作效率与体验。

1. 精准定位与交互：通过 XML 解析技术自动高亮可交互元素，并支持通过索引（Index）进行点击，显著提升了 Agent 的定位能力和操作准确性。
2. 广泛的模型支持：完美支持 Deepseek、Kimi-k2、GLM 等国产大模型。即使模型不具备视觉（Vision）能力，依然可以通过 XML 解析实现高效工作。

在使用本工具之前，请确保您的 Android 设备已开启 USB 调试模式。

• 设备要求：Android 7.0+。
• 开启开发者模式：
  • 打开 设置 -> 关于手机。
  • 找到 版本号，连续快速点击 10 次左右。
  • 直到屏幕弹出“开发者模式已启用”提示。
  • 注：不同品牌手机路径可能略有差异，如未找到请自行搜索对应机型的开启教程。
• 开启 USB 调试：
  • 进入 设置 -> 开发者选项。
  • 找到并勾选 USB 调试。

推荐使用 uv 进行环境管理和安装。

MacOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方式一：WebUI 界面 (推荐)

uvx android-use webui

方式二：命令行 CLI (交互式)

uvx android-use

如果您希望参与开发或进行本地调试：

git clone https://github.com/languse-ai/android-use
cd android-use
uv sync
# 启动 CLI
python -m android_use.cli
# 启动 WebUI
python -m android_use.app

⚠️ 本项目仅供研究和学习使用。严禁用于非法获取信息、干扰系统或任何违法活动。请仔细审阅 使用条款。

以下是三个典型的自动化场景演示：

任务描述：打开微信，进入视频号搜索“豆包手机”，获取当前页面点赞数最多的视频的所有评论，将该视频分享给好友，并发送一段总结性的评论内容。

任务描述：打开抖音，进入商城搜索“安踏篮球鞋”，获取并整理排名前 10 的商品信息。

任务描述：打开小红书，搜索“browser-use”，选择当前页面点赞数最多的帖子，进行点赞并发表一条像真人一样的简洁评论，最后总结该帖子的核心内容。