CloakBrowser is a stealth Chromium browser designed to bypass bot detection systems through source-level modifications rather than configuration patches or JavaScript injection. The repository provides drop-in replacements for Playwright and Puppeteer across Python, JavaScript, and .NET environments, allowing developers to swap imports with minimal code changes. The core innovation is that CloakBrowser modifies fingerprints at the C++ source level within the Chromium binary itself, making it appear as a legitimate browser to antibot detection systems because it functionally is one.
The project implements 58 to 59 source-level C++ patches targeting various detection vectors including canvas rendering, WebGL, audio contexts, font enumeration, GPU information, screen properties, WebRTC IP leakage, network timing, and automation signals. These patches operate at the binary level rather than through runtime JavaScript injection, which makes them resistant to detection updates that typically break configuration-based stealth tools. The repository claims to pass all 30 tests against major detection services including reCAPTCHA v3, Cloudflare Turnstile, FingerprintJS, BrowserScan, and ShieldSquare.
Installation is straightforward through pip for Python or npm for JavaScript, with the stealth Chromium binary automatically downloading on first run. The project offers a humanize feature accessible via a single flag that implements human-like mouse curves, keyboard timing, and scroll patterns to defeat behavioral detection. Additional capabilities include timezone and locale auto-detection from proxy IP addresses, persistent profile support for maintaining cookies and localStorage across sessions, and native SOCKS5 proxy support with inline credential authentication.
The project shares contributors with ollama/ollama, mudler/localai, and microsoft/vscode according to GitGenius analysis.
CloakBrowser operates on a freemium model where the wrapper code is MIT-licensed and free forever, while the binary uses a delayed release strategy. Version 146 remains free indefinitely but becomes stale as detection systems evolve. The project explicitly targets use cases including AI agents, web scraping, browser automation, QA testing, and monitoring where stale fingerprints would degrade performance.
The repository is classified by GitGenius across multiple security and privacy categories including web browser, privacy, security, anonymous browsing, encryption, user protection, tracking prevention, private browsing, secure communication, and internet safety. The project homepage at cloakbrowser.dev provides additional resources and Pro subscription information.
