lightpanda-io / browser

Lightpanda Browser 
 The headless browser built from scratch for AI agents and automation. 
Not a Chromium fork. Not a WebKit patch. A new browser, written in Zig. 
16x lighter and 9x faster than Chromium.
## Benchmarks
Requesting 933 real web pages over the network on a AWS EC2 m5.large instance.
See benchmark details.
| Metric | Lightpanda | Headless Chrome | Difference |
| :---- | :---- | :---- | :---- |
| Memory (peak, 100 pages) | 123MB | 2GB | ~16x less |
| Execution time (100 pages) | 5s | 46s | ~9x faster |
## Quick start
### Install
**Package Managers**
Latest nightly from Homebrew:
 [code] 
Latest nightly from Arch Linux User Repository:
 [code] 
**Download from the nightly builds**
You can download the last binary from the nightly
builds for
Linux and MacOS for both x86_64 and aarch64.
*For Linux*
 [code] 
Verify the binary before running anything:
 [code] 
Linux aarch64 is also available
> **Note:** The Linux release binaries are linked against glibc. On musl-based Linux distributions (Alpine, etc.) the binary fails with `cannot execute: required file not found` because the glibc dynamic linker is missing. Use a glibc-based base image (e.g., `FROM debian:bookworm-slim` or `FROM ubuntu:24.04`) or build from sources.
>
> **Android / Termux:** there is no native Android build. The Linux aarch64 binary needs the glibc loader (`/lib/ld-linux-aarch64.so.1`), which Android's Bionic libc does not provide, so it fails with the same `cannot execute: required file not found` error.
*For MacOS*
 [code] 
MacOS x86_64 is also available
*For Windows + WSL2*
Lightpanda has no native Windows binary. Install it inside WSL following the Linux steps above.
WSL not installed? Run `wsl --install` from an administrator shell, restart, then open `wsl`.
See Microsoft's WSL install guide for details.
Your automation client (Puppeteer, Playwright, etc.) can run either inside WSL or on the Windows host. WSL forwards `localhost:9222` automatically.
**Install from Docker**
Lightpanda provides official Docker
images for both Linux amd64 and
arm64 architectures.
The following command fetches the Docker image and starts a new container exposing Lightpanda's CDP server on port `9222`.
 [code] 
### Dump a URL
 [code] 
You can use `--dump markdown` to convert directly into markdown, or
`--dump png > page.png` or `--dump pdf > page.pdf` for a text-only rendering
of the page. `--dump structured_data` prints the page's JSON-LD, OpenGraph,
Twitter card, meta and link tags as JSON, like the MCP `structuredData` tool.
`--wait-until`, `--wait-ms`, `--wait-selector` and `--wait-script` are
available to adjust waiting time before dump.
### Start a CDP server
 [code] 
To listen on a Unix-domain socket (owner-only, mode 0600) instead of TCP:
 [code] 
Once the CDP server started, you can run a Puppeteer script by configuring the
`browserWSEndpoint`.
 Example Puppeteer script 
 [code] 
#### Start a webdriver Bidi server
Use `--protocol webdriver` to enable Bidi support.
You can star