# kitesurf: Run a Browser Engine on Cloudflare Workers

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/cloudflare-kitesurf
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/cloudflare/kitesurf
OSRepos URL: https://osrepos.com/repo/cloudflare-kitesurf

## Summary

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.

## Topics

- typescript
- rust
- browser-automation
- developer-tools
- browser-engine
- chrome-devtools-protocol
- cloudflare-workers

## Repository Information

Last analyzed by OSRepos: Sun Nov 15 2026 14:16:28 GMT+0000 (Western European Standard Time)
Detail views: 5
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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.

## Our Take

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.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-11-13 (2 days ago) |
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 0 |
| Contributors | 4 (top contributor: 51% of commits) |
| Issues closed, last 90 days | 2 |
| Pull requests merged, last 90 days | 62 (typically merged in 0 days) |
| Project age | 46 days |

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

## Project Facts

- Language: TypeScript
- License: Apache-2.0
- Stars: 1.5k
- Forks: 72
- Topics: agents, browser-automation
- Website: https://kitesurf.dev/
- Archived: no

## 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

## Getting Started

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

```bash
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](https://github.com/cloudflare/kitesurf#readme) for requirements, CDP client setup, testing, and deployment instructions.

## License in Plain Words

**Apache-2.0** (permissive).

- 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.

## Alternatives

- [obscura](https://osrepos.com/repo/h4ckf0r0day-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](https://osrepos.com/repo/ladybirdbrowser-ladybird): Ladybird is an independent browser project for developer use, rather than a browser engine exposed through CDP for Cloudflare Workers.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **kitesurf** | TypeScript | Apache-2.0 | 1.5k | New |
| [obscura](https://osrepos.com/repo/h4ckf0r0day-obscura) | Rust | Apache-2.0 | 30k | Active |
| [ladybird](https://osrepos.com/repo/ladybirdbrowser-ladybird) | C++ | BSD-2-Clause | 66.5k | Active |

## 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.