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 Aug 25, 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 Aug 25, 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.35.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.35.0-cp311-abi3-win_amd64.whl (9.3 MB view details)

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.35.0-cp311-abi3-manylinux_2_28_x86_64.whl (9.8 MB view details)

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

pyagentbrowser-0.35.0-cp311-abi3-manylinux_2_28_aarch64.whl (9.5 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

pyagentbrowser-0.35.0-cp311-abi3-macosx_11_0_arm64.whl (8.9 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.35.0-cp311-abi3-macosx_10_12_x86_64.whl (9.4 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0.tar.gz
Algorithm Hash digest
SHA256 da9a7961a6fbeecb7449d38933da5a312360ccc1ec9f8e0740397a06d08d931f
MD5 b8b21690c3b4be6fc10556f91c7d9beb
BLAKE2b-256 5b9f680bfbf9ebcfd40f7496e2a86b97fb9e6e8a9176af50f7a6988fa66e78f7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.3 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 d4920f402e0abe5d7d0bca11fd9ac015a31077525f44bf5128f6015613b185f9
MD5 4b1296b02cd2aafc986dec0c85fa661c
BLAKE2b-256 ac7105982472e0b06c8f1fc4f2d46e55e0b980ec9507714f58b754d449251135

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0-cp311-abi3-manylinux_2_28_x86_64.whl
  • Upload date:
  • Size: 9.8 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6058f666369378a82b0572ca1825f4232a865b30c2d3eb68e9deb7ccc55efd60
MD5 032051b910f4ddc05eab9a5b7c396fa1
BLAKE2b-256 1f0d2a41a9079704802b3d010b5236faca9386668d75a6390f412b55c1443c41

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0-cp311-abi3-manylinux_2_28_aarch64.whl
  • Upload date:
  • Size: 9.5 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 4ab54645d4ad47f54bb57648a32a6e1071f840f38600a39ce926810812b3750f
MD5 0a4308876784342053e5fea3074161c6
BLAKE2b-256 86d9552448a22e5d0e693cb5da9ae1aabadafd8ebce5bd2ffa0d896498268eb9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0-cp311-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 8.9 MB
  • Tags: CPython 3.11+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 cb07d07ef0f298b192f60a6e21111a21633d5e33252c14835d967dd1417a0c73
MD5 934ad91c4717440c6b97f3dabe2020a8
BLAKE2b-256 39139d848bb8eb3c59970eb7eaf7dad65d9ea9f1739081e792c90422ad3d8aa4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.35.0-cp311-abi3-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 9.4 MB
  • Tags: CPython 3.11+, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.35.0-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 c832e51c21a6e8b63ca2373ad7a9561ad271d8edec411d97a7355aa29ada9424
MD5 1d87e5220acfbb143dd24a445eb8f762
BLAKE2b-256 03df6d2bae7892537fc135cacc1f85259c14b8048642011d3dc69da4c963ead4

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

This release

0.35.0 This release

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