cloakhq/cloakbrowser repository overview

⁠CloakBrowser

Stealth Chromium that passes every bot detection test.

A real Chromium binary with 26 source-level C++ fingerprint patches. Drop-in Playwright/Puppeteer replacement for Python and JavaScript. Same API, same code — just swap the import.

• 26 source-level C++ patches — canvas, WebGL, audio, fonts, GPU, screen, automation signals
• 0.9 reCAPTCHA v3 score — human-level, server-verified
• Passes Cloudflare Turnstile, FingerprintJS, BrowserScan — tested against 30+ detection sites
• Auto-updating binary — always on the latest stealth build
• Free and open source — no subscriptions, no usage limits

⁠Quick Test

docker run --rm cloakhq/cloakbrowser cloaktest

Runs a stealth test suite against live detection sites. No install, no config.

⁠Run a Script

# Inline
docker run --rm cloakhq/cloakbrowser python -c "
from cloakbrowser import launch
browser = launch()
page = browser.new_page()
page.goto('https://example.com')
print(page.title())
browser.close()
"

# Mount your own script
docker run --rm -v ./my_script.py:/app/my_script.py cloakhq/cloakbrowser python my_script.py

# With a proxy
docker run --rm cloakhq/cloakbrowser python -c "
from cloakbrowser import launch
browser = launch(proxy='http://user:pass@proxy:8080')
page = browser.new_page()
page.goto('https://example.com')
print(page.title())
browser.close()
"

# JavaScript
docker run --rm cloakhq/cloakbrowser bash -c "cd /app/js && npx tsx examples/stealth-test.ts"

⁠CDP Server Mode

Start a persistent stealth browser and connect remotely via Chrome DevTools Protocol:

docker run -d --name cloak -p 127.0.0.1:9222:9222 cloakhq/cloakbrowser cloakserve

Connect from your host machine:

from playwright.sync_api import sync_playwright

pw = sync_playwright().start()
browser = pw.chromium.connect_over_cdp("http://localhost:9222")
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()

Pass extra flags: cloakserve --proxy-server=host:port or cloakserve --headless=false for headed mode.

⁠Extend with Your Own Image

FROM cloakhq/cloakbrowser
COPY your_script.py /app/
CMD ["python", "your_script.py"]

⁠What's Included

• Pre-downloaded stealth Chromium binary (no runtime download)
• Python wrapper + JS wrapper (Playwright & Puppeteer)
• Example scripts for both languages
• Xvfb for headed mode support (virtual display on :99)
• cloaktest CLI for quick stealth verification
• cloakserve CLI for CDP server mode (remote debugging)

⁠Also Available

• pip: pip install cloakbrowser
• npm: npm install cloakbrowser

For fingerprint customization, proxy configuration, persistent profiles, timezone/locale spoofing, and other advanced features, see the full documentation on GitHub⁠.

⁠Links

• GitHub⁠ — full docs, API reference, advanced usage
• PyPI⁠
• npm⁠
• Website⁠

⁠License

• Wrapper code — MIT⁠
• CloakBrowser binary — free to use, no redistribution. Binary License⁠