unbrowser

Web access for LLM agents. One static binary. No Chrome.

Single-file native headless browser optimized for LLM agents. Runs JavaScript via QuickJS, returns a low-token page summary on every navigate, and gives you stable element refs for click/type/submit. Tens of MB RAM per session, no Chrome dependency.

pip install pyunbrowser   # PyPI name; the import is `from unbrowser import ...`

The wheel ships the native binary for your platform — there's nothing else to install.

For transparent bot-wall cookie handoff through local Chrome, install the optional solver extra:

pip install 'pyunbrowser[solver]'  # includes unchainedsky-cli
unbrowser cookie-service --headless --profile unbrowser-cookie-service
unbrowser router https://example.com/protected

The solver service binds to 127.0.0.1 by default and returns cookies from the user's local Chrome/unchained session. It does not fabricate challenge tokens. Private/reserved/internal hosts are rejected unless explicitly allowed with --allow-host. Non-loopback binds are rejected unless --allow-remote-bind is passed because /solve is unauthenticated and can return browser cookies. Router refuses non-loopback cookie service URLs by default because it sends target URLs and challenge metadata to that service; use --allow-remote-cookie-service only for a trusted remote solver.

Quick start

from unbrowser import Client

with Client() as ub:
    r = ub.navigate("https://news.ycombinator.com")
    for s in ub.query(".titleline > a")[:3]:
        print(s["text"], s["attrs"]["href"])

Why

	curl	This	Playwright / headless Chrome
Static / SSR pages	✅ but token-heavy	✅ low-token BlockMap	overkill
SPA-shell sites (with `exec_scripts`)	❌	⚠️ partial	✅
Bot-walled (cookie handoff)	❌	✅	✅
Run in Lambda / Workers / edge	✅	✅	❌ Chrome too big
Per-page cost at 100K/day	~free	~free	$$$
LLM-shaped output	DIY parse	✅ inline BlockMap	DIY parse

What it does

navigate(url) — fetch, parse, return {status, url, bytes, headers, blockmap, challenge}. With exec_scripts=True, runs page JS in QuickJS (bounded by a 30s watchdog so it can't wedge).
query(selector) — CSS query → [{ref, tag, attrs, text, text_chars, text_truncated}]. Refs are stable handles for click/type/submit.
query_debug(selector) — diagnose selector misses with match counts, samples, DOM summary, and selector hints.
extract() — auto-strategy structured data: tries JSON-LD → __NEXT_DATA__ → Nuxt → OpenGraph → microdata → text fallback, returns highest-confidence hit.
extract_table(selector) / table_to_json(selector="table") — normalize HTML tables into headers, rows, and row count.
click(ref) / type(ref, text) / submit(ref) — interaction. GET and application/x-www-form-urlencoded POST forms supported; multipart is not yet supported. Checked checkbox/radio values are serialized.
cookies_set(...) — paste cookies from a real Chrome session to bypass bot detection (Cloudflare, PerimeterX, Datadome). Solve once, replay forever.

Full RPC reference, BlockMap shape, challenge detection, profile system, and architecture: github.com/protostatis/unbrowser.

Honest limits

Heavy framework SPAs (Ember/React) often don't auto-mount inside QuickJS even with exec_scripts=True — the watchdog ensures it returns, check density.likely_js_filled to decide whether to escalate.
No screenshots (out of scope by design).
Hardest-tier anti-bot (FingerprintJS Pro, Kasada, advanced Akamai BMP) needs the cookie handoff path. The binary detects and labels the challenge for you.

License

Apache-2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl (4.4 MB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.35+ ARM64

pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl (4.5 MB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.31+ x86-64

pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl (4.1 MB view details)

Uploaded Jul 28, 2026 Python 3macOS 11.0+ ARM64

pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl (4.4 MB view details)

Uploaded Jul 28, 2026 Python 3macOS 10.12+ x86-64

File details

Details for the file pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl.

File metadata

Download URL: pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl
Upload date: Jul 28, 2026
Size: 4.4 MB
Tags: Python 3, manylinux: glibc 2.35+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl
Algorithm	Hash digest
SHA256	`4ddfc00b9a7b96f38c5246cf05ea3734d6dcef27f2a4676180e3473da8c99d9e`
MD5	`15c1b0168bb9fd882c746aff3e746817`
BLAKE2b-256	`f13ac3ce14d9308e06c1fdb6ca386725a739087e14a5c454fa207449e2e79cd2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl:

Publisher: release.yml on protostatis/unbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyunbrowser-0.0.18-py3-none-manylinux_2_35_aarch64.whl
- Subject digest: 4ddfc00b9a7b96f38c5246cf05ea3734d6dcef27f2a4676180e3473da8c99d9e
- Sigstore transparency entry: 2270802154
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: protostatis/unbrowser@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Branch / Tag: refs/tags/v0.0.18
- Owner: https://github.com/protostatis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Trigger Event: push

File details

Details for the file pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl.

File metadata

Download URL: pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl
Upload date: Jul 28, 2026
Size: 4.5 MB
Tags: Python 3, manylinux: glibc 2.31+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl
Algorithm	Hash digest
SHA256	`2e89bb5b4ed5dd90195ac4092119ab29d3a57207c7e19340d12fdd80e1cd1b7c`
MD5	`2db643a5d03a54f3f071b7e6711e4a69`
BLAKE2b-256	`fc0395e0ba0ac52abeb1ffe85620cca82cb40f44b1d2021d20ed9bf2d1962b63`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl:

Publisher: release.yml on protostatis/unbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyunbrowser-0.0.18-py3-none-manylinux_2_31_x86_64.whl
- Subject digest: 2e89bb5b4ed5dd90195ac4092119ab29d3a57207c7e19340d12fdd80e1cd1b7c
- Sigstore transparency entry: 2270803116
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: protostatis/unbrowser@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Branch / Tag: refs/tags/v0.0.18
- Owner: https://github.com/protostatis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Trigger Event: push

File details

Details for the file pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 28, 2026
Size: 4.1 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`77b44c894c8cdb388181e8fa715ab4b5cd33b4ddec00966a7975d09845ccc3d4`
MD5	`eb39783966d98154c8540238ffbbea40`
BLAKE2b-256	`111d57675ef4277b32aee30be5584882102afe2159cad1919522fac3134c6d85`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on protostatis/unbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyunbrowser-0.0.18-py3-none-macosx_11_0_arm64.whl
- Subject digest: 77b44c894c8cdb388181e8fa715ab4b5cd33b4ddec00966a7975d09845ccc3d4
- Sigstore transparency entry: 2270802676
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: protostatis/unbrowser@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Branch / Tag: refs/tags/v0.0.18
- Owner: https://github.com/protostatis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Trigger Event: push

File details

Details for the file pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl
Upload date: Jul 28, 2026
Size: 4.4 MB
Tags: Python 3, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`2890d1e8c121ed31a43738693f4013742b12981a0095e66dee3a37157dd3aaa3`
MD5	`672a2ac8605ecc656b81b031eefbdf5b`
BLAKE2b-256	`30e44654b421856e98c801725d8ac575598d2ee7cadd8162a1e4b8db402fbbbf`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl:

Publisher: release.yml on protostatis/unbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyunbrowser-0.0.18-py3-none-macosx_10_12_x86_64.whl
- Subject digest: 2890d1e8c121ed31a43738693f4013742b12981a0095e66dee3a37157dd3aaa3
- Sigstore transparency entry: 2270803408
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: protostatis/unbrowser@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Branch / Tag: refs/tags/v0.0.18
- Owner: https://github.com/protostatis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@75bc8bfa4bd515babe45d0de2a1aadf59b7b8770
- Trigger Event: push