Skip to content

Installation

Requirements

  • Python ≥ 3.10
  • adb on PATH
  • An Android device (phone/tablet) or emulator with USB debugging enabled

Install strands-adb

pip install strands-adb

zsh users

If you see zsh: no matches found, quote the package name: pip install "strands-adb"

Editable / from source

git clone https://github.com/cagataycali/strands-adb.git
cd strands-adb
pip install -e .

Install adb

brew install android-platform-tools
adb version

sudo apt install android-tools-adb
adb version

sudo pacman -S android-tools
adb version

winget install Google.PlatformTools
adb version

Enable USB Debugging on the Phone

  1. Settings → About phone → tap Build number 7 times
  2. Settings → System → Developer options → enable USB debugging
  3. Plug in USB. Accept the trust prompt that pops up on the device.
adb devices
# List of devices attached
# 59230DLCH0012Z  device

→ Connect a Device covers USB, wireless, and SSH-over-adb setup in depth.

Verify

from strands import Agent
from strands_adb import adb

agent = Agent(tools=[adb])
print(agent("list connected adb devices"))

You should see the device serial. ✅

Optional: Companion Install Script

The repo ships an interactive installer that handles adb install of helper APKs + USB debugging guidance:

curl -fsSL https://raw.githubusercontent.com/cagataycali/strands-adb/main/install_android.sh | bash

→ Details: INSTALL_ANDROID.md

Platform Compatibility

Platform adb Status
macOS (Apple Silicon / Intel) ✅ Primary dev target
Linux x86_64 ✅ Fully supported
Linux ARM64 (incl. Jetson) ✅ Works great for edge agents
Windows 10/11 ✅ Works, USB driver setup required
Android device running adb ✅ Via Termux → adb over TCP

What Gets Installed

graph LR
    ADB["strands-adb"] --> SA["strands-agents<br/><i>@tool framework</i>"]
    ADB --> OPT["Pillow<br/><i>[vision] optional</i>"]

    style ADB fill:#3DDC84,color:#000
    style SA fill:#264653,color:#fff

What's Next