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 28, 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 28, 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.1.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.1-cp311-abi3-win_amd64.whl (9.2 MB view details)

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.33.1-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.1-cp311-abi3-manylinux_2_28_aarch64.whl (9.4 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.33.1-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.1.tar.gz.

File metadata

  • Download URL: pyagentbrowser-0.33.1.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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.1.tar.gz
Algorithm Hash digest
SHA256 48665c676403343bba0d78be49eb4ba1f816a9eef67d8c070b664f90b820d281
MD5 b45c8d2875830266e9f6bf0c6466d4de
BLAKE2b-256 54b34f19e2798d88205093a6ed4425d444c1813487c4aa6ccd9040dca5cd390e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.33.1-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.2 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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.1-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8936feebc2195cd2ccf5414856d296df43c9d83616fde971718bda1402b12c38
MD5 2261c37d40fe187af410239de2a47b2a
BLAKE2b-256 58be4d733f9fe999a5161e26eb8fb667acb01cb2d7bdc6adb0718b58d096466b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.33.1-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.33 {"installer":{"name":"uv","version":"0.11.33","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.1-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c99ddefc694679808ecd60ab784a8bb0709becaaf256aeef46f7250b1755279e
MD5 2cd6d386c4cf19a62c9d8686c1bd3578
BLAKE2b-256 b5ec8be09a84728f19bac78f276967b11ded88b7e78ab4d9e7529765e471fde8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.33.1-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.33 {"installer":{"name":"uv","version":"0.11.33","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.1-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 330bfc0735b47e2918e2c0a8b98ea9036b141a1693b02b0b93e6f573df502367
MD5 5ea08d4bd15d0dba68f0f403037409b8
BLAKE2b-256 96bec9bb3d7df99f3f50c8e79abc6de9447b7784afd7dc67787edee83bc8e302

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.33.1-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.33 {"installer":{"name":"uv","version":"0.11.33","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.1-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c02841dc0ebf9c14887e290dbedd91110e3bf31ae9fbcdd0beef6334c32ce968
MD5 d07758264b828e4e2e32d45721e882f6
BLAKE2b-256 1e241baf0ab0be440f6cc12ab54dc1ae7fea57361ad6b3177e145a9a4889069b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.33.1-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.33 {"installer":{"name":"uv","version":"0.11.33","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.1-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 4c41dd53ecf624d19e710ee421884010d266ee10b4ee3ed045c5303e0a11a236
MD5 5508c673e58486e66989139cee612426
BLAKE2b-256 f822046b182269a20cf864fc136af37ac385d32f5e8f269ce23737a42c45dc16

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

This release

0.33.1 This release

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