CloakBrowser is an open-source project designed to provide a stealthy Chromium browser that can bypass advanced bot detection systems. Unlike traditional approaches that rely on JavaScript injection or configuration tweaks, CloakBrowser modifies browser fingerprints at the C++ source code level and compiles them directly into the Chromium binary. This ensures that anti-bot systems perceive CloakBrowser as a genuine, unmodified browser, significantly reducing the likelihood of detection. The repository offers a drop-in replacement for Playwright and Puppeteer, enabling users to switch to CloakBrowser with minimal code changes while retaining familiar browser automation APIs in both Python and JavaScript.
The main features of CloakBrowser include over 57 source-level fingerprint patches covering a wide range of detection vectors such as canvas, WebGL, audio, fonts, GPU, screen properties, WebRTC, network timing, hardware reporting, and automation signal removal. These patches are compiled into the browser binary, making them robust against browser updates and immune to detection methods that target injected scripts or altered configurations. CloakBrowser also offers behavioral stealth with the `humanize=True` flag, which simulates human-like mouse movements, keyboard input, and scrolling patterns. This helps pass behavioral bot detection tests that analyze user interaction patterns.
CloakBrowser is tested against more than 30 detection sites, including Cloudflare Turnstile, FingerprintJS, BrowserScan, and reCAPTCHA v3. It consistently achieves high scores and passes all major tests, with a reCAPTCHA v3 score of 0.9 (human-level) and successful navigation through Cloudflare challenges. The browser automatically updates its binary in the background, ensuring users always have the latest stealth build. Installation is straightforward via `pip install cloakbrowser` for Python or `npm install cloakbrowser` for JavaScript/Node.js, with the binary auto-downloading and caching locally. Optional geo-location features allow timezone and locale to be auto-detected from proxy IPs, further enhancing stealth capabilities.
For persistent browsing sessions, CloakBrowser supports profile management, enabling cookies, localStorage, and cache to survive across restarts. This is useful for maintaining logged-in states, bypassing incognito detection, and loading Chrome extensions. The repository also provides a self-hosted Browser Profile Manager, which serves as an alternative to commercial tools like Multilogin, GoLogin, and AdsPower. This manager allows users to create profiles with unique fingerprints and proxies, and interact with them via a web interface.
CloakBrowser’s API mirrors Playwright and Puppeteer, offering synchronous and asynchronous launch functions, context management, and persistent profile options. It supports advanced proxy configurations, WebRTC IP spoofing, and custom Chrome arguments. Utility functions are available for managing the binary, checking installation status, and clearing caches. The JavaScript package includes full TypeScript definitions and works seamlessly with both Playwright and Puppeteer, although Playwright is recommended for sites with reCAPTCHA Enterprise due to Puppeteer’s protocol limitations.
In summary, CloakBrowser is a robust, actively maintained solution for browser automation that prioritizes stealth at the binary level. It is free, open source, and designed to be resilient against evolving detection methods, making it an ideal tool for web scraping, automation, and AI agent integration where undetectability is crucial.
