pyagentbrowser

Native browser automation with typed Python APIs and before-and-after evidence.

Documentation · Get started · Examples · PyPI · Issues

PyPI version Python 3.11 through 3.14 Release Check Apache-2.0 license

Control browsers from Python with the native agent-browser engine. Inspect a page, act on an element, and get the before-and-after snapshots with a diff of what changed.

Alpha: The public API and native integration can change between minor releases. Pin a version for production automation.

Get started

python -m pip install pyagentbrowser

Requires Python 3.11 through 3.14. Local browsers run headlessly by default. The first launch finds Chrome or Chromium, or downloads Chrome for Testing when needed.

from agentbrowser import Browser

with Browser.launch() as browser:
    browser.page.set_content(
        "<button onclick=\"this.textContent='Done'\">Run</button>"
    )
    snapshot = browser.observe()
    result = snapshot.one(role="button", name="Run").click()

    print(result.after.one(role="button").name)
    print(result.diff.changed)

Done
True

observe() captures a Snapshot of the page's accessible elements. Selecting a button returns a Ref. Clicking it returns an ActionResult with before, after, and diff. Use browser.find for live element queries.

Browser workflows

  • Inspect and act. Navigate pages, fill forms, read documents, and capture screenshots and PDFs through typed namespaces.
  • Manage sessions. Launch a browser or attach to an existing one. Work with tabs, cookies, saved state, and explicit cleanup.
  • Control actions. Configure domain restrictions and confirmation policy for operations through the native engine.
  • Compose in Python. Use synchronous or asynchronous controllers, agent skills, and the complete engine protocol through browser.native.

Documentation

Get started · Concepts · Action evidence · Safety · API reference · Troubleshooting

The documentation site covers browser workflows, optional packages, supported platforms, and integrations. See examples for Python scripts and Contributing for development setup and checks.

License

pyagentbrowser is licensed under the Apache License 2.0. See NOTICE for bundled software attribution.

Project links

Data verified by PyPI on Sep 7, 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 7, 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.2.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.2-cp311-abi3-win_amd64.whl (9.1 MB view details)

Uploaded CPython 3.11+Windows x86-64

pyagentbrowser-0.36.0.2-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.36.0.2-cp311-abi3-manylinux_2_28_aarch64.whl (9.3 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

pyagentbrowser-0.36.0.2-cp311-abi3-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

pyagentbrowser-0.36.0.2-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.36.0.2.tar.gz.

File metadata

  • Download URL: pyagentbrowser-0.36.0.2.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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.2.tar.gz
Algorithm Hash digest
SHA256 6cbfb14460fbc9e5c122f7df3a7fa3fe237aa06f8e31c7e7d1b1070485e2c651
MD5 3a855f0869747fc8fd6ee8e5720f9792
BLAKE2b-256 3f0d2b4e2920e8e3b4e780025fe0f259110a464fcc29d4c4cc722f775ede4537

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.2-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.12.10 {"installer":{"name":"uv","version":"0.12.10","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.2-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7c608bcdc893aa12730ae7e845ea1a17ae4e3eb2ef833c7cb9c1a995bc9f27df
MD5 5c6788461277bfbd76478a3334729092
BLAKE2b-256 2a0c373833c7943decb7e3114de423813acc492762d8a5c98bca8f8613442142

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.2-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.10 {"installer":{"name":"uv","version":"0.12.10","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.2-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 931f1f530aeaea5d381754a3a86d0d5658d513f7495c36cb18ab6951436de7ca
MD5 949f9864a07931eceaf242b121cd1cde
BLAKE2b-256 573ac50b3ebc5d11fc83ffb8f4dfdebdb923af6f2d64d1982c4f3986b2b96278

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.2-cp311-abi3-manylinux_2_28_aarch64.whl
  • Upload date:
  • Size: 9.3 MB
  • Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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.2-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 627c2787bd72677350f2a43b29d17c793500129e9914b5c6281d86d7506cccb7
MD5 9be3871f8e7739b81d2500e882f25b7a
BLAKE2b-256 43bad4bb09b620b24731012e0a93bae0c1140b3b8c2046f9e10b678d84124a6c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.2-cp311-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 8.7 MB
  • Tags: CPython 3.11+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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.2-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 afa85bed8c65576e21f1f61085c824ee4255f74a70902c170a1054323c70746d
MD5 3badc4608c296a06baf2d349af6e936a
BLAKE2b-256 04148f772fa54c4da9204118f664269c3007b3a1289137eef30e3c7a97f1e90d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyagentbrowser-0.36.0.2-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.10 {"installer":{"name":"uv","version":"0.12.10","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.2-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 0417f401d0111bd4cb4ea3a44a0969b636b8ee8fbf52ddc83b8390c994475d9b
MD5 e5bf67672443c7a2f7c960f0a9f8bafb
BLAKE2b-256 72ce436e4d287669711f0e4b4bc4826115c1c3bc9bdc52145941f8e60499f0ee

See more details on using hashes here.

Release history Release notifications | RSS feed

0.37.0

6 files

This release

0.36.0.2 This release

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

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