CloakBrowser Stealth Browser

Stealth Chromium with source-level C++ fingerprint patches that passes bot detection tests, a drop-in Playwright replacement.

Stars
★ 32k
Last updated
4d ago
License
MIT
Primary language
Python

At a glance

How it runs
Library / SDKCLISelf-hosted service
Works with
Platform-specific
Cost
Free tier plus a paid hosted plan
Setup effort
Low · running in minutes
You'll need
Python 3.7+Node.js 14+Docker (optional)Shell / CLINetwork accessLocal filesystem
Typical use
Web scrapers needing to bypass Cloudflare Turnstile or reCAPTCHA.
Not a fit if
  • Teams needing built-in proxy rotation or CAPTCHA solving
  • Environments that must stay fully offline with no ~200MB binary download
  • Production scrapers needing many concurrent sessions for free

What does this agent do, and when should you use it?

CloakBrowser is a modified Chromium binary with C++ source-level patches to make fingerprints indistinguishable from a real browser. It provides Python and JavaScript wrappers with APIs fully compatible with Playwright and Puppeteer. The browser auto-generates random fingerprints by default and includes 71 patches (version 150) covering Canvas, WebGL, audio, GPU, network timing, and more, even supporting human-like behavior simulation. It passes tests against 30+ detection sites, including Cloudflare Turnstile and FingerprintJS, and offers free and Pro tiers. Installation is simple via pip or npm, with Docker support and integrations for multiple frameworks.

CloakBrowser provides functions like launch(), launch_async(), launch_context(), and launch_persistent_context() to start a browser. It automatically downloads and verifies pre-compiled Chromium binaries, supports proxies (HTTP/SOCKS5), GeoIP auto timezone/locale, humanized mouse/keyboard operations (humanize=True), and persistent profiles. It manages fingerprints via command-line arguments like --fingerprint and offers CLI commands (cloakbrowser login, install, etc.) and a Docker image (cloakhq/cloakbrowser) for quick testing.

  1. Web scrapers needing to bypass Cloudflare Turnstile or reCAPTCHA.
  2. QA engineers automating tests that require realistic user behavior.
  3. Social media automation tools that need to avoid account linking.
  4. Users accessing geo-restricted content using proxy and GeoIP features.
  5. AI agent developers needing to run stealth browser instances at scale.
  6. Developers wanting seamless integration with Playwright/Puppeteer to reduce migration costs.

How do you install or deploy this agent?

Python: pip install cloakbrowser; JavaScript: npm install cloakbrowser playwright-core (or puppeteer-core); .NET: dotnet add package CloakBrowser. The binary (~200MB) auto-downloads on first run. Optional GeoIP support: pip install 'cloakbrowser[geoip]'.

How do you use this agent?

Python example:

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

JavaScript example:

import { launch } from 'cloakbrowser';
const browser = await launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Docker quick test: docker run --rm cloakhq/cloakbrowser cloaktest. See README for options like proxy, humanize, fingerprint seeds, and more.

What are this agent's strengths and limitations?

Pros
  • Source-level patches provide stealth harder to detect than JS injection or config patches.
  • Fully compatible with Playwright/Puppeteer API for easy migration.
  • Continuously updated to keep up with anti-bot evolution.
  • Multi-language support (Python, JS, C#) and Docker deployment.
  • Free tier available to try the latest binary quickly.
Limitations
  • Free tier limits to one concurrent session, and older binaries become less effective over time.
  • Advanced features (e.g., reCAPTCHA 0.9 score) require a paid Pro subscription.
  • Large binary (~200MB) and first download takes time.
  • On Linux, may require additional Windows fonts to pass certain detections (e.g., FingerprintJS).
  • No built-in proxy rotation or CAPTCHA solving; you must bring your own.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
CloakBrowser Stealth Browser This agent 50 · Major gaps Library / SDKFreemium ★ 32k 4d ago Python —
Obscura Headless Browser 75 · Good CLIFree ★ 29k 3d ago Rust Claude.ai
Invisible Browser Agent 57 · Major gaps MCP serverFree + model costs ★ 2.8k 1d ago Python Codex · Claude Code
Camoufox CLI 60 · Some gaps CLIFree ★ 353 5d ago Python Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
50/ 100 5-point scale 2.5 / 5
This review covers the source as of Aug 09, 2026. The project has shipped 8 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 10/29
Reliability 8/14
Adaptability 12/18
Convention 10/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust10 / 29 · 1.7/5

Evidence shows: MIT license, pinned dependencies, Ed25519 signature verification for binary downloads, but no explicit least-privilege principle, missing user confirmation, limited data flow transparency, unclear sensitive data handling (e.g., proxy credentials), partial disclosure of external effects (e.g., network calls), rollback exists but limited, source attribution only via GitHub repo and author info, publisher identity unverified. Deductions: missing user confirmation, insufficient data flow transparency, unclear sensitive data handling, incomplete external effects disclosure, imperfect rollback, unverified source attribution.

Reliability8 / 14 · 2.9/5

Evidence shows: good internal consistency in code and tests, clear dependency versions, but failure messages are limited in detail. Deductions: failure messages may not be detailed enough, dependency availability not fully verified.

Adaptability12 / 18 · 3.3/5

Evidence shows: targets developers, provides multiple use scenarios, clear capability boundaries, precise triggers, good environment fit. Deductions: some scenarios (e.g., Docker) not fully detailed.

Convention10 / 18 · 2.8/5

Evidence shows: clear information architecture, detailed install notes, stable naming, rich examples and FAQ, partial known limitations, clear license, versioning and changelog present, maintenance responsibility clear. Deductions: incomplete known limitations, maintenance responsibility not fully clear.

Effectiveness7 / 13 · 2.7/5

Evidence shows: high output usability, clear marginal value, but cost-benefit not fully explained. Deductions: insufficient cost-benefit analysis.

Verifiability3 / 8 · 1.9/5

Evidence shows: some claims supported by tests, but insufficient cross-source corroboration, unclear separation of facts and inferences. Deductions: insufficient cross-source corroboration, unclear fact-inference separation.

Risks and how to mitigate them
  • Not found in source: confirmation before actingTurn on (or add) a confirmation step before it acts, and try it in a sandbox or test environment before real data.
  • The project claims to bypass all bot detection, but no reproducible test results are provided, and tests may be environment-specific.
  • Binary downloads and license validation rely on external services, posing supply chain risks.
  • Handling of sensitive information like proxy credentials is not clearly documented, potentially leading to logging or leakage.
  • No user confirmation mechanism is provided, which may lead to automatic execution of high-risk operations.
Evidence confidence: Low Reviewed Aug 09, 2026 Reviewed revision ec8802672321 New commits since this review; the score may not cover them
See the full review method →

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. chromium-v154.0.8037.57.2-pro Chromium v154.0.8037.57.2 — Stealth Build (Pro)
    Release notes excerpt
    CloakBrowser Pro: Linux Stable advances to Chromium 154.0.8037.57.2 Chromium 154.0.8037.57.2 is now Stable on Linux (x64 and ARM64). Windows and macOS Stable stay on 154.0.8037.57.1. With a valid CloakBrowser key, the wrapper automatically selects the Stable build for your platform. No version pin is required. What's new since 154.0.8037.57.1 (Linux) - 3 to 6 times less CPU when running headed in Docker or on a GPU-less Linux server. Headless mode and machines with a real GPU are not affected. …
    View on GitHub ↗
  2. chromium-v154.0.8037.57.1-pro Chromium v154.0.8037.57.1 — Stealth Build (Pro)
    Release notes excerpt
    CloakBrowser Pro: Stable advances to Chromium 154.0.8037.57.1 (all platforms) Chromium 154.0.8037.57.1 is now Stable on Linux (x64 and ARM64), Windows (x64), and macOS (Apple Silicon and Intel). This is the first Stable on Chromium 154, and every platform now runs the same engine. With a valid CloakBrowser key, the wrapper automatically selects the Stable build for your platform. No version pin is required. What's new …
    View on GitHub ↗
  3. chromium-v152.0.7977.82.1-pro Chromium v152.0.7977.82.1 — Stealth Build (Pro)
    Release notes excerpt
    CloakBrowser Pro — Stable advances to Chromium 152.0.7977.82.1 (Linux + Windows) Chromium 152.0.7977.82.1 is now Stable on Linux (x64 and ARM64) and Windows (x64). This is the first Stable on Chromium 152. macOS Stable remains on 151.0.7922.108.3. With a valid CloakBrowser key, the wrapper automatically selects the Stable build for your platform. No version pin is required. What's new - The newest Chromium, 152. The engine, its features, and the version it reports all step up to the current major, so you stay current with what real browsers ship. …
    View on GitHub ↗

FAQ

What's the difference between free and Pro?
Free tier (requires GitHub sign-in) gives you access to the latest binary but only one concurrent session. Pro supports higher concurrency, priority access to new patches, and hands-on support, and costs money. Older binaries (e.g., Chromium 146) are free to download but may not pass latest detection.
How do I set up a proxy?
Pass proxy="http://user:pass@host:port" or proxy="socks5://..." to launch(). You can also use geoip=True to automatically adjust timezone and locale to match the proxy IP.
Why am I still blocked on some sites?
Ensure you are using the latest version, a residential proxy, geoip=True, headless=False, and humanize=True. On Linux, installing necessary fonts (like Noto Color Emoji and Windows fonts) may help pass strict detections.
Does it support persistent sessions?
Yes, use launch_persistent_context() to save cookies and localStorage, avoiding incognito detection.
View on GitHub ↗ Install ↓

Related agents