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

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.34.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.34.0-cp311-abi3-manylinux_2_28_aarch64.whl (9.5 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.34.0-cp311-abi3-macosx_10_12_x86_64.whl (9.3 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.0.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0.tar.gz
Algorithm Hash digest
SHA256 ffac51e43d410a0d99af108268006e04637b221bc66ae2cecd8e9ff1d04faaed
MD5 e113a93dcc19d5988a94103ec4b34e9e
BLAKE2b-256 c5da4110aeca6076466558a99241d7c99377bdc16143a4a3798a729603239237

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.0-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.12.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 ffb716a5826736de4b05248662d78bd6d63761d95144b6a6e9707a2f8452e878
MD5 0f7646174d5f8ce036ac1ba1aa1eb614
BLAKE2b-256 7363f1ddb0649b73ff420dd6adda39f4fa9552dfe0203ca907d76522384c89c5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.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.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 516f400f6d4cc385e6730f75b03a7c24972497f7cd18b8e20c020c1102a28430
MD5 d6718d240928cdf81f3ef7a3ad0478c3
BLAKE2b-256 c43ff31b3b4fbe661bd85d440c7c222b210c3910d42a237594f1e5641fd99afe

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.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.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 32c3bdf8a101469615aa7575794c7dfe0456719bb076fac1212dd4a937314875
MD5 6e0b91e323cf2e83999c8f2438e84bc7
BLAKE2b-256 205bec8e2e60591b0f6949d1a977879a8bf12287c1291aa1e25dd03633a13923

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.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.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 78fb4d28cd7c40c114514ce0ba16995d5933f996a52efcc544a09e72fbe06a57
MD5 444e484d1eab5ee1ed86f4b9341daf0d
BLAKE2b-256 c4dfb1d081783a69ce172f0faf9242d9f057bff29b39c4d88fa461fb3c1b4979

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.34.0-cp311-abi3-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 9.3 MB
  • Tags: CPython 3.11+, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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.34.0-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 ef314eef6c681869476240125dddeb1d3e189595fa4c0790a4b2805469d5285d
MD5 5c1072693c092c068cce0cad919d0155
BLAKE2b-256 099e92d34e0f7d7855b4a4583146b2b876937bfd3decdad420bed3ad22558497

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

This release

0.34.0 This release

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