CloakBrowser — What is it?

CloakBrowser is a stealth Chromium-based browser designed to bypass bot detection systems, providing a drop-in replacement for Playwright and Puppeteer with source-level fingerprint patches.

⭐ 8,734 Stars 🍴 646 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 by modifying Chromium's source code at the C++ level, offering a more reliable and stealthy alternative to JavaScript-based patches. Its seamless integration with Playwright and Puppeteer, along with its auto-updating binary and human-like interaction features, make it a compelling choice for developers dealing with bot detection challenges.

Source: Synthesis of README and project traits

Core Features

Source-level fingerprint patches

CloakBrowser modifies Chromium's source code at the C++ level to alter fingerprints, making it appear as a normal browser to bot detection systems.

Source: per README
Drop-in Playwright replacement

CloakBrowser provides a direct replacement for Playwright and Puppeteer, allowing developers to use the same API and code with minimal changes.

Source: per README
Human-like interaction

The `humanize=True` flag enables human-like mouse curves, keyboard timing, and scroll patterns, enhancing stealth against behavioral detection systems.

Source: per README
Auto-updating binary

CloakBrowser includes an auto-updating binary that ensures users always have the latest stealth build without manual intervention.

Source: per README

Architecture

The architecture of CloakBrowser is centered around a modified Chromium binary with extensive source-level modifications. It includes a modular design with separate components for human-like interaction, proxy handling, and integration with automation frameworks. The codebase is structured to facilitate easy updates and maintenance, with a clear separation of concerns.

Source: Code tree + dependency files

Tech Stack

infra: Docker  |  key_deps: playwright, httpx, geoip2, socksio, patchright, aiohttp, websockets  |  language: Python  |  framework: Playwright, Puppeteer

Source: Dependency files + code tree

Quick Start

```bash pip install cloakbrowser # For JavaScript/Node.js with Playwright: npm install cloakbrowser playwright-core # For JavaScript/Node.js with Puppeteer: npm install cloakbrowser puppeteer-core # Docker: docker run --rm cloakhq/cloakbrowser cloaktest ```
Source: README Installation/Quick Start

Use Cases

CloakBrowser is suitable for developers who need to bypass bot detection systems for web scraping, automated testing, or AI agent interactions. It is particularly useful in scenarios where traditional browser automation tools are detected and blocked by websites.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Effective against bot detection systems
  • Strength 2: Seamless integration with Playwright and Puppeteer
  • Strength 3: Auto-updating for the latest stealth build

Limitations

  • Limitation 1: May require additional setup for proxy usage
  • Limitation 2: Not a CAPTCHA-solving tool
Source: Synthesis of README, code structure and dependencies

Latest Release

v0.3.26 (Chromium 146.0.7680.177.4) - Released on 2026-04-28. This release includes an upgrade to Chromium 146, additional fingerprint patches, WebRTC IP spoofing, and improvements to the `cloakserve` CDP multiplexer.

Source: GitHub Releases

Verdict

CloakBrowser is a valuable tool for developers dealing with bot detection challenges, offering a robust and stealthy alternative to traditional browser automation tools. Its focus on source-level modifications and seamless integration with popular frameworks makes it a strong choice for those requiring a reliable and efficient solution.

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-09 18:31. Quality score: 85/100.

Data sources: README, GitHub API, dependency files