agent-browser-cli 0.0.1

Python wrapper for agent-browser CLI — browser automation for AI agents, no npm required

agent-browser (Python wrapper)

A Python wrapper for agent-browser that eliminates the need for npm/Node.js installation.

Install via pip/uv and get a fully working agent-browser CLI — no npm or Node.js required.

Installation

pip install agent-browser
# or
uv pip install agent-browser

First run

On first invocation, Node.js v22 is automatically downloaded to ~/.cache/agent-browser-py/ (one-time, ~30MB):

agent-browser --version
# Downloading Node.js v22.14.0 (one-time setup)...
# Done.
# 0.17.1

Then install the browser (Chromium via Playwright):

agent-browser install

On Linux you may need system dependencies:

agent-browser install --with-deps

Usage

agent-browser open example.com
agent-browser snapshot
agent-browser click @e1

All commands are proxied directly to the bundled Rust CLI binary.

How it works

The wheel bundles:

1. Rust CLI binary (~15MB) — from GitHub releases
2. Node.js daemon code (~18MB) — from the npm registry with all JS dependencies

Downloaded at runtime (cached in ~/.cache/agent-browser-py/):

3. Node.js runtime (~30MB) — from nodejs.org, downloaded on first use
4. Chromium — via agent-browser install (Playwright CDN)

No npm or Node.js installation is required on your system.

Supported platforms

• macOS (arm64, x86_64)
• Linux (x86_64, aarch64)
• Windows (x86_64)

Building from source

make wheel TARGET_SYSTEM=darwin TARGET_MACHINE=arm64  # Single platform
make wheels                                            # All 5 platforms
make verify                                            # Install and verify

License

MIT — This wrapper packages upstream software under their respective licenses:

• agent-browser: MIT
• Node.js: MIT