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.webmcp 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 Sep 1, 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 Sep 1, 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.36.0.tar.gz (1.1 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.36.0-cp311-abi3-win_amd64.whl (9.4 MB view details)

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.36.0-cp311-abi3-manylinux_2_28_x86_64.whl (9.9 MB view details)

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

pyagentbrowser-0.36.0-cp311-abi3-manylinux_2_28_aarch64.whl (9.6 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

pyagentbrowser-0.36.0-cp311-abi3-macosx_11_0_arm64.whl (9.0 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.36.0-cp311-abi3-macosx_10_12_x86_64.whl (9.5 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0.tar.gz
Algorithm Hash digest
SHA256 81145f39fe0f49f7061fece0c890bc2fbd9e949d75e82b1a1bed7fe008ad2e3c
MD5 2efad7da5ea7248c5137848279b1f4d9
BLAKE2b-256 7cde3aafc4bd8ba5c84fcdb41202d679a69b14349c10fc7079129d2a5a3399c8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.4 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 e167a168ca6ac9a39bfcd0a7aab24a96f55dfb53ce179a0f08aed0fda6a4ecad
MD5 4d90d8e360735e71459889e5050be22b
BLAKE2b-256 132f1e5d1ae72666022ba42bb1cc8cf07e8dd2a8de7a634d9d422fd5217fac1a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0-cp311-abi3-manylinux_2_28_x86_64.whl
  • Upload date:
  • Size: 9.9 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 05e57b36607b49976096a50c295b19155fa5005e8e9925e6215f600507925a0c
MD5 39a6137ef0899ec4694205895f109c4d
BLAKE2b-256 9f89ff8c7b7d40f529c21a4bb081daec8789229f9c084bb0a0189744f9687abc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0-cp311-abi3-manylinux_2_28_aarch64.whl
  • Upload date:
  • Size: 9.6 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 183c6eed35c7c39d1e4101885c125fd161616973523e5563bc1c7cd01556f9de
MD5 4b5adc11970fbf651878edb3fb2fb4f7
BLAKE2b-256 a293d3e4d2f96f5f1ab7ff6477081b4fd88d7ae6f58dd234203e301f585368a9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0-cp311-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 9.0 MB
  • Tags: CPython 3.11+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5c7227e6444a1849a2cba23765a558225838dc112b830fbb3f230e1970f0b5b3
MD5 bbd8c3e6853ae7ec45c526d4427072bf
BLAKE2b-256 c0e12c48e38e58cd15491f80b5f46d074720a29be4b3705da44f6d7a100b14ab

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0-cp311-abi3-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 9.5 MB
  • Tags: CPython 3.11+, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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.36.0-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 a7a816a36395c7072b0c124d2d0a3b36cca047389df5d2df7da2b9b635cbe42a
MD5 305c81b6a4b7801e84d339e3b77f75ec
BLAKE2b-256 baaa4bf9d4528a2f270083de51eddd9204e44ec293b3430dcd411167c5ac7cb3

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

This release

0.36.0 This release

6 files

0.35.1

6 files

0.35.0

6 files

0.34.0

6 files

0.33.1

6 files

0.33.0

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