Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
launch
✓ from cloakbrowser import launch
✗ from cloakbrowser import sync_playwright
launch_async
✓ from cloakbrowser import launch_async
browser
✓ from cloakbrowser import browser
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()
Debug
Known issues
gotchaCloakBrowser 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.fixCall `p.chromium.launch()` directly; the binary auto-downloads. No need to run `playwright install`.
affects: all
breakingIn 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.fixUpdate to 0.3.6+ using `pip install --upgrade cloakbrowser`.
affects: >=0.3.0, <0.3.6
gotchaCloakBrowser'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.fixCheck https://github.com/CloakHQ/CloakBrowser/releases for platform support.
affects: all
deprecatedThe `--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.fixSee changelog for new fingerprint noise configuration.
affects: >=chromium-v145.0.7632.159.8
Upgrade
Version history
0.3.27latest on PyPI · released May 6, 2026
Audit
Dependencies
No dependency data recorded yet.