explaingit

cloakhq/cloakbrowser

9,450PythonAudience · developerComplexity · 2/5Setup · easy

TLDR

CloakBrowser is a patched build of the Chromium browser that bypasses bot detection systems like Cloudflare and FingerprintJS, it is a drop-in replacement for Playwright and Puppeteer requiring only a two-line import change.

Mindmap

mindmap
  root((repo))
    What it does
      Bot detection bypass
      Drop-in replacement
      Source-level patches
    Detection bypassed
      Cloudflare Turnstile
      FingerprintJS
      30 of 30 tests passed
    Features
      Human mouse mode
      Profile manager
      Docker support
    Integration
      Python pip install
      npm install
      Two line swap
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Replace Playwright or Puppeteer in an existing web scraping project to bypass Cloudflare Turnstile and FingerprintJS with just two lines of import code changed.

USE CASE 2

Run browser automation for AI agent tasks without getting blocked by anti-bot services.

USE CASE 3

Set up multiple isolated browser profiles with different fingerprints and proxy settings using the bundled CloakBrowser Manager.

Tech stack

PythonJavaScriptChromiumPlaywrightPuppeteerDocker

Getting it running

Difficulty · easy Time to first run · 5min

Downloads a ~200MB patched Chromium binary on first run, no subscription required but proxy setup for IP rotation is your own responsibility.

In plain English

CloakBrowser is a modified version of the Chromium browser (the open-source base that Google Chrome is built on) designed to pass automated bot detection systems. It is aimed at developers who write scripts to control a browser automatically, such as for web scraping, testing, or AI agent tasks, and who keep getting blocked by services like Cloudflare. Most tools that try to disguise automated browsers work by injecting small pieces of JavaScript code or tweaking settings at startup. The README explains that bot detection services have learned to spot these surface-level tricks. CloakBrowser instead modifies Chromium at the C++ source code level, meaning the changes are compiled directly into the browser binary. The result is a browser that behaves like a real one because it technically is one, just built from a patched source. The README states it passed 30 out of 30 bot detection tests including Cloudflare Turnstile, FingerprintJS, and similar services. The project is a drop-in replacement for Playwright and Puppeteer, which are the two most common libraries developers use to automate browsers in Python and JavaScript. Switching requires changing just a couple of lines of import code, the rest of your existing automation code works unchanged. An optional flag called humanize=True adds human-like mouse movements, keyboard timing, and scroll patterns to make the browser behavior harder to distinguish from a real person. Installation is through pip (for Python) or npm (for JavaScript). The first time you run it, the patched Chromium binary downloads automatically, about 200MB. A Docker image is also available. There is no subscription or usage limit, the project is free and open source. The repository also mentions a companion tool called CloakBrowser Manager, which is a self-hosted browser profile manager similar to paid commercial products like Multilogin or GoLogin. It lets you create multiple browser profiles with different fingerprints and proxy settings, accessible via a web interface running locally. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me exactly which two import lines to change to swap CloakBrowser into an existing Python Playwright scraping script.
Prompt 2
How do I enable the humanize=True flag in CloakBrowser to add realistic mouse movements and keyboard timing to my automation?
Prompt 3
Set up a CloakBrowser Docker container for running headless scraping jobs in a CI pipeline, give me the Dockerfile or run command.
Prompt 4
Help me create five browser profiles with different proxies in CloakBrowser Manager via the local web interface.
Open on GitHub → Explain another repo

← cloakhq on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.