lightpanda-io/browserPublic

Lightpanda: the headless browser designed for AI and automation

AI summary: A headless browser built in Zig specifically designed for AI agents and web scraping.

Stars
42.2K
+167 today
Forks
2.1K
Watchers
105
Open issues
56
Open PRs
29
Contributors
~94
Commits
12.2K
Branches
55
Views (30d)
5

ZigAGPL-3.0Created Feb 7, 2023Last push 1d agoLatest release 1.0.4+336 stars this week+5.5K this month

Quick answers

What is browser?
A headless browser built in Zig specifically designed for AI agents and web scraping.
What does browser do?
Lightpanda is a modern, ultra-fast headless browser engineered from the ground up in the Zig programming language, tailored specifically for AI agents, automation, and web scraping. Unlike traditional headless browsers (like Puppeteer or Playwright wrapping Chromium) which carry significant overhead, Lightpanda is designed to be extremely lightweight and fast by shedding unnecessary features like a graphical rendering pipeline. It focuses on rapid DOM parsing, JavaScript execution, and network interception, making it ideal for tasks where raw speed and low resource consumption are critical. It provides an API optimized for programmatic interaction rather than human viewing.
Who is browser for?
Lightpanda is for developers building web-scraping infrastructure, AI agents that need internet access, and automated testing tools. It appeals to those looking for a high-performance alternative to traditional headless browsers.
How do I get started with browser?
zig build
How popular is browser on GitHub?
lightpanda-io/browser has 42,242 stars and 2,141 forks on GitHub, and gained 336 stars in the last 7 days.
What license does browser use?
lightpanda-io/browser is released under the AGPL-3.0 license.

Star history

since Jul 29, 2026
020K40KJul 2026Sep 2026Oct 2026Nov 2026
42.2K stars as of Nov 19, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Update history

3 recorded
  • Nov 15, 2026New release 1.0.4 (previously 1.0.2).
  • Oct 25, 2026New release 1.0.2 (previously 1.0.0).
  • Oct 15, 2026New release 1.0.0 (previously nightly).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 10 commits2025-11-25: 16 commits2025-11-26: 20 commits2025-11-27: 8 commits2025-11-28: 5 commits2025-11-29: 2 commits2025-11-30: 1 commit2025-12-01: 14 commits2025-12-02: 12 commits2025-12-03: 9 commits2025-12-04: 5 commits2025-12-05: 11 commits2025-12-06: 5 commits2025-12-07: 4 commits2025-12-08: 35 commits2025-12-09: 36 commits2025-12-10: 7 commits2025-12-11: 20 commits2025-12-12: 9 commits2025-12-13: 5 commits2025-12-14: 2 commits2025-12-15: 8 commits2025-12-16: 7 commits2025-12-17: 3 commits2025-12-18: 9 commits2025-12-19: 12 commits2025-12-20: 1 commit2025-12-21: 5 commits2025-12-22: 24 commits2025-12-23: 8 commits2025-12-24: 27 commits2025-12-25: 16 commits2025-12-26: 5 commits2025-12-27: 1 commit2025-12-28: 0 commits2025-12-29: 22 commits2025-12-30: 11 commits2025-12-31: 8 commits2026-01-01: 2 commits2026-01-02: 6 commits2026-01-03: 0 commits2026-01-04: 4 commits2026-01-05: 14 commits2026-01-06: 19 commits2026-01-07: 38 commits2026-01-08: 11 commits2026-01-09: 32 commits2026-01-10: 9 commits2026-01-11: 2 commits2026-01-12: 19 commits2026-01-13: 8 commits2026-01-14: 25 commits2026-01-15: 23 commits2026-01-16: 19 commits2026-01-17: 3 commits2026-01-18: 4 commits2026-01-19: 18 commits2026-01-20: 17 commits2026-01-21: 14 commits2026-01-22: 7 commits2026-01-23: 13 commits2026-01-24: 11 commits2026-01-25: 0 commits2026-01-26: 7 commits2026-01-27: 18 commits2026-01-28: 22 commits2026-01-29: 15 commits2026-01-30: 16 commits2026-01-31: 10 commits2026-02-01: 0 commits2026-02-02: 9 commits2026-02-03: 15 commits2026-02-04: 38 commits2026-02-05: 20 commits2026-02-06: 10 commits2026-02-07: 12 commits2026-02-08: 11 commits2026-02-09: 32 commits2026-02-10: 22 commits2026-02-11: 18 commits2026-02-12: 30 commits2026-02-13: 8 commits2026-02-14: 14 commits2026-02-15: 15 commits2026-02-16: 24 commits2026-02-17: 57 commits2026-02-18: 48 commits2026-02-19: 48 commits2026-02-20: 26 commits2026-02-21: 13 commits2026-02-22: 6 commits2026-02-23: 13 commits2026-02-24: 33 commits2026-02-25: 40 commits2026-02-26: 29 commits2026-02-27: 25 commits2026-02-28: 23 commits2026-03-01: 20 commits2026-03-02: 49 commits2026-03-03: 33 commits2026-03-04: 29 commits2026-03-05: 17 commits2026-03-06: 20 commits2026-03-07: 4 commits2026-03-08: 8 commits2026-03-09: 46 commits2026-03-10: 52 commits2026-03-11: 38 commits2026-03-12: 33 commits2026-03-13: 24 commits2026-03-14: 34 commits2026-03-15: 21 commits2026-03-16: 35 commits2026-03-17: 44 commits2026-03-18: 37 commits2026-03-19: 51 commits2026-03-20: 22 commits2026-03-21: 27 commits2026-03-22: 11 commits2026-03-23: 34 commits2026-03-24: 31 commits2026-03-25: 25 commits2026-03-26: 41 commits2026-03-27: 23 commits2026-03-28: 2 commits2026-03-29: 6 commits2026-03-30: 35 commits2026-03-31: 27 commits2026-04-01: 28 commits2026-04-02: 22 commits2026-04-03: 26 commits2026-04-04: 6 commits2026-04-05: 2 commits2026-04-06: 9 commits2026-04-07: 36 commits2026-04-08: 41 commits2026-04-09: 38 commits2026-04-10: 63 commits2026-04-11: 18 commits2026-04-12: 14 commits2026-04-13: 37 commits2026-04-14: 18 commits2026-04-15: 20 commits2026-04-16: 15 commits2026-04-17: 28 commits2026-04-18: 10 commits2026-04-19: 2 commits2026-04-20: 37 commits2026-04-21: 13 commits2026-04-22: 21 commits2026-04-23: 25 commits2026-04-24: 39 commits2026-04-25: 11 commits2026-04-26: 7 commits2026-04-27: 39 commits2026-04-28: 50 commits2026-04-29: 51 commits2026-04-30: 38 commits2026-05-01: 6 commits2026-05-02: 7 commits2026-05-03: 0 commits2026-05-04: 48 commits2026-05-05: 25 commits2026-05-06: 30 commits2026-05-07: 45 commits2026-05-08: 15 commits2026-05-09: 13 commits2026-05-10: 7 commits2026-05-11: 63 commits2026-05-12: 52 commits2026-05-13: 75 commits2026-05-14: 37 commits2026-05-15: 31 commits2026-05-16: 19 commits2026-05-17: 8 commits2026-05-18: 8 commits2026-05-19: 30 commits2026-05-20: 29 commits2026-05-21: 41 commits2026-05-22: 50 commits2026-05-23: 7 commits2026-05-24: 13 commits2026-05-25: 30 commits2026-05-26: 23 commits2026-05-27: 16 commits2026-05-28: 33 commits2026-05-29: 21 commits2026-05-30: 33 commits2026-05-31: 13 commits2026-06-01: 41 commits2026-06-02: 33 commits2026-06-03: 54 commits2026-06-04: 45 commits2026-06-05: 51 commits2026-06-06: 17 commits2026-06-07: 4 commits2026-06-08: 42 commits2026-06-09: 41 commits2026-06-10: 12 commits2026-06-11: 36 commits2026-06-12: 35 commits2026-06-13: 6 commits2026-06-14: 7 commits2026-06-15: 24 commits2026-06-16: 27 commits2026-06-17: 40 commits2026-06-18: 39 commits2026-06-19: 14 commits2026-06-20: 2 commits2026-06-21: 2 commits2026-06-22: 17 commits2026-06-23: 15 commits2026-06-24: 10 commits2026-06-25: 19 commits2026-06-26: 27 commits2026-06-27: 13 commits2026-06-28: 8 commits2026-06-29: 17 commits2026-06-30: 27 commits2026-07-01: 27 commits2026-07-02: 30 commits2026-07-03: 35 commits2026-07-04: 18 commits2026-07-05: 6 commits2026-07-06: 14 commits2026-07-07: 12 commits2026-07-08: 17 commits2026-07-09: 12 commits2026-07-10: 76 commits2026-07-11: 68 commits2026-07-12: 29 commits2026-07-13: 33 commits2026-07-14: 73 commits2026-07-15: 66 commits2026-07-16: 35 commits2026-07-17: 37 commits2026-07-18: 4 commits2026-07-19: 1 commit2026-07-20: 26 commits2026-07-21: 30 commits2026-07-22: 28 commits2026-07-23: 31 commits2026-07-24: 21 commits2026-07-25: 15 commits2026-07-26: 9 commits2026-07-27: 19 commits2026-07-28: 28 commits2026-07-29: 32 commits2026-07-30: 17 commits2026-07-31: 9 commits2026-08-01: 7 commits2026-08-02: 4 commits2026-08-03: 16 commits2026-08-04: 23 commits2026-08-05: 20 commits2026-08-06: 24 commits2026-08-07: 15 commits2026-08-08: 5 commits2026-08-09: 0 commits2026-08-10: 10 commits2026-08-11: 15 commits2026-08-12: 21 commits2026-08-13: 30 commits2026-08-14: 21 commits2026-08-15: 14 commits2026-08-16: 4 commits2026-08-17: 13 commits2026-08-18: 35 commits2026-08-19: 32 commits2026-08-20: 11 commits2026-08-21: 33 commits2026-08-22: 8 commits2026-08-23: 3 commits2026-08-24: 14 commits2026-08-25: 52 commits2026-08-26: 42 commits2026-08-27: 59 commits2026-08-28: 34 commits2026-08-29: 16 commits2026-08-30: 5 commits2026-08-31: 24 commits2026-09-01: 38 commits2026-09-02: 38 commits2026-09-03: 20 commits2026-09-04: 20 commits2026-09-05: 15 commits2026-09-06: 15 commits2026-09-07: 27 commits2026-09-08: 15 commits2026-09-09: 32 commits2026-09-10: 35 commits2026-09-11: 35 commits2026-09-12: 17 commits2026-09-13: 29 commits2026-09-14: 38 commits2026-09-15: 39 commits2026-09-16: 45 commits2026-09-17: 45 commits2026-09-18: 28 commits2026-09-19: 12 commits2026-09-20: 2 commits2026-09-21: 25 commits2026-09-22: 42 commits2026-09-23: 53 commits2026-09-24: 41 commits2026-09-25: 26 commits2026-09-26: 17 commits2026-09-27: 13 commits2026-09-28: 35 commits2026-09-29: 15 commits2026-09-30: 37 commits2026-10-01: 48 commits2026-10-02: 31 commits2026-10-03: 32 commits2026-10-04: 15 commits2026-10-05: 66 commits2026-10-06: 75 commits2026-10-07: 56 commits2026-10-08: 68 commits2026-10-09: 66 commits2026-10-10: 29 commits2026-10-11: 9 commits2026-10-12: 63 commits2026-10-13: 47 commits2026-10-14: 48 commits2026-10-15: 52 commits2026-10-16: 50 commits2026-10-17: 34 commits2026-10-18: 38 commits2026-10-19: 35 commits2026-10-20: 78 commits2026-10-21: 84 commits2026-10-22: 57 commits2026-10-23: 51 commits2026-10-24: 37 commits2026-10-25: 10 commits2026-10-26: 46 commits2026-10-27: 56 commits2026-10-28: 54 commits2026-10-29: 61 commits2026-10-30: 77 commits2026-10-31: 37 commits2026-11-01: 24 commits2026-11-02: 86 commits2026-11-03: 58 commits2026-11-04: 78 commits2026-11-05: 69 commits2026-11-06: 67 commits2026-11-07: 28 commits2026-11-08: 17 commits2026-11-09: 37 commits2026-11-10: 39 commits2026-11-11: 46 commits2026-11-12: 48 commits2026-11-13: 37 commits2026-11-14: 30 commits2026-11-15: 7 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
9,142 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    42,242 stars

  • Very active

    9,142 commits in 52 weeks

  • Continuous integration

    Automated checks passing

  • Repeat trending

    12 trending appearances

What browser does

Lightpanda is a modern, ultra-fast headless browser engineered from the ground up in the Zig programming language, tailored specifically for AI agents, automation, and web scraping. Unlike traditional headless browsers (like Puppeteer or Playwright wrapping Chromium) which carry significant overhead, Lightpanda is designed to be extremely lightweight and fast by shedding unnecessary features like a graphical rendering pipeline. It focuses on rapid DOM parsing, JavaScript execution, and network interception, making it ideal for tasks where raw speed and low resource consumption are critical. It provides an API optimized for programmatic interaction rather than human viewing.

Lightpanda is for developers building web-scraping infrastructure, AI agents that need internet access, and automated testing tools. It appeals to those looking for a high-performance alternative to traditional headless browsers.

  • Zig implementation: Written in Zig for high performance, memory safety, and minimal resource footprint.
  • Purpose-built for headless: Strips out graphical rendering engines and UI components to maximize speed and efficiency.
  • AI agent optimized: Provides APIs and data structures specifically designed to feed web content to large language models.
  • Fast DOM manipulation: Implements a highly optimized Document Object Model parser for rapid content extraction.
  • Low latency execution: Reduces the overhead of starting and running browser instances compared to traditional Chromium-based tools.
  • Native language bindings: Offers easy integration with languages commonly used for AI and scraping, such as Python and JavaScript.

Where teams use it

AI web browsing agents

Developers integrate it into AI agents to allow them to quickly navigate the web, read pages, and interact with sites.

High-scale web scraping

Data engineers use it to build highly concurrent scraping pipelines that consume significantly less memory than Chromium.

Automated testing

QA teams leverage its speed to run massive suites of end-to-end web tests in a fraction of the time.

Serverless automation

Platform engineers deploy it in serverless environments where startup time and memory constraints are critical factors.

Getting started: zig build

README

main branch

Logo

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.

License Twitter Follow GitHub stars Discord

 

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:

brew install lightpanda-io/browser/lightpanda

Latest nightly from Arch Linux User Repository:

yay -S lightpanda-nightly-bin

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

curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && \
chmod a+x ./lightpanda

Verify the binary before running anything:

./lightpanda version

Linux aarch64 is also available

If you use Nix, you can run Lightpanda directly from the flake without downloading a binary:

nix run github:lightpanda-io/browser -- --help

Or pin it as an input in your own flake:

{
  inputs.lightpanda.url = "github:lightpanda-io/browser";
}

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: the current release binaries need glibc 2.35 (x86_64) or 2.38 (arm64), so debian:bookworm-slim (2.36) is fine on x86_64 but too old for arm64 — use FROM ubuntu:24.04, FROM debian:trixie-slim, or FROM debian:forky-slim there — 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

curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos && \
chmod a+x ./lightpanda

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.

docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:latest

Dump a URL

./lightpanda fetch --obey-robots --dump html --log-format pretty  --log-level info https://demo-browser.lightpanda.io/campfire-commerce/

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

./lightpanda serve --obey-robots --log-format pretty  --log-level info --host 127.0.0.1 --port 9222

To listen on a Unix-domain socket (owner-only, mode 0600) instead of TCP:

./lightpanda serve --unix-socket /run/user/1000/lightpanda.sock

Once the CDP server started, you can run a Puppeteer script by configuring the browserWSEndpoint.

Example Puppeteer script
import puppeteer from 'puppeteer-core';

// use browserWSEndpoint to pass the Lightpanda's CDP server address.
const browser = await puppeteer.connect({
  browserWSEndpoint: "ws://127.0.0.1:9222",
});

// The rest of your script remains the same.
const context = await browser.createBrowserContext();
const frame = await context.newPage();

// Dump all the links from the frame.
await frame.goto('https://demo-browser.lightpanda.io/amiibo/', {waitUntil: "networkidle0"});

const links = await frame.evaluate(() => {
  return Array.from(document.querySelectorAll('a')).map(row => {
    return row.getAttribute('href');
  });
});

console.log(links);

await frame.close();
await context.close();
await browser.disconnect();
Start a webdriver Bidi server

Use --protocol webdriver to enable Bidi support. You can start both, CDP and Bidi, with --protocol webdriver --protocol cdp

./lightpanda serve --obey-robots --log-format pretty  --log-level info --host 127.0.0.1 --port 9222 --protocol webdriver

Agent mode

lightpanda agent lets you drive the browser with a native agent. Describe what you want in plain English or with slash commands, and it controls the browser: navigating pages, clicking through flows, filling forms, extracting structured data. Think of it as a robot you're directing to use the web, more than a chatbot you're having a conversation with.

Because the agent runs inside the same process as the browser, every tool call is a direct operation and you retain Lightpanda's speed and memory advantage.

The output of an agent session is a PandaScript: vanilla JavaScript with a small set of native browser primitives built directly into Lightpanda. Run /save to export one from your current session, then replay it with lightpanda run <script>.js. Scripts are deterministic and token-free, so you can prototype with the LLM and ship the output to production without a model at runtime.

It supports Anthropic, OpenAI, Gemini, Google Vertex AI, Mistral, Hugging Face, the multi-lab gateways Vercel AI Gateway and OpenRouter (one key for hundreds of models), any OpenAI-compatible endpoint via OPENAI_BASE_URL, local models via Ollama, llama.cpp or LLMD, and OpenAI Codex with a ChatGPT subscription instead of an API key (run /provider codex in the REPL to log in). You can also run without an LLM using --no-llm, which drops you into the REPL. See the agent documentation for the full reference.

./lightpanda agent                                    # auto-detects API key from env
./lightpanda agent --task "top story on news.ycombinator.com?"
./lightpanda agent --no-llm                           # basic REPL, no LLM
./lightpanda run session.js                           # run a recorded script
cat session.js | ./lightpanda run -                   # ...or pipe one in via stdin
./lightpanda agent --provider gemini --task "..."     # force a specific provider
./lightpanda agent --list-models                      # models available for the detected provider
VERTEX_API_KEY=... ./lightpanda agent --provider vertex             # Vertex AI, express mode
GOOGLE_CLOUD_PROJECT=my-proj ./lightpanda agent --provider vertex   # Vertex AI, token via gcloud auth
AI_GATEWAY_API_KEY=... ./lightpanda agent --provider vercel --model moonshotai/kimi-k2   # any model behind Vercel AI Gateway
OPENROUTER_API_KEY=... ./lightpanda agent --provider openrouter --model anthropic/claude-sonnet-5   # any model behind OpenRouter
OPENAI_BASE_URL=https://my-gateway/v1 OPENAI_API_KEY=... ./lightpanda agent            # any OpenAI-compatible server

Native MCP and skill

The MCP server communicates via MCP JSON-RPC 2.0 over stdio.

Add to your MCP configuration:

{
  "mcpServers": {
    "lightpanda": {
      "command": "/path/to/lightpanda",
      "args": ["mcp"]
    }
  }
}
HTTP transport and independent sessions

For serving several agents from one process, start the MCP server over HTTP instead of stdio by giving it a port (add --host x.x.x.x to specify the interface to listen on):

lightpanda mcp --port 9223

Clients POST JSON-RPC to http://host:9223/mcp. Each connection is routed to its own browsing session — its own page, cookies and memory — so agents no longer clobber each other's page:

  • A client that initializes without an Mcp-Session-Id header is assigned a fresh session; the id comes back in the response's Mcp-Session-Id header. Send it on subsequent requests to stay on that session (isolation).
  • Two agents that send the same Mcp-Session-Id share one browsing context (sharing — e.g. a workflow where several agents work the same page).
  • The session_new, session_list and session_close tools manage sessions explicitly. Sending DELETE /mcp with an Mcp-Session-Id closes that session.

The run tool runs a PandaScript in the caller's session, as lightpanda run does, and returns its console output and the value it returns. It takes the source as script, or the path of a file that save wrote. Pages the script opens are closed when it ends; cookies and storage stay, so a login carries over to the next run. An optional timeout in milliseconds (default 60000) stops a stuck script. A backend can drive Lightpanda with one POST:

curl -s http://127.0.0.1:9223/mcp -H 'Content-Type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "run", "arguments": { "script":
    "const page = new Page();\nawait page.goto(\"https://example.com\");\nreturn page.extract({ title: \"title\", links: [\"a\"] });" } }
}'

Read full documentation

A skill is available in lightpanda-io/agent-skill.

Shell completion

lightpanda completion <bash | fish | zsh> prints a completion script for commands, flags and their values:

lightpanda completion fish > ~/.config/fish/completions/lightpanda.fish
lightpanda completion bash > ~/.local/share/bash-completion/completions/lightpanda
lightpanda completion zsh > ~/.zfunc/_lightpanda  # with fpath=(~/.zfunc $fpath) before compinit

Telemetry

By default, Lightpanda collects and sends usage telemetry. This can be disabled by setting an environment variable LIGHTPANDA_DISABLE_TELEMETRY=true. You can read Lightpanda's privacy policy at: https://lightpanda.io/privacy-policy.

Core dumps

Set LIGHTPANDA_DISABLE_CORE_DUMP (to any value) to suppress crash core dumps by zeroing the soft RLIMIT_CORE at startup.

Status

Here are the key features we have implemented. For full details, see our Web Platform Tests results.

  • CORS
  • HTTP loader (Libcurl)
  • HTML parser (html5ever)
  • DOM tree
  • Javascript support (v8)
  • DOM APIs
  • Ajax
    • XHR API
    • Fetch API
  • DOM and Markdown dump
  • CDP/websockets server
  • Click
  • Input form
  • Cookies
  • Custom HTTP headers
  • Proxy support
  • Network interception
  • Respect robots.txt with option --obey-robots
  • CDP and Webdriver Bidi
  • Adblocker

Build from sources

Prerequisites

Lightpanda is written with Zig 0.17.0. You have to install it with the right version in order to build the project.

Lightpanda also depends on v8, Libcurl and html5ever.

For Debian/Ubuntu based Linux:

sudo apt install xz-utils ca-certificates \
    pkg-config libglib2.0-dev \
    clang make curl git

pkg-config and libglib2.0-dev are only needed to build V8 from source (see below). You also need to install Rust.

For systems with Nix, you can use the devShell.

nix develop

For MacOS, you need cmake and Rust.

brew install cmake

Build and run

Run make download-v8 once first to fetch the prebuilt V8 archive; both make and zig build pick it up. Without it, or on a platform with no published archive (the download then fails), the build compiles V8 from source, which takes several minutes. See CONTRIBUTING.md for details.

Then build the entire browser with make build or make build-dev for debug env.

But you can directly use the zig command: zig build run.

Embed v8 snapshot

Lightpanda uses a v8 snapshot. make build builds and embeds it. With a plain zig build, it is created on startup instead, unless you embed it by using the following commands:

Generate the snapshot.

zig build snapshot_creator -- src/snapshot.bin

Build using the snapshot binary.

zig build -Dsnapshot_path=../../snapshot.bin

See #1279 for more details.

Test

Unit Tests

You can test Lightpanda by running make test.

make test                                       # Run all tests
make test F="server"                            # Filter by substring
TEST_FILTER="WebApi: #selector_all" make test   # Filter main + subtest (separator: #)
TEST_VERBOSE=true make test
TEST_FAIL_FIRST=true make test
METRICS=true make test                          # Capture allocation/duration metrics as JSON
TEST_JOBS=1 make test                           # Run in one process (default: up to 4, or 1 when filtered)

End to end tests

To run end to end tests, you need to clone the demo repository into ../demo dir.

You have to install the demo's node requirements

You also need to install Go > v1.24.

make end2end

Web Platform Tests

Lightpanda is tested against the standardized Web Platform Tests.

We use a fork including a custom testharnessreport.js. Results are published daily.

For reference, you can execute a WPT test case with your browser via wpt.live.

Configure WPT HTTP server

To run the test, you must clone the repository, configure the custom hosts and generate the MANIFEST.json file.

Clone the repository with the fork branch.

git clone -b fork --depth=1 [email protected]:lightpanda-io/wpt.git

Enter into the wpt/ dir.

Install custom domains in your /etc/hosts

./wpt make-hosts-file | sudo tee -a /etc/hosts

Generate MANIFEST.json

./wpt manifest

Use the WPT's setup guide for details.

Run WPT test suite

An external Go runner is provided by github.com/lightpanda-io/demo/ repository, located into wptrunner/ dir. You need to clone the project first.

First start the WPT's HTTP server from your wpt/ clone dir.

./wpt serve

Run a Lightpanda browser

zig build -Dwpt_extensions run -- serve \
    --ws-max-concurrent 64 \
    --insecure-disable-tls-host-verification \
    --load-resources iframe \
    --load-resources image \
    --load-resources worker \
    --load-resources stylesheet

Then you can start the wptrunner from the demo's clone dir:

cd wptrunner && go run .

Or one specific test:

cd wptrunner && go run . Node-childNodes.html

wptrunner command accepts --summary and --json options modifying output. Also --concurrency define the concurrency limit.

To check a single test case without the runner, fetch --dump wpt prints its results as JSON: the harness status, a pass/fail summary and the cases that did not pass. It relies on the fork's testharnessreport.js.

zig build -Dwpt_extensions run -- fetch \
    --insecure-disable-tls-host-verification \
    --load-resources worker \
    --load-resources iframe \
    --dump wpt \
    --wait-script "window.report && report.complete" \
    "http://web-platform.test:8000/dom/nodes/Node-childNodes.html"

⚠️ Running the whole test suite will take a long time. In this case, it's useful to build in releaseFast mode to make tests faster.

zig build -Dwpt_extensions -Doptimize=fast run -- serve ...

Contributing

See CONTRIBUTING.md for guidelines. You must sign our CLA during the pull request process.

Why Lightpanda?

Javascript execution is mandatory for the modern web

Simple HTTP requests used to be enough for web automation. That's no longer the case. Javascript now drives most of the web:

  • Ajax, Single Page Apps, infinite loading, instant search
  • JS frameworks: React, Vue, Angular, and others

Chrome is not the right tool

Running a full desktop browser on a server works, but it does not scale well. Chrome at hundreds or thousands of instances is expensive:

  • Heavy on RAM and CPU
  • Hard to package, deploy, and maintain at scale
  • Many features are not necessary in headless made

Lightpanda is built for performance

Supporting Javascript with real performance meant building from scratch rather than forking Chromium:

  • Not based on Chromium, Blink, or WebKit
  • Written in Zig, a low-level language with explicit memory control
  • No graphical rendering engine
View on GitHub

Recent activity

commits and pull requests

Releases and announcements

28 total
  1. 1.0.41.0.4Nov 13, 20261.7K downloads

    ## Behavior changes - Requests to the Fetch "bad ports" (ssh, smtp, pop3, imap, …) are now refused for every request, not only WebSocket. - `window.postMessage` now honors `targetOrigin`. - A cross-site response can no longer set a `SameSite` cookie other than `None`. - Proxy and server credentials are tracked separately, so proxy credentials are no longer sent to the server after a redirect. - An `about:blank` (or src-less) iframe now gets its `contentWindow` and `contentDocument` even without `--load-resources iframe`. Its HTTP and WebSocket requests are blocked while iframe loading is off. - An HTTP status from 600 to 999 (e.g. LinkedIn's `999`) is now reported as-is instead of `0`. - Trusted `mousedown`, `mouseup`, `click` and `dblclick` now stop at the first disabled form control, as in Chrome. - Element clicks and hovers from tools now hit the element's center instead of `(0, 0)`. - `document.readyState` is now `interactive` when deferred scripts run. - `Network.setUserAgentOverride` now logs a warning when a restricted user agent is ignored. - The HTTP server parses requests more strictly and its routes are guarded against DNS rebinding. ## CDP - Several page

  2. 1.0.4-rc11.0.4-rc1Nov 11, 2026pre-release97 downloads
  3. 1.0.31.0.3Nov 5, 20268.4K downloads

    ## Behavior changes - `serve`: the `--http-max-concurrent` default now follows `--cdp-max-connections` (8× it, between 40 and 256). With the default 16 connections it is 128. - `fetch --dump markdown` now asks the server for markdown (`Accept: text/markdown,...`). A `text/markdown` response is dumped as-is. Not sent with `--dump-selector`, `--wait-selector` or `--wait-script`. - `Accessibility.getPartialAXTree` now honors `fetchRelatives`, as Chrome does: it returns the node and its relatives, no longer the whole subtree. Use `getFullAXTree` or `getChildAXNodes` for a subtree. - `DOM.querySelector` with no match now returns `nodeId: 0` instead of an error, as Chrome does. - Touch event handlers (`ontouchstart`, …) are removed from `document` and elements: Lightpanda doesn't emulate a touch device. - `navigator.sendBeacon` now checks its arguments. Beacons are still not sent unless `--load-resources beacon` is set. - The HTTP cache database is deleted and rebuilt when its schema version changes. - `waitForState` now reports a timeout instead of always answering that the page reached the state. - MCP over HTTP: a request on a session closed with `DELETE` now gets a 404 inste

  4. 1.0.21.0.2Oct 23, 202621.1K downloads

    ## Behavior changes - JS page errors now log under a new `page_error` scope at WARN (silence with `--log-filter`). - Each top-level page now has its own session history; a second page no longer shows up in the first page's back/forward. - `--block-private-networks` now blocks more non-routable ranges (CGNAT, benchmarking, multicast, reserved, NAT64). - `no-cors` fetches with a non-safelisted method are now rejected. - An unreadable `--http-cache-dir` database is now discarded instead of exiting. - Console values written to the log are now escaped and capped. ## New Web APIs - Web Crypto: Ed25519, X25519, ECDSA, RSA-PSS, RSASSA-PKCS1-v1_5, `wrapKey`/`unwrapKey` + AES-KW; EC and RSA-OAEP import/export - WebCodecs, `OfflineAudioContext`, WebVTT improvements - XML document parsing - `setRangeText()` on `<input>` and `<textarea>`; `textarea.textLength` - `HTMLProgressElement` `value`/`max`/`position`; `HTMLOptionElement.index`; missing table APIs - `document.hasFocus()`; `window.outerWidth/outerHeight/screenX/screenY/screenLeft/screenTop` - `:nth-child(An+B of S)` and `:nth-last-child(An+B of S)` - `PermissionStatus` is now an `EventTarget`; `DOMException` is now struct

  5. 1.0.11.0.1Oct 15, 202614.6K downloads

    ## Behavior changes - `setImmediate` and `clearImmediate` were removed (deprecated, not part of the web platform). - MCP and agent modes now load external stylesheets by default. - Max HTTP redirects raised from 10 to 20, matching the Fetch spec. - Unsupported protocols are no longer navigated to; `javascript:` URLs are run instead of navigated to. ## New Web APIs - Web Locks - Compression Streams API - RSA-OAEP in Web Crypto (`generateKey`, `importKey`, `encrypt`, `decrypt`) - Custom elements: `ElementInternals` and form-associated callbacks - `Request.body` and `Request.textStream` - `HTMLFormElement.reset`, form numeric and named index, `form.field` - `HTMLTableElement.rows`, `HTMLSelectElement.remove(index)`, `select.length` setter - `textarea.type`, `fieldset.type`, `output.type`; `HTMLMeterElement` accessors - `GlobalEventHandlers` attributes on `Window` and `Document`; document named index - Performance secondary buffer; `performance.timeOrigin` relative to the Unix epoch - `Console` and `CSS` are now proper namespaces; more missing namespace methods ## Forms / input - Implicit submit on Enter; improved form submission; GET submissions replace the actio

Code frequency

additions and deletions
+291.7K-291.7KWeek of 2025-09-28: +10,475 linesWeek of 2025-09-28: -11,089 linesWeek of 2025-10-05: +475 linesWeek of 2025-10-05: -252 linesWeek of 2025-10-12: +27,700 linesWeek of 2025-10-12: -34,599 linesWeek of 2025-10-19: +0 linesWeek of 2025-10-19: -0 linesWeek of 2025-10-26: +6,739 linesWeek of 2025-10-26: -5,643 linesWeek of 2025-11-02: +250 linesWeek of 2025-11-02: -6 linesWeek of 2025-11-09: +10,861 linesWeek of 2025-11-09: -1,005 linesWeek of 2025-11-16: +7,889 linesWeek of 2025-11-16: -1,033 linesWeek of 2025-11-23: +8,986 linesWeek of 2025-11-23: -3,803 linesWeek of 2025-11-30: +6,441 linesWeek of 2025-11-30: -778 linesWeek of 2025-12-07: +11,402 linesWeek of 2025-12-07: -4,712 linesWeek of 2025-12-14: +6,607 linesWeek of 2025-12-14: -1,146 linesWeek of 2025-12-21: +3,838 linesWeek of 2025-12-21: -1,883 linesWeek of 2025-12-28: +6,265 linesWeek of 2025-12-28: -3,158 linesWeek of 2026-01-04: +6,725 linesWeek of 2026-01-04: -2,659 linesWeek of 2026-01-11: +6,849 linesWeek of 2026-01-11: -3,932 linesWeek of 2026-01-18: +3,792 linesWeek of 2026-01-18: -1,263 linesWeek of 2026-01-25: +5,129 linesWeek of 2026-01-25: -2,278 linesWeek of 2026-02-01: +3,173 linesWeek of 2026-02-01: -1,944 linesWeek of 2026-02-08: +4,183 linesWeek of 2026-02-08: -1,445 linesWeek of 2026-02-15: +9,133 linesWeek of 2026-02-15: -2,769 linesWeek of 2026-02-22: +9,830 linesWeek of 2026-02-22: -6,666 linesWeek of 2026-03-01: +10,643 linesWeek of 2026-03-01: -7,518 linesWeek of 2026-03-08: +9,221 linesWeek of 2026-03-08: -2,608 linesWeek of 2026-03-15: +8,901 linesWeek of 2026-03-15: -4,399 linesWeek of 2026-03-22: +6,790 linesWeek of 2026-03-22: -4,407 linesWeek of 2026-03-29: +290,936 linesWeek of 2026-03-29: -3,844 linesWeek of 2026-04-05: +9,727 linesWeek of 2026-04-05: -6,234 linesWeek of 2026-04-12: +6,355 linesWeek of 2026-04-12: -3,316 linesWeek of 2026-04-19: +14,522 linesWeek of 2026-04-19: -291,680 linesWeek of 2026-04-26: +18,771 linesWeek of 2026-04-26: -3,777 linesWeek of 2026-05-03: +9,809 linesWeek of 2026-05-03: -5,500 linesWeek of 2026-05-10: +16,977 linesWeek of 2026-05-10: -9,491 linesWeek of 2026-05-17: +12,414 linesWeek of 2026-05-17: -10,019 linesWeek of 2026-05-24: +9,766 linesWeek of 2026-05-24: -9,241 linesWeek of 2026-05-31: +14,220 linesWeek of 2026-05-31: -6,507 linesWeek of 2026-06-07: +12,471 linesWeek of 2026-06-07: -5,258 linesWeek of 2026-06-14: +9,023 linesWeek of 2026-06-14: -7,148 linesWeek of 2026-06-21: +4,375 linesWeek of 2026-06-21: -1,816 linesWeek of 2026-06-28: +13,559 linesWeek of 2026-06-28: -4,441 linesWeek of 2026-07-05: +13,865 linesWeek of 2026-07-05: -6,911 linesWeek of 2026-07-12: +14,525 linesWeek of 2026-07-12: -4,222 linesWeek of 2026-07-19: +15,663 linesWeek of 2026-07-19: -3,826 linesWeek of 2026-07-26: +10,711 linesWeek of 2026-07-26: -5,740 linesWeek of 2026-08-02: +7,301 linesWeek of 2026-08-02: -2,975 linesWeek of 2026-08-09: +28,328 linesWeek of 2026-08-09: -22,769 linesWeek of 2026-08-16: +22,923 linesWeek of 2026-08-16: -8,983 linesWeek of 2026-08-23: +34,241 linesWeek of 2026-08-23: -3,214 linesWeek of 2026-08-30: +17,012 linesWeek of 2026-08-30: -4,200 linesWeek of 2026-09-06: +25,357 linesWeek of 2026-09-06: -16,935 linesWeek of 2026-09-13: +32,532 linesWeek of 2026-09-13: -21,789 linesWeek of 2026-09-20: +39,103 linesWeek of 2026-09-20: -33,360 linesSep 28, 2025Sep 20, 2026
+896.8K lines added, -614.2K removed over the last year.

Commits per week

last 52 weeks
4100Week of 2025-11-23: 61 commitsWeek of 2025-11-30: 57 commitsWeek of 2025-12-07: 116 commitsWeek of 2025-12-14: 42 commitsWeek of 2025-12-21: 86 commitsWeek of 2025-12-28: 49 commitsWeek of 2026-01-04: 127 commitsWeek of 2026-01-11: 99 commitsWeek of 2026-01-18: 84 commitsWeek of 2026-01-25: 88 commitsWeek of 2026-02-01: 104 commitsWeek of 2026-02-08: 135 commitsWeek of 2026-02-15: 231 commitsWeek of 2026-02-22: 169 commitsWeek of 2026-03-01: 172 commitsWeek of 2026-03-08: 235 commitsWeek of 2026-03-15: 237 commitsWeek of 2026-03-22: 167 commitsWeek of 2026-03-29: 150 commitsWeek of 2026-04-05: 207 commitsWeek of 2026-04-12: 142 commitsWeek of 2026-04-19: 148 commitsWeek of 2026-04-26: 198 commitsWeek of 2026-05-03: 176 commitsWeek of 2026-05-10: 284 commitsWeek of 2026-05-17: 173 commitsWeek of 2026-05-24: 169 commitsWeek of 2026-05-31: 254 commitsWeek of 2026-06-07: 176 commitsWeek of 2026-06-14: 153 commitsWeek of 2026-06-21: 103 commitsWeek of 2026-06-28: 162 commitsWeek of 2026-07-05: 205 commitsWeek of 2026-07-12: 277 commitsWeek of 2026-07-19: 152 commitsWeek of 2026-07-26: 121 commitsWeek of 2026-08-02: 107 commitsWeek of 2026-08-09: 111 commitsWeek of 2026-08-16: 136 commitsWeek of 2026-08-23: 220 commitsWeek of 2026-08-30: 160 commitsWeek of 2026-09-06: 176 commitsWeek of 2026-09-13: 236 commitsWeek of 2026-09-20: 206 commitsWeek of 2026-09-27: 211 commitsWeek of 2026-10-04: 375 commitsWeek of 2026-10-11: 303 commitsWeek of 2026-10-18: 380 commitsWeek of 2026-10-25: 341 commitsWeek of 2026-11-01: 410 commitsWeek of 2026-11-08: 254 commitsWeek of 2026-11-15: 7 commitsNov 23, 2025Nov 15, 2026
9.1K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 16 commitsSun 1:00 — 12 commitsSun 2:00 — 3 commitsSun 3:00 — 1 commitsSun 4:00 — 14 commitsSun 5:00 — 4 commitsSun 6:00 — 2 commitsSun 7:00 — 9 commitsSun 8:00 — 19 commitsSun 9:00 — 16 commitsSun 10:00 — 20 commitsSun 11:00 — 23 commitsSun 12:00 — 18 commitsSun 13:00 — 14 commitsSun 14:00 — 17 commitsSun 15:00 — 25 commitsSun 16:00 — 24 commitsSun 17:00 — 18 commitsSun 18:00 — 16 commitsSun 19:00 — 15 commitsSun 20:00 — 14 commitsSun 21:00 — 19 commitsSun 22:00 — 19 commitsSun 23:00 — 18 commitsMon 0:00 — 8 commitsMon 1:00 — 10 commitsMon 2:00 — 3 commitsMon 3:00 — 3 commitsMon 4:00 — 2 commitsMon 5:00 — 16 commitsMon 6:00 — 23 commitsMon 7:00 — 79 commitsMon 8:00 — 64 commitsMon 9:00 — 79 commitsMon 10:00 — 84 commitsMon 11:00 — 96 commitsMon 12:00 — 121 commitsMon 13:00 — 81 commitsMon 14:00 — 86 commitsMon 15:00 — 133 commitsMon 16:00 — 125 commitsMon 17:00 — 139 commitsMon 18:00 — 112 commitsMon 19:00 — 57 commitsMon 20:00 — 37 commitsMon 21:00 — 55 commitsMon 22:00 — 46 commitsMon 23:00 — 28 commitsTue 0:00 — 24 commitsTue 1:00 — 23 commitsTue 2:00 — 16 commitsTue 3:00 — 3 commitsTue 4:00 — 3 commitsTue 5:00 — 2 commitsTue 6:00 — 16 commitsTue 7:00 — 32 commitsTue 8:00 — 63 commitsTue 9:00 — 86 commitsTue 10:00 — 98 commitsTue 11:00 — 144 commitsTue 12:00 — 142 commitsTue 13:00 — 92 commitsTue 14:00 — 109 commitsTue 15:00 — 153 commitsTue 16:00 — 136 commitsTue 17:00 — 128 commitsTue 18:00 — 92 commitsTue 19:00 — 69 commitsTue 20:00 — 64 commitsTue 21:00 — 50 commitsTue 22:00 — 45 commitsTue 23:00 — 29 commitsWed 0:00 — 25 commitsWed 1:00 — 25 commitsWed 2:00 — 11 commitsWed 3:00 — 5 commitsWed 4:00 — 3 commitsWed 5:00 — 8 commitsWed 6:00 — 24 commitsWed 7:00 — 54 commitsWed 8:00 — 85 commitsWed 9:00 — 105 commitsWed 10:00 — 107 commitsWed 11:00 — 123 commitsWed 12:00 — 120 commitsWed 13:00 — 82 commitsWed 14:00 — 109 commitsWed 15:00 — 154 commitsWed 16:00 — 157 commitsWed 17:00 — 129 commitsWed 18:00 — 103 commitsWed 19:00 — 50 commitsWed 20:00 — 61 commitsWed 21:00 — 45 commitsWed 22:00 — 32 commitsWed 23:00 — 24 commitsThu 0:00 — 13 commitsThu 1:00 — 16 commitsThu 2:00 — 2 commitsThu 3:00 — 4 commitsThu 4:00 — 3 commitsThu 5:00 — 0 commitsThu 6:00 — 7 commitsThu 7:00 — 41 commitsThu 8:00 — 49 commitsThu 9:00 — 112 commitsThu 10:00 — 95 commitsThu 11:00 — 113 commitsThu 12:00 — 116 commitsThu 13:00 — 74 commitsThu 14:00 — 130 commitsThu 15:00 — 128 commitsThu 16:00 — 151 commitsThu 17:00 — 140 commitsThu 18:00 — 85 commitsThu 19:00 — 64 commitsThu 20:00 — 71 commitsThu 21:00 — 31 commitsThu 22:00 — 57 commitsThu 23:00 — 32 commitsFri 0:00 — 17 commitsFri 1:00 — 12 commitsFri 2:00 — 13 commitsFri 3:00 — 6 commitsFri 4:00 — 1 commitsFri 5:00 — 1 commitsFri 6:00 — 21 commitsFri 7:00 — 51 commitsFri 8:00 — 60 commitsFri 9:00 — 78 commitsFri 10:00 — 90 commitsFri 11:00 — 120 commitsFri 12:00 — 100 commitsFri 13:00 — 73 commitsFri 14:00 — 82 commitsFri 15:00 — 117 commitsFri 16:00 — 118 commitsFri 17:00 — 113 commitsFri 18:00 — 81 commitsFri 19:00 — 59 commitsFri 20:00 — 43 commitsFri 21:00 — 28 commitsFri 22:00 — 27 commitsFri 23:00 — 23 commitsSat 0:00 — 11 commitsSat 1:00 — 12 commitsSat 2:00 — 10 commitsSat 3:00 — 3 commitsSat 4:00 — 4 commitsSat 5:00 — 0 commitsSat 6:00 — 3 commitsSat 7:00 — 30 commitsSat 8:00 — 26 commitsSat 9:00 — 27 commitsSat 10:00 — 36 commitsSat 11:00 — 34 commitsSat 12:00 — 33 commitsSat 13:00 — 26 commitsSat 14:00 — 46 commitsSat 15:00 — 26 commitsSat 16:00 — 25 commitsSat 17:00 — 27 commitsSat 18:00 — 16 commitsSat 19:00 — 31 commitsSat 20:00 — 34 commitsSat 21:00 — 24 commitsSat 22:00 — 24 commitsSat 23:00 — 33 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Nov 2, 2026daily#1+827
Nov 1, 2026daily#1+827
Oct 31, 2026daily#4+929
Oct 30, 2026daily#11+559
Sep 8, 2026daily#9+116
Sep 7, 2026daily#9+116
Mar 21, 2026daily#23+176
Mar 16, 2026daily#12+277
Mar 15, 2026daily#10+340
Mar 14, 2026daily#7+500
Mar 13, 2026daily#12+291
Mar 12, 2026daily#22+146
  • vercel/next.js

    The React Framework

    143.6K stars · JavaScript

  • browser-use/browser-use

    Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

    121.6K stars · Python

  • D4Vinci/Scrapling

    🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev

    104.7K stars · Python

  • heygen-com/hyperframes

    AI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.

    87.5K stars · TypeScript

  • LadybirdBrowser/ladybird

    Truly independent web browser

    67.2K stars · Rust

  • ghostty-org/ghostty

    👻 Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.

    64.2K stars · Zig