Kitesurf
Kitesurf is an experimental browser engine on Cloudflare Workers. It fetches pages, runs JavaScript, lays them out and paints them, and speaks the Chrome DevTools Protocol without a Chromium process or container.
Visit cloudflare/kitesurfOverview
Kitesurf is an experimental browser engine that runs on top of Cloudflare Workers. It fetches a page, runs its JavaScript, lays it out, and paints it, and it speaks the Chrome DevTools Protocol so existing tools can drive it. There is no Chromium process or container behind it, and the project describes a stateless web browser built for agents.
Key Features
- Runs as an experimental browser engine on Cloudflare Workers with no Chromium process or container.
- Fetches pages, executes page JavaScript, lays out content, and paints rendered output.
- Speaks the Chrome DevTools Protocol, so CDP clients such as Puppeteer can drive it.
- Provides a stateless browser built for agents, with DevTools inspection of the DOM, console, and network while rendering.
- Produces screenshots, PDFs, and rendered HTML from real pages.
- Includes a terminal client that can render with kitty graphics where supported or plain text elsewhere.
Use Cases
- Inspecting page rendering in Chrome DevTools, including the DOM, console, and network.
- Driving page navigation and screenshots through CDP clients such as Puppeteer.
- Generating screenshots, PDFs, or rendered HTML from real pages.
- Browsing the web from a terminal with the Kitesurf terminal client.
Getting Started
- Clone the repository and install dependencies with pnpm install --frozen-lockfile.
- Build and start the local engine with pnpm run dev; the local engine listens on port 8787 and the health endpoint confirms it is running.
- Connect a CDP client such as Puppeteer to the local browser WebSocket endpoint at port 8787.
- Install the terminal client with brew install cloudflare/cloudflare/kitesurf and start it with kitesurf -m ansi.
Deployment & Requirements
- A Cloudflare Workers Paid plan is required to run Kitesurf on Cloudflare.
- Local development uses wrangler dev; deployment builds with Bazel and uploads with Wrangler using wrangler login or CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN.
- Deployments need an authentication layer such as Cloudflare Access because the engine has no authentication of its own.
- Building requires Bazelisk installed as bazel, Node.js 22 or newer, pnpm 9.15.4, and GNU tar on macOS; Rust via rustup is only needed to edit vendored crate patches.
Before You Adopt
- License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
- The project labels Kitesurf as experimental.