README

Stealth Chromium that passes every bot detection test.


Not a patched config. Not a JS injection. A real Chromium binary with fingerprints modified at the C++ source level. Antibot systems score it as a normal browser — because it is a normal browser.






Cloudflare Turnstile — 3 live tests passing (headed mode, macOS)





Drop-in Playwright/Puppeteer replacement for Python and JavaScript.
Same API, same code — just swap the import. 3 lines of code, 30 seconds to unblock.


- 87 source-level C++ patches — canvas, WebGL, audio, fonts, GPU, screen, WebRTC, network timing, automation signals, CDP input behavior
- humanize=True — human-like mouse curves, keyboard timing, and scroll patterns. One flag, behavioral detection passes
- Pro: 0.9 reCAPTCHA v3 score — human-level, server-verified
- Passes Cloudflare Turnstile, FingerprintJS, BrowserScan — tested against 50+ detection sites
- Auto-downloads the right binary — the latest build for your platform
- pip install cloakbrowser or npm install cloakbrowser — binary auto-downloads, zero config
- Latest binary, free to try — get a free key with your email (or just launch: the first run asks), point the newest build at your hardest target, scale to thousands of sessions on Pro

Try it now — no install needed. The first run asks for a key: get one free with your email, or paste yours:

bash
docker run --rm -it cloakhq/cloakbrowser cloaktest


Python:

python
from cloakbrowser import launch

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


JavaScript (Playwright):

javascript
import { launch } from 'cloakbrowser';

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


Also works with Puppeteer: import { launch } from 'cloakbrowser/puppeteer' (details)

For sites with anti-bot protection, add a residential proxy and these flags:

python
browser = launch(
    proxy="http://user:pass@residential-proxy:port",   residential IP, not datacenter
    geoip=True,        match timezone + locale to proxy IP
    headless=False,     some sites detect headless even with C++ patches
    humanize=True,      human-like mouse, keyboard, scroll
)


javascript
const browser = await launch({
    proxy: 'http://user:pass@residential-proxy:port',
    geoip: true,
    headless: false,
    humanize: true,
});


See Troubleshooting for site-specific issues (Kasada, Akamai, reCAPTCHA).

 Install

Python:

bash
pip install cloakbrowser


JavaScript / Node.js:

bash
 With Playwright
npm install cloakbrowser playwright-core

 With Puppeteer
npm install cloakbrowser puppeteer-core


.NET / C:

bash
dotnet add package CloakBrowser


 Community-maintained .NET client built on Microsoft.Playwright. See dotnet/README.md for the full API.

---

On first run, the stealth Chromium binary is automatically downloaded (~200MB, cached locally).

License key: every launch needs one, and a free key takes one email. The f