cloudflare

kitesurf: Run a Browser Engine on Cloudflare Workers

Kitesurf is an experimental browser engine that parses pages, runs JavaScript, and renders screenshots on Cloudflare Workers. Built on Blitz from DioxusLabs, Stylo from Servo, and Boa, it exposes the Chrome DevTools Protocol for tools such as Puppeteer.

Stars
1.5k
Forks
72
Last commit
2 days ago
Contributors
4
Releases, 12 months
0

Our take

Newless than six months old and changing fast

Health score

57/100

How it is scored
Activity
53
Community
45
Issues
53
Pull requests
75
  • Merges more pull requests than 78% of the projects we track

Kitesurf is an actively changing, very new experimental engine with a promising CDP interface, but its limited maturity and Cloudflare-specific operating requirements make it best suited to evaluation and targeted experiments.

Good fit if

  • You want to explore browser automation or page rendering on Cloudflare Workers and can use the Workers Paid plan.
  • Your tooling already speaks CDP, and you can validate the browser features your workload needs.
  • You are comfortable evaluating a fast-moving project with no releases in the past year and a small contributor group that is not dominated by one person.

Look elsewhere if

  • You need a complete Chrome implementation or rely on DevTools features Kitesurf does not yet support.
  • You need a mature, stable release track or broad browser compatibility for production workloads.
  • You cannot put authentication in front of a deployed engine or meet the Dynamic Workers plan requirement.
All health signals
Last commit2026-11-13 (2 days ago)
Commits, last 90 days100+
Releases, last 12 months0
Contributors4 (top contributor: 51% of commits)
Issues closed, last 90 days2
Pull requests merged, last 90 days62 (typically merged in 0 days)
Project age46 days

Checked on 2026-11-15 with the GitHub API.

Overview

Kitesurf is an experimental browser engine that runs on Cloudflare Workers. It parses HTML, applies CSS, runs page JavaScript, and renders screenshots without Chrome or a browser container. Its Rust foundation combines Blitz from DioxusLabs for DOM, layout, and painting, Stylo from Servo for CSS, and Boa for JavaScript execution.

It exposes the Chrome DevTools Protocol (CDP), so browser-automation clients such as Puppeteer can control pages. That makes it a way to experiment with browser workloads in Cloudflare's serverless environment, rather than a drop-in replacement for a full Chrome browser.

Key Features

  • Parses HTML, computes CSS styles, runs page JavaScript, and renders screenshots.
  • Provides a CDP endpoint for Puppeteer and other compatible clients.
  • Runs page and renderer workers using Cloudflare Dynamic Workers.
  • Includes a landing page for opening URLs and inspecting example pages in DevTools.
  • Can serve a bundled Chrome DevTools frontend from the engine's own origin.
  • Includes a terminal client and a local scene rasterizer alongside its Worker engine.

Use Cases

  • Browser-automation developers can test CDP-based workflows without launching Chrome, when the pages and browser features they need are supported.
  • Cloudflare Workers developers can explore page rendering and JavaScript execution using Dynamic Workers.
  • Teams can render screenshots of pages in a controlled Worker environment, provided they accept the engine's experimental browser compatibility.
  • Contributors interested in browser internals can work with its Rust layout, styling, JavaScript, and rendering components.

What you need

Detected in the repository

  • Node.js (from package.json)
  • Rust (from Cargo.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the pinned pnpm version and dependencies, then start the local engine:

npm install --global pnpm@9.15.4
git clone https://github.com/cloudflare/kitesurf.git
cd kitesurf
pnpm install --frozen-lockfile
pnpm run dev

The local engine listens on http://127.0.0.1:8787. See the README for requirements, CDP client setup, testing, and deployment instructions.

Alternatives

  • obscura: Obscura is a Rust headless browser for AI agents and scraping, built on V8 and CDP, rather than a browser engine designed to run on Cloudflare Workers.
  • ladybird: Ladybird is an independent browser project for developer use, rather than a browser engine exposed through CDP for Cloudflare Workers.
ProjectLanguageLicenseStarsStatus
kitesurfTypeScriptApache-2.01.5kNew
obscuraRustApache-2.030kActive
ladybirdC++BSD-2-Clause66.5kActive

Considerations

  • The project describes itself as experimental. It is changing quickly, is less than six months old, and has no recent release history, so expect evolving behavior rather than a stable browser platform.
  • The engine is not a full Chrome implementation, and the README notes that some Chrome DevTools features do not work yet.
  • Cloudflare deployment requires Dynamic Workers, which are part of the Workers Paid plan. The README also requires authentication in front of a deployed engine: without it, visitors can browse through the engine, connect CDP clients, and consume account resources.
  • A local build requires Bazelisk, Node.js, pnpm, and the Bazel-managed Rust toolchain and build dependencies. The initial build compiles the Rust core and can take a while.
  • Kitesurf is Apache-2.0 licensed. Its component dependencies retain their own licenses, so review the repository's notices and dependency terms when distributing it.

Found this useful?

Share it with someone who would like kitesurf.