Home / AI Trending / CloakHQ/CloakBrowser

CloakBrowser — What is it?

CloakBrowser is a stealth Chromium-based browser that bypasses bot detection tests and serves as a drop-in replacement for Playwright and Puppeteer.

⭐ 27,867 Stars 🍴 2,228 Forks Python MIT Author: CloakHQ
Source: per README View on GitHub →

Why it matters

CloakBrowser is gaining attention due to its ability to pass bot detection tests, its seamless integration with existing Playwright and Puppeteer codebases, and its source-level fingerprint patches that provide a more robust solution compared to config-level patches. The project stands out for its unique approach to stealth and its comprehensive support for various automation frameworks.

Source: Synthesis of README and project traits

Core Features

Source-level fingerprint patches

CloakBrowser modifies Chromium's C++ source code to alter fingerprints, ensuring that it is not detected by bot detection systems. This is a more reliable approach than config-level patches, which can be broken by Chrome updates.

Source: per README
Drop-in replacement for Playwright and Puppeteer

CloakBrowser provides a simple API swap for Playwright and Puppeteer, allowing developers to use it without significant code changes. This feature makes it easy to integrate into existing projects.

Source: per README
Human-like interaction patterns

The `humanize=True` flag enables human-like mouse curves, keyboard timing, and scroll patterns, helping to pass behavioral detection tests.

Source: per README
Auto-updating binary

CloakBrowser includes an auto-updating feature that ensures the latest stealth build is always used, keeping the browser up-to-date with the latest security patches and features.

Source: per README

Architecture

The architecture of CloakBrowser is modular, with separate components for browser launching, humanization of interactions, and proxy management. It uses a combination of C++ source modifications and Python/JavaScript APIs to provide a robust and flexible solution. The project leverages Docker for deployment and uses various Python libraries for handling tasks such as HTTP requests and proxy support.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) playwright httpx geoip2 socksio patchright Source-level fingerprint patchesSource-level finger… Drop-in replacement for Playwright and PuppeteerDrop-in replacement… Human-like interaction patternsHuman-like interact… Auto-updating binary CloakBrowser Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguagePythonFrameworkPlaywright, Puppeteer
Key dependencies
playwrighthttpxgeoip2socksiopatchrightaiohttpwebsockets
Infrastructure / Deployment
Docker
Source: Dependency files + code tree

Quick Start

```bash pip install cloakbrowser # For JavaScript/Node.js npm install cloakbrowser playwright-core # To run a test docker run --rm cloakhq/cloakbrowser cloaktest # Python example from cloakbrowser import launch browser = launch() page = browser.new_page() page.goto('https://protected-site.com') browser.close() # JavaScript (Playwright) example import { launch } from 'cloakbrowser'; const browser = await launch(); const page = await browser.newPage(); await page.goto('https://protected-site.com'); await browser.close(); ```
Source: README Installation/Quick Start

Use Cases

CloakBrowser is suitable for developers who need to automate web scraping, web testing, or any task that requires bypassing bot detection. It is particularly useful for scenarios involving CAPTCHA challenges, Cloudflare Turnstile, and other anti-bot measures.

Source: README

Strengths & Limitations

Strengths

  • Strengths: Robust against bot detection, seamless integration with automation frameworks, source-level patches for long-term reliability

Limitations

  • Limitations: May require additional setup for proxy management, not a CAPTCHA solver, limited to web-based tasks
Source: Synthesis of README, code structure and dependencies

Latest Release

v0.3.30 (Chromium 146.0.7680.177.5) - Released on 2026-05-21. This release includes 58 fingerprint patches, Windows native GPU passthrough, HTTP proxy inline credentials, and support for loading Chrome extensions.

Source: GitHub Releases

Verdict

CloakBrowser is a valuable tool for developers requiring stealthy web automation. Its source-level patches and seamless integration with existing automation frameworks make it a compelling choice for those looking to bypass bot detection without significant code changes. It is particularly well-suited for teams working on web scraping and testing projects.

Source: Synthesis

Frequently Asked Questions

What is CloakBrowser?

CloakBrowser is a stealth Chromium-based browser that bypasses bot detection tests and serves as a drop-in replacement for Playwright and Puppeteer.

What are the main features of CloakBrowser?

CloakBrowser's core features include: Source-level fingerprint patches, Drop-in replacement for Playwright and Puppeteer, Human-like interaction patterns, Auto-updating binary.

Why is CloakBrowser trending?

CloakBrowser is gaining attention due to its ability to pass bot detection tests, its seamless integration with existing Playwright and Puppeteer codebases, and its source-level fingerprint patches that provide a more…

What is CloakBrowser used for?

CloakBrowser is suitable for developers who need to automate web scraping, web testing, or any task that requires bypassing bot detection.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-22 11:11. Quality score: 85/100.

Data sources: README, GitHub API, dependency files