---
id: pure-python-adb
version: "0.3.0.dev0"
license: MIT license
license_treatment: permissive
maintenance: dormant
---

# pure-python-adb — Pure python implementation of the adb client

License: permissive · Maintenance: dormant · Downloads: 115.1K/mo

## What it is and what it does

Pure-python-adb is a Python implementation of an ADB (Android Debug Bridge) client that connects to an ADB server to communicate with Android devices and emulators. Instead of shelling out to the native adb command-line tool, it implements the ADB protocol directly in Python, allowing you to programmatically control devices from within your code.

The package supports most common ADB operations: listing devices, executing shell commands, installing and uninstalling APKs, pushing and pulling files, taking screenshots, and remote connections. However, the package has been dormant since 2020 and requires an external ADB server to be running—it does not manage the server itself.

Use it for:

- Automate APK installation and testing across multiple Android devices or emulators in CI/CD pipelines
- Run shell commands on Android devices programmatically to extract logs, system info, or app data
- Build test automation frameworks that need to control Android emulators without subprocess calls
- Capture screenshots or pull files from devices as part of automated testing or monitoring workflows
- Manage remote device connections and execute batch operations across a device farm

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Pure-Python ADB client that communicates with an ADB server to control Android devices and emulators without requiring the native ADB binary.

No—unless you have a specific legacy codebase already using this package. The project is dormant (last release 2020-08-05), offers no recent maintenance, and high install friction from being a tarball with no dependencies. For new projects, consider maintained alternatives or direct ADB server communication via subprocess if the overhead is acceptable.

## Install

pip install pure-python-adb
uv add pure-python-adb
poetry add pure-python-adb

## Installing pure-python-adb

Before you install: High install friction due to being a pure-Python tarball with no runtime dependencies. The package is dormant—last release was 2020-08-05, over 2200 days ago, with no recent commits. Use only if you accept that maintenance and bug fixes are unlikely.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely with minimal restrictions, though you must include the license notice.

Quickstart:

pip install pure-python-adb

from pure_python_adb.client import Client as AdbClient
client = AdbClient(host="127.0.0.1", port=5037)
device = client.device("emulator-5554")
device.shell("echo hello world")

Requires an ADB server running on the specified host and port (default 127.0.0.1:5037); the package does not start the server itself.

Verify before relying:

- Whether the package works with modern Android SDK versions and emulator configurations
- Compatibility with Python versions beyond 3.6 (requires_python field is empty)
- Whether async client variant is production-ready or experimental

## Package facts

- License: MIT license (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: dormant
- Downloads: 115.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

adb client python, android device control, pure python adb, android emulator automation, adb server communication, android shell commands, apk install uninstall, android-automation, adb-client, dormant

[View on SkillFed](https://skillfed.io/packages/pure-python-adb) · [View on PyPI](https://pypi.org/project/pure-python-adb/)