pyagentbrowser

PyPI Release Check License

pyagentbrowser embeds the native Rust agent-browser engine in Python. It gives agents accessibility snapshots, stable element refs, and before-and-after evidence for browser actions.

uv add pyagentbrowser

from agentbrowser import Browser

browser = Browser()
browser.open("https://example.com")
page = browser.observe()

print(page.text)

Browser starts lazily and stays active until browser.close() is called. Keep the same object across notebook cells or interactive Python commands. browser.session.status() reports browser and restore lifecycle state. close() returns the terminal save result. Screenshots returned by browser.capture.screenshot() render inline in notebook frontends.

Snapshot binds accessibility refs to the page state that produced them. Ref actions return an ActionResult containing the original snapshot, the resulting snapshot, and their diff.

Use browser.find for live CSS, XPath, and semantic queries. Namespaces such as browser.capture, browser.tabs, browser.network, and browser.cdp expose focused browser capabilities. Every action in the pinned native engine remains available through browser.native.

Documentation

Installation options

The distribution is named pyagentbrowser. Python imports it as agentbrowser. Wheels support Python 3.11 through 3.14 on macOS, Linux, and x86-64 Windows.

uv add "pyagentbrowser[images]"  # Pillow-backed screenshot helpers
uv add "pyagentbrowser[cdp]"     # CDP frames, targets, and evaluation

Local launches find an installed Chromium browser or prepare Chrome for Testing through the native installer.

Development

make install
make check

make test-integration exercises the Python, PyO3, adapter, and CDP seams against a real browser. make check-release builds and installs both distribution artifacts.

License

Apache-2.0. See LICENSE and NOTICE.

Project links

Data verified by PyPI on Jul 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.37.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for peter-gy from gravatar.com peter-gy

Credits

Author: Péter Ferenc Gyarmati

GitHub Statistics

Data verified by PyPI on Jul 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python <3.15, >=3.11

Provides Extra

cdp images

Tags

agent-browser browser automation evidence refs snapshots

Classifiers

Report project as malware

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.33.0.tar.gz (1.0 MB view details)

Uploaded Source

Built Distributions

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

pyagentbrowser-0.33.0-cp311-abi3-win_amd64.whl (9.1 MB view details)

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_x86_64.whl (9.7 MB view details)

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

pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_aarch64.whl (9.4 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

pyagentbrowser-0.33.0-cp311-abi3-macosx_11_0_arm64.whl (8.8 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.33.0-cp311-abi3-macosx_10_12_x86_64.whl (9.2 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file pyagentbrowser-0.33.0.tar.gz.

File metadata

  • Download URL: pyagentbrowser-0.33.0.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0.tar.gz
Algorithm Hash digest
SHA256 1742bb69e47fcd42c807912c6e9a2e09949e7d6a20379b2019e556fcc64c879b
MD5 f33e15c8bd45b2d3db7ae2b60029940c
BLAKE2b-256 afa38c2878612205d12f4d4ffb6adce4f19c960f632585e34445bdfe55ec0cd1

See more details on using hashes here.

File details

Details for the file pyagentbrowser-0.33.0-cp311-abi3-win_amd64.whl.

File metadata

  • Download URL: pyagentbrowser-0.33.0-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.1 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 9941822b0b04e6dc6134fed1df7918a96cf569c43ccb8d4f9b909ba5595c2656
MD5 79f6c346cccfaf08e0c446a033c825d0
BLAKE2b-256 b3105d8380896f795b4725e56aa7ba8402699ecca90b8ce1588b6b1c6606756e

See more details on using hashes here.

File details

Details for the file pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

  • Download URL: pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_x86_64.whl
  • Upload date:
  • Size: 9.7 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6bcc25e6f6c2325947349e9c9ec3569173822b03d6740a69812ad76c10ae1fd1
MD5 1041fa0af25b67449d3b33c52427a93a
BLAKE2b-256 d2e6c504e96dece53915269d1505b37e8b46dd968cd8bfcee7bcb0a4b11bcf0a

See more details on using hashes here.

File details

Details for the file pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_aarch64.whl.

File metadata

  • Download URL: pyagentbrowser-0.33.0-cp311-abi3-manylinux_2_28_aarch64.whl
  • Upload date:
  • Size: 9.4 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 4377cc30c4837a5f237d0ac54f752d3dc1ed589d0f7d7691bcd716db46a30e06
MD5 bd524fd57f26e1b2a9ecfff50bfc0052
BLAKE2b-256 854b694ab44817883382630beb64ff17a5ad855b41945a0b82323a5b6937f71c

See more details on using hashes here.

File details

Details for the file pyagentbrowser-0.33.0-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

  • Download URL: pyagentbrowser-0.33.0-cp311-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 8.8 MB
  • Tags: CPython 3.11+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1d8b124b7ff911cbadf3c6c8937e5982b5ba5b7285d9f2c31793d938738d25be
MD5 b4c3d33d0dfbe102e178305083c87c5b
BLAKE2b-256 39a20769d9e550a52ff5fe04effa08bd58d75fc460cd564ba6b3fea6a383aa7d

See more details on using hashes here.

File details

Details for the file pyagentbrowser-0.33.0-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

  • Download URL: pyagentbrowser-0.33.0-cp311-abi3-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 9.2 MB
  • Tags: CPython 3.11+, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.33.0-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 3003b1d4f7c12044d1441b21b9bd75513707260a07290085dce97f41e56df883
MD5 1dc345c42e1e2f3af8d6a11ecf45dc8f
BLAKE2b-256 3ef488ac321de1f73cbe19f379109e9a0886475ac089c1baa621d15f8e885dc9

See more details on using hashes here.

Release history Release notifications | RSS feed

0.37.0

6 files

0.36.0.2

6 files

0.36.0.1

6 files

0.36.0

6 files

0.35.1

6 files

0.35.0

6 files

0.34.0

6 files

0.33.1

6 files

This release

0.33.0 This release

6 files

0.32.3

6 files

Pre-release

0.31.2rc0

6 files

Pre-release

0.31.1rc6

6 files

Pre-release

0.31.1rc5

6 files

Pre-release

0.31.1rc4

5 files

Pre-release

0.31.1rc3

5 files

Pre-release

0.31.1rc2

5 files

Pre-release

0.31.1rc1

5 files

Pre-release

0.31.1rc0

5 files

Pre-release

0.27.1rc0

6 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page