@@ -18,7 +18,7 @@ Lightpanda is the open-source browser made for headless usage:
1818
1919- Javascript execution
2020- Support of Web APIs (partial, WIP)
21- - Compatible with Playwright[ ^ 1 ] , Puppeteer through CDP (WIP)
21+ - Compatible with Playwright[ ^ 1 ] , Puppeteer, chromedp through CDP
2222
2323Fast web automation for AI agents, LLM training, scraping and testing:
2424
@@ -41,7 +41,8 @@ Due to the nature of Playwright, a script that works with the current version of
4141
4242## Quick start
4343
44- ### Install from the nightly builds
44+ ### Install
45+ ** Install from the nightly builds**
4546
4647You can download the last binary from the [ nightly
4748builds] ( https://github.com/lightpanda-io/browser/releases/tag/nightly ) for
@@ -64,6 +65,16 @@ chmod a+x ./lightpanda
6465The Lightpanda browser is compatible to run on windows inside WSL. Follow the Linux instruction for installation from a WSL terminal.
6566It is recommended to install clients like Puppeteer on the Windows host.
6667
68+ ** Install from Docker**
69+ Lightpanda provides [ official Docker
70+ images] ( https://hub.docker.com/r/lightpanda/browser ) for both Linux amd64 and
71+ arm64 architectures.
72+ The following command fetches the Docker image and starts a new container exposing Lightpanda's CDP server on port ` 9222 ` .
73+ The ` --privileged ` option is required because the browser requires ` io_uring ` syscalls which are blocked by default by Docker.
74+ ``` sh copy
75+ $ docker run -d --name lightpanda -p 9222:9222 --privileged lightpanda/browser:nightly
76+ ```
77+
6778### Dump a URL
6879
6980``` console
@@ -124,21 +135,26 @@ By default, Lightpanda collects and sends usage telemetry. This can be disabled
124135
125136## Status
126137
127- Lightpanda is still a work in progress and is currently at a Beta stage.
128-
129- :warning : You should expect most websites to fail or crash.
138+ Lightpanda is in Beta and currently a work in progress. Stability and coverage are improving and many websites now work.
139+ You may still encounter errors or crashes. Please open an issue with specifics if so.
130140
131141Here are the key features we have implemented:
132142
133143- [x] HTTP loader
144+ - [x] HTTP headers
134145- [x] HTML parser and DOM tree (based on Netsurf libs)
135146- [x] Javascript support (v8)
136- - [x] Basic DOM APIs
147+ - [x] DOM APIs
137148- [x] Ajax
138149 - [x] XHR API
139- - [x] Fetch API
150+ - [x] Fetch API (polyfill)
140151- [x] DOM dump
141- - [x] Basic CDP/websockets server
152+ - [x] CDP/websockets server
153+ - [x] Click
154+ - [x] Input form
155+ - [x] Cookies
156+ - [ ] Proxy support
157+ - [ ] Network interception
142158
143159NOTE: There are hundreds of Web APIs. Developing a browser (even just for headless mode) is a huge task. Coverage will increase over time.
144160
0 commit comments