Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

ybblab/Droidance

AI Engineering

An open-source Android agent that sees the screen and taps through apps for you in a background virtual display.

151
32
Kotlin
Apache-2.0
3 months old

What it is

Droidance is an Android app that runs a multimodal-model agent on the phone itself. You describe a task in one sentence, and the agent reads screenshots, decides the next step, and taps, types or swipes inside a private virtual display. It targets routine phone chores—price comparison, ordering, bookings, information gathering and scheduled runs—rather than app development.

The app avoids root, a PC and the Accessibility Service. It bundles a wireless-debugging client: after a one-time pairing it connects to the phone's own adbd, starts a shell-identity sidecar, and creates a separate virtual screen. It works purely from screenshots, so custom-drawn controls and WebViews don't need a complete accessibility tree. Root and Shizuku are optional alternative channels.

Quick start

Prerequisites: an Android 11+ phone (low-memory and Android Go devices are not supported), Wi-Fi for pairing, and a multimodal model API key that supports image input and tool calling.

  1. Download the latest APK from Releases and install it.
  2. Open 连接设备, choose wireless debugging, follow the prompt to enable Developer options → Wireless debugging, and enter the pairing code. No computer is required.
  3. Add your provider's base URL, API key and model ID, then state the task in one sentence.

Tasks run in the background; the top run island lets you watch progress, pause, or take over. If the agent reports blocked input on Xiaomi devices, enable "USB debugging (Security settings)"; on OPPO/OnePlus/realme, turn off permission monitoring and reconnect.

To build from source you need JDK 17 and Android SDK 35, then set sdk.dir in local.properties and run ./gradlew :app:assembleDebug; scripts/verify.sh runs the public-source checks (build notes).

Operating constraints

  • Android 11–13 support is experimental: the virtual display has no independent focus, so keys and text briefly borrow the main screen, and on Android 11/12 tasks stop after the screen locks.
  • Wireless debugging and reconnect after reboot need Wi-Fi; some systems disable wireless debugging after idle periods. Shizuku must be started separately and re-started after reboot. Root has only been verified on Android 16 with SukiSU.
  • Some apps detect developer options or wireless debugging and may refuse to run.
  • Task success and duration depend on the chosen model; a reported "done" is not a guarantee the business result is correct.
  • Captchas are always left to you, but the pause for payments or logins is decided by agent rules, not a hard gate—verify irreversible steps yourself.
  • Screenshots, task context and instructions go to the model provider you configure; diagnostics with possible personal data are kept locally with best-effort cleanup. API keys live in app-private storage and shell-owned runtime data; uninstalling may not delete the shell directory.
  • Automation may violate third-party app terms and risk account restrictions. Licensed under Apache 2.0.

HotRepo's take

No HotRepo rank, snapshot or discussion record is available for this repository, so there is nothing to read from the leaderboard side. The technical facts that stand out are the chosen approach—an in-app ADB client and a virtual display instead of Accessibility—and the explicit limitation list for Android 11–13, vendor ROMs and model-dependent success rates. The main caution for new users is that the primary deliverable is a prebuilt APK: verify the .sha256 file shipped with each release and check the security notes before installing.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. AcidGr/agent-mobile-useRuns Android apps on a background virtual display so an agent can operate them without touching the main screen.Java124
  2. guzhou079-arch/deepseek-harness-androidAn Android APK that bundles DeepSeek Harness with screen automation, virtual display, scheduled tasks and 27 skills, without Termux or root.JavaScript110
  3. kilolonion/agent-vscreenRun Android apps on an invisible virtual display so phone AI agents can operate them while you keep using your own screen.Kotlin117
  4. kuafuai/andeeAn on-device agent for Android and Mac that operates any app through accessibility, operating apps without integrations or root.Kotlin6,150
  5. tapilot-ai/tapilotAn experimental Android app that executes plain-language phone tasks using a vision model and accessibility control.HTML138