Un browser AI open source, finalmente disponibile

Cloudflare ha pubblicato su GitHub il codice di Kitesurf, il browser stateless progettato per gli agenti di intelligenza artificiale. Il progetto, rilasciato con licenza Apache 2.0, era stato promesso al lancio di agosto e ribadito a settembre, quando erano stati aggiunti il supporto a WebMCP, nuove API e una migliore compatibilità. Ora il sorgente è consultabile, eseguibile in locale, modificabile e distribuibile come istanza sul proprio account Cloudflare.

Kitesurf analizza l'HTML, applica i CSS, esegue il JavaScript delle pagine e genera screenshot senza ricorrere a un container browser tradizionale. Supporta il Chrome DevTools Protocol (CDP), consentendo l’interazione con client come Puppeteer. L’obiettivo è fornire agli agenti AI un browser leggero, capace di caricare siti, eseguire script e interagire con le pagine usando meno CPU e memoria rispetto a Chromium, scalando su richiesta nella rete globale di Workers.

Architettura e componenti principali

Il motore si basa su una serie di pacchetti open source scritti in Rust e compilati in WebAssembly. I componenti chiave includono:

    • Blitz: parsing HTML, gestione del DOM, layout e painting.
    • Stylo: parsing dei CSS, calcolo della cascata e degli stili.
    • Boa: motore JavaScript, utilizzato come fallback quando non è possibile eseguirlo nei Dynamic Workers.
    • Le librerie Linebender (Parley, Vello, Kurbo, Peniko) per layout del testo e grafica 2D.
    • Krilla: generazione dell'output PDF.

Ciascuno di questi progetti mantiene la propria licenza, indicata nel file NOTICE del repository.

Struttura dell’architettura

L’architettura di Kitesurf è suddivisa in tre componenti:

    • Engine: gestisce le sessioni e le connessioni dei client.
    • PageScript: esegue la pagina e il relativo JavaScript.
    • PageRenderer: disegna il risultato finale.

Engine, core Rust, DOM shim, renderer e la CLI di Kitesurf risiedono in cartelle separate sotto la directory packages. La CLI è un client da terminale che utilizza i kitty graphics dove supportati e il solo testo altrove; si installa con Homebrew.

Esecuzione locale e deployment su Cloudflare Workers

Per compilare e testare Kitesurf in locale sono necessari:

    • Bazelisk (che scarica automaticamente le toolchain Rust, wasm-bindgen e binaryen).
    • Node.js 22 o successivo.
    • pnpm 9.15.4.

Dopo aver clonato il repository, il comando pnpm install --frozen-lockfile prepara le dipendenze. Successivamente, pnpm run dev compila i moduli WebAssembly e i bundle con Bazel, avviando wrangler dev su http://127.0.0.1:8787. La prima compilazione richiede tempo perché costruisce il core Rust e le sue dipendenze; le successive sfruttano la cache.

Da quell’indirizzo si apre una pagina in Chrome DevTools, mentre Puppeteer si collega all’endpoint WebSocket ws://127.0.0.1:8787/devtools/browser. Cloudflare suggerisce anche di puntare l’harness di un agente sulla porta CDP locale per test più integrati.

Deploy su account personale

Per portare il motore sul proprio account Cloudflare è necessario un piano Workers Paid, poiché Kitesurf utilizza i Dynamic Workers per creare un Worker isolato per ogni pagina e per il renderer. Questa funzionalità è disponibile solo in quel piano.

Il README avverte di non esporre il motore senza autenticazione, poiché non dispone di una propria protezione. Chi conosce l’URL può aprire DevTools, navigare nell’istanza, collegare client CDP e consumare risorse CPU e Dynamic Workers a carico del titolare. L’indirizzo predefinito è pubblico (kitesurf.<sottodominio>.workers.dev) e prevedibile.

La protezione consigliata è Cloudflare Access (Zero Trust), da attivare subito dopo il deploy o, meglio, per tutti i Worker dell’account. Un client CDP come Puppeteer passa attraverso Access con un service token, inviato negli header CF-Access-Client-Id e CF-Access-Client-Secret.

Contributi, sviluppo e risorse per provare Kitesurf

Kitesurf è ancora in fase sperimentale. Il README lo definisce un motore in evoluzione, con Cloudflare che lavora su compatibilità (misurata con i Web Platform Tests), affidabilità ed efficienza.

Per contribuire, è possibile aprire una issue con una riproduzione minima del problema o una proposta; il maintainer fornirà il via libera prima di inviare una pull request. I contributi non devono per forza includere codice: una piccola pagina che evidenzia un bug di rendering, un flusso di automazione che fallisce o la correzione di una parte della documentazione sono altrettanto validi.

Chi vuole provare Kitesurf senza installare nulla può utilizzare il playground disponibile su kitesurf.dev. Qui sono presenti pagine di esempio da aprire in DevTools, da Doom compilato in WebAssembly alla lavagna tldraw, oltre alla configurazione per collegare chrome-devtools-mcp senza necessità di un account.