[Tutorial] run Droidrun on Termux

[shinnpuru]

Thanks for the great work of droidrun! Here I have a thorough tutorial of running Droidrun on Termux for totally PC-free usage.

Final Results

https://youtube.com/shorts/4p-he0WAoCg

Droidrun Installation and Configuration

1. Download Termux

You can download it from Google Play.

2. Install proot-distro

Open Termux and enter the following commands.

pkg install proot-distro -y
proot-distro install debian
proot-distro login debian

3. Install uv and python

Once inside the Debian environment, enter the following commands:

wget -qO- https://astral.sh/uv/install.sh | sh
apt install python3 python3-pip

4. Install droidrun

After installing uv, enter the following commands:

uv venv
uv pip install 'droidrun[google,anthropic,openai,deepseek,ollama,dev]'

---

Enable USB Debugging Mode

1. Enter Settings: Open your phone's Settings.

2. Find "About Phone": Scroll to the bottom and tap About Phone or About Device.

3. Activate Developer Options:

• Find Build Number or Software Version.
• Tap Build Number continuously 5-7 times until you see a prompt saying "You are now a developer" or similar.

4. Enter "Developer Options":

• Return to the main Settings menu, or go to System / Additional Settings.
• A new option called Developer options should now appear.

5. Enable USB Debugging:

• Enter Developer options.
• Find USB debugging and USB debugging (Security settings), then toggle the switches to ON.
• Tap OK in the confirmation dialog box.

6. Enable Wireless Debugging:

• In Developer options, find and enable Wireless debugging (or Wi-Fi debugging).
• Tap on Wireless debugging to enter the detailed settings. This will display the device's IP address, port, and pairing code.

---

Install and Configure DroidRun-Portal

1. Download and Install DroidRun-Portal:
Download from the official website (https://github.com/droidrun/droidrun-portal).

2. Enable Accessibility Permissions:
Follow the instructions within DroidRun-Portal to enable access. Once the top section turns green, the system is ready.

---

Usage Guide

1. Pair via Wireless Debugging

Get the 6-digit pairing code and port number displayed on the Wireless debugging screen and run the following command in Termux.

uv run adb pair localhost:port

Important: You must perform this using Split-screen mode. If the Wireless debugging interface goes into the background, the pairing will fail.

2. Connect Droidrun

Enter the following commands in the Debian command line:

uv run droidrun connect localhost:port  # Connect device (replace 'port' with actual port)

3. Operate using LLM

Once connected, enter the following commands in the Debian command line:

export GOOGLE_API_KEY=<your-google-api-key>
uv run droidrun run   --provider GoogleGenAI  --model gemini-2.5-flash   "Open the settings app"

[johnmalek312]

Damn, thats sick 🫡

[RasulOs]

Nice one

[wiilwaalka]

I haven't tried it in a proot distribution because I'm not a fan of the extra overhead, so I opted to install it directly in Termux. However, it seems that it's unable to find the portal app even though it's already installed..

[wiilwaalka]

I asked Qwen Coder what was up with it, and it said:.

[johnmalek312]

try run droidrun doctor
and then

adb devices
droidrun ping

[wiilwaalka]

@johnmalek312 I requested her to create a patching script for the bug it identified, so i can execute it whenever async_adbutils is updated, and it appears it is just one line needs fixing. Here is the script:

fix_async_adbutils.py

The result. Seems fine?

and this is what it claims:

Bug Description

list_packages() returns empty list on multi-user Android devices (Samsung, Xiaomi, custom ROMs) due to permission errors.

Error:

SecurityException: Shell does not have permission to access user 150

Affected devices:

• Samsung (One UI)
• Xiaomi (MIUI/HyperOS)
• Custom ROMs with multiple users
• Any Android device with multi-user support

---

Root Cause

The pm list packages command in async_adbutils/_device.py:987 doesn't specify a user, causing it to fail on devices with multiple user profiles.

---

Proposed Fix

File: async_adbutils/_device.py
Line: ~987 (in list_packages() method)

  async def list_packages(self, filter_list=None):
      result = []
      cmd = ["pm", "list", "packages"]
+     cmd.extend(["--user", "0"])  # Fix for multi-user devices
      if filter_list:
          cmd.extend(filter_list)
      output = await self.shell(cmd)
      ...

Changes: 1 line added

---

[johnmalek312]

Thanks for the fix, will add it to async adbutils