AI/TLDR

CloakBrowser

Stealth Chromium that drops into Playwright and Puppeteer code unchanged

Computer & Browser UseOpen core
Language
Python
License
MIT
$docker run --rm cloakhq/cloakbrowser cloaktest

Overview

CloakBrowser is a Chromium build whose fingerprints are modified at the C++ source level rather than patched at runtime. The project's argument is that JS injection and launch-flag tricks are themselves detectable, so it ships 87 source-level patches covering canvas, WebGL, audio, fonts, GPU, screen, WebRTC, network timing, automation signals and CDP input behaviour — and antibot systems score the result as an ordinary browser.

It is designed as a drop-in replacement: the Python and JavaScript packages expose the same API surface as Playwright (and Puppeteer via a separate entry point), so switching an existing automation script means changing the import and nothing else. A `humanize=True` flag adds human-like mouse curves, keyboard timing and scroll patterns for behavioural detection, and `geoip=True` matches timezone and locale to a proxy's IP.

The core is MIT-licensed and the stealth Chromium binary (~200MB) is downloaded and cached on first run; a Pro tier gates a separate binary with stronger scores. The project publishes its results against 30+ detection sites, including Cloudflare Turnstile, FingerprintJS and BrowserScan. Use it on targets you are authorized to automate — the same tool that makes an agent's browsing session work is subject to each site's terms.

What it does

  • 87 source-level C++ patches across canvas, WebGL, audio, fonts, GPU, screen, WebRTC, network timing and automation signals
  • Drop-in Playwright and Puppeteer replacement — same API, just change the import
  • `humanize=True` for human-like mouse curves, keyboard timing and scroll patterns
  • `geoip=True` matches timezone and locale to the proxy IP; proxy and headed/headless are launch options
  • Clients for Python (pip), JavaScript/Node (npm) and .NET (NuGet), plus a Docker image
  • Binary auto-downloads and caches on first run — no manual Chromium management

Getting started

There is a zero-install smoke test via Docker; after that, install the client for your language and swap the import in existing automation code.

Try it without installing

The Docker image ships a built-in self test.

bashbash
docker run --rm cloakhq/cloakbrowser cloaktest

Install the client

The stealth Chromium binary (~200MB) downloads automatically on first run and is cached locally.

bashbash
pip install cloakbrowser

# JavaScript, with Playwright
npm install cloakbrowser playwright-core

# or with Puppeteer
npm install cloakbrowser puppeteer-core

Launch a page in Python

The API mirrors Playwright's, so existing scripts port over unchanged.

pythonpython
from cloakbrowser import launch

browser = launch()
page = browser.new_page()
page.goto("https://example.com")
browser.close()

Or in JavaScript

Use `cloakbrowser/puppeteer` instead of `cloakbrowser` for the Puppeteer surface.

jsjs
import { launch } from 'cloakbrowser';

const browser = await launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Harden the session for protected sites

The README's recommended combination for anti-bot targets: a residential proxy, geoip matching, headed mode and humanized input.

pythonpython
browser = launch(
    proxy="http://user:pass@residential-proxy:port",
    geoip=True,
    headless=False,
    humanize=True,
)

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Give a browser agent a session that does not get blocked before it reaches the page it needs
  • Port an existing Playwright or Puppeteer scraper onto a less detectable browser without rewriting it
  • Run authorized QA and monitoring against your own properties behind bot-protection layers
  • Scale headless collection across many sessions with per-session proxy, locale and fingerprint control

How CloakBrowser compares

CloakBrowser alongside other open-source computer & browser use tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
Browser Use★ 115kA Python library that lets agents control a real browser to read pages and complete tasks online from natural-language instructions.
Open Interpreter★ 68.4kA lightweight coding agent that runs code on your own computer to carry out tasks from natural-language requests.
Chrome DevTools MCP★ 52.2kThe Chrome team's MCP server that lets a coding agent control and inspect a live Chrome browser — performance traces, network requests, console messages and Puppeteer-backed automation.
UI-TARS Desktop★ 39kByteDance's multimodal agent stack and desktop app that controls a computer's graphical interface using vision-language models.
AIHawk★ 31.6kBrowser agent on a stealth Firefox that takes plain-language tasks and clicks, types and reads real pages - usable as an MCP server from Claude Code, Codex or Gemini CLI, or via its own web UI.
CloakBrowser★ 31.5kStealth Chromium that drops into Playwright and Puppeteer code unchanged
OpenCLI★ 29.4kTurns websites into deterministic CLI commands and lets agents drive your already-logged-in Chrome through a browser bridge extension, with adapters for sites and local binaries.
Page Agent★ 29.1kAlibaba's in-page GUI agent: a JavaScript library you drop into a web page so users can drive its interface in natural language, working through text-based DOM manipulation rather than screenshots.