Skip to main content

Python SDK for controlling the native agent-browser engine in-process

Project description

pyagentbrowser

PyPI Release Check License

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 extraction
  • browser.agent: accessibility snapshots with action-ready refs
  • browser.find: CSS, XPath, text, role, label, and test-id locators
  • browser.capture: screenshots, PDFs, and action evidence
  • browser.tabs: tab creation, listing, and switching
  • browser.network: request logs, routing, HAR, and proxy credentials
  • browser.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]"
  • images adds Pillow helpers for screenshot objects.
  • cdp adds WebSocket-backed frame, target, and execution-context evaluation.

Links

Development

make install
make check

Use make package for wheel and sdist smoke checks.

License

Apache-2.0. See LICENSE and NOTICE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyagentbrowser-0.31.1rc2.tar.gz (709.6 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_x86_64.whl (9.3 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ x86-64

pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_aarch64.whl (8.8 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_11_0_arm64.whl (8.4 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

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

Hashes for pyagentbrowser-0.31.1rc2.tar.gz
Algorithm Hash digest
SHA256 be3fd3f2c57f7d6420267e34a4d2bd774ef47ff697cbdb2d484c9a78b1ab6470
MD5 67b34f99039a9659c538d01c0f8476aa
BLAKE2b-256 876f8175e6c6730047c9439ee7dca5cb66881870db4d1be7495d6d0f3e942b90

See more details on using hashes here.

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

Hashes for pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f9235ca616b673c7ae14c2a35a9851f8fa2269d50873ce60ddca8ac81bbe4748
MD5 eced21e7b3c692978fda17fe91377920
BLAKE2b-256 5649a47ace24625cd811b2887a533e480e7731571ff865fa7d7dcf6993baa01c

See more details on using hashes here.

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

Hashes for pyagentbrowser-0.31.1rc2-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 39fd533afe53747ff7ac9cb071e31c33baa96a2c71cf200c1795b4f89332279c
MD5 3a773d41a77b424b5bf141eb37f4f874
BLAKE2b-256 7976bb2501e695d15b799ac6670685d519d4e17239fc02fcd9bb4d598eed742c

See more details on using hashes here.

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

Hashes for pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 42f36796e9e66e94a8fc49cfa7acdd24a30190e762a8ae7ff6a70e1291206941
MD5 42f6f7b2bec1a3a733faa5bb8032b97a
BLAKE2b-256 b29e42adb3bc1dfad0165101191465bf4c785c31fde4ce1b22cf23400079126d

See more details on using hashes here.

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

Hashes for pyagentbrowser-0.31.1rc2-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 20417018198cc778f9e4d0aef4c426992b950f9c1f019129b60509ca569f571c
MD5 e35ecf94702a8d7c3432fab1888822ef
BLAKE2b-256 1844b4f834b5e4bdc061202206fd91c92cdcd798cd8ed267b0ddbec28f522f67

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page