CloakBrowser

0.3.27 verified Sat May 09 auth: no python

Stealth Chromium that passes every bot detection test. A drop-in Playwright replacement with 57+ source-level C++ fingerprint patches. Current version 0.3.27, requires Python >=3.9. Releases follow Chromium versions with frequent stealth updates.

pip install cloakbrowser

Common errors

error ModuleNotFoundError: No module named 'cloakbrowser' ↓

cause Package not installed in the current environment.

fix

Install with pip install cloakbrowser.

error Error: The browser binary could not be fetched. Please check your internet connection. ↓

cause First launch downloads a ~250MB binary; network issues or proxy blocks may cause download failure.

fix

Ensure stable internet, or manually download from https://github.com/CloakHQ/CloakBrowser/releases and set CLOAK_BINARY_PATH.

error AttributeError: 'Browser' object has no attribute 'new_context' ↓

cause Using Playwright syntax inconsistently; cloakbrowser uses the same API but some methods may differ.

fix

Use browser.new_page() or await browser.new_context() depending on sync/async. Check Playwright docs for correct method names.

error Error: Failed to launch chromium: executable path is not a file ↓

cause The browser binary path was set incorrectly via environment variable or manually.

fix

Remove any custom CLOAK_BINARY_PATH or ensure it points to the correct executable.

Warnings

gotcha CloakBrowser only supports 'chromium' (not firefox or webkit) and runs a custom Chromium binary downloaded on first launch. Do NOT use Playwright's browser install commands. ↓

fix Call `p.chromium.launch()` directly; the binary auto-downloads. No need to run `playwright install`.

breaking In version 0.3.x, `launch_persistent_context()` had fingerprint consistency fixes; older versions may fail detection tests in persistent contexts. Always use >=0.3.6. ↓

fix Update to 0.3.6+ using `pip install --upgrade cloakbrowser`.

gotcha CloakBrowser's browser binary requires a compatible system glibc and libstdc++ (Linux) or Windows libraries. Raspberry Pi / ARM users must use Linux arm64 builds available since v145.0.7632.159.7. ↓

fix Check https://github.com/CloakHQ/CloakBrowser/releases for platform support.

deprecated The `--fingerprint-noise` flag was deprecated in chromium-v145.0.7632.159.8; noise injection is now controlled via a different mechanism. Use `--fingerprint-noise` flag only if you need backward compatibility. ↓

fix See changelog for new fingerprint noise configuration.

Imports

sync_playwright
```
from cloakbrowser import sync_playwright
```
CloakBrowser wraps Playwright's API to reuse the same import style, but replaces the internal sync_playwright with its stealth patched version.
async_playwright
```
from cloakbrowser import async_playwright
```
For async usage; replaces Playwright's async_playwright with a stealth-patched one.

Quickstart

Launch a stealth Chromium and capture a screenshot of a bot detection test page.

from cloakbrowser import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)
    page = browser.new_page()
    page.goto('https://bot.sannysoft.com')
    page.screenshot(path='detection.png')
    browser.close()