Python SDK for controlling the native agent-browser engine in-process
Project description
pyagentbrowser
Python SDK for the native Rust agent-browser engine.
Use it to launch Chrome, inspect pages, act on snapshot refs, capture artifacts, and call Chrome DevTools Protocol from Python.
uv add pyagentbrowser
# or
python -m pip install pyagentbrowser
import agentbrowser as ab
browser = ab.configure()
browser.page.open("https://github.com/peter-gy/pyagentbrowser")
browser.capture.screenshot(full_page=True)
Local Chrome launches use an installed Chrome or Chromium executable. When none is found, pyagentbrowser prepares Chrome for Testing through the bundled native installer.
API
browser.page: navigation, content, waits, and readable page extractionbrowser.agent: accessibility snapshots with action-ready refsbrowser.find: CSS, XPath, text, role, label, and test-id locatorsbrowser.capture: screenshots, PDFs, and action evidencebrowser.tabs: tab creation, listing, and switchingbrowser.network: request logs, routing, HAR, and proxy credentialsbrowser.cdp: frames, targets, execution contexts, and raw CDP calls
AsyncBrowser mirrors the same surface with awaitable methods.
Extras
python -m pip install "pyagentbrowser[images]"
python -m pip install "pyagentbrowser[cdp]"
imagesadds Pillow helpers for screenshot objects.cdpadds WebSocket-backed frame, target, and execution-context evaluation.
Links
Development
make install
make check
Use make package for wheel and sdist smoke checks.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyagentbrowser-0.31.1rc2.tar.gz.
File metadata
- Download URL: pyagentbrowser-0.31.1rc2.tar.gz
- Upload date:
- Size: 709.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be3fd3f2c57f7d6420267e34a4d2bd774ef47ff697cbdb2d484c9a78b1ab6470
|
|
| MD5 |
67b34f99039a9659c538d01c0f8476aa
|
|
| BLAKE2b-256 |
876f8175e6c6730047c9439ee7dca5cb66881870db4d1be7495d6d0f3e942b90
|
File details
Details for the file pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 9.3 MB
- Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9235ca616b673c7ae14c2a35a9851f8fa2269d50873ce60ddca8ac81bbe4748
|
|
| MD5 |
eced21e7b3c692978fda17fe91377920
|
|
| BLAKE2b-256 |
5649a47ace24625cd811b2887a533e480e7731571ff865fa7d7dcf6993baa01c
|
File details
Details for the file pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_aarch64.whl.
File metadata
- Download URL: pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_aarch64.whl
- Upload date:
- Size: 8.8 MB
- Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39fd533afe53747ff7ac9cb071e31c33baa96a2c71cf200c1795b4f89332279c
|
|
| MD5 |
3a773d41a77b424b5bf141eb37f4f874
|
|
| BLAKE2b-256 |
7976bb2501e695d15b799ac6670685d519d4e17239fc02fcd9bb4d598eed742c
|
File details
Details for the file pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 8.4 MB
- Tags: CPython 3.11+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
42f36796e9e66e94a8fc49cfa7acdd24a30190e762a8ae7ff6a70e1291206941
|
|
| MD5 |
42f6f7b2bec1a3a733faa5bb8032b97a
|
|
| BLAKE2b-256 |
b29e42adb3bc1dfad0165101191465bf4c785c31fde4ce1b22cf23400079126d
|
File details
Details for the file pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_10_12_x86_64.whl.
File metadata
- Download URL: pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_10_12_x86_64.whl
- Upload date:
- Size: 8.8 MB
- Tags: CPython 3.11+, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20417018198cc778f9e4d0aef4c426992b950f9c1f019129b60509ca569f571c
|
|
| MD5 |
e35ecf94702a8d7c3432fab1888822ef
|
|
| BLAKE2b-256 |
1844b4f834b5e4bdc061202206fd91c92cdcd798cd8ed267b0ddbec28f522f67
|