{"id":27652,"library":"cloakbrowser","title":"CloakBrowser","description":"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.","status":"active","version":"0.3.27","language":"python","source_language":"en","source_url":"https://github.com/CloakHQ/CloakBrowser","tags":["stealth-browser","undetected-chromedriver","fingerprinting","playwright","automation","anti-bot"],"install":[{"cmd":"pip install cloakbrowser","lang":"bash","label":"pip"}],"dependencies":[],"imports":[{"note":"CloakBrowser wraps Playwright's API to reuse the same import style, but replaces the internal sync_playwright with its stealth patched version.","symbol":"sync_playwright","correct":"from cloakbrowser import sync_playwright"},{"note":"For async usage; replaces Playwright's async_playwright with a stealth-patched one.","symbol":"async_playwright","correct":"from cloakbrowser import async_playwright"}],"quickstart":{"code":"from cloakbrowser import sync_playwright\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch(headless=False)\n    page = browser.new_page()\n    page.goto('https://bot.sannysoft.com')\n    page.screenshot(path='detection.png')\n    browser.close()","lang":"python","description":"Launch a stealth Chromium and capture a screenshot of a bot detection test page."},"warnings":[{"fix":"Call `p.chromium.launch()` directly; the binary auto-downloads. No need to run `playwright install`.","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Update to 0.3.6+ using `pip install --upgrade cloakbrowser`.","message":"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.","severity":"breaking","affected_versions":">=0.3.0, <0.3.6"},{"fix":"Check https://github.com/CloakHQ/CloakBrowser/releases for platform support.","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"See changelog for new fingerprint noise configuration.","message":"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.","severity":"deprecated","affected_versions":">=chromium-v145.0.7632.159.8"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install with `pip install cloakbrowser`.","cause":"Package not installed in the current environment.","error":"ModuleNotFoundError: No module named 'cloakbrowser'"},{"fix":"Ensure stable internet, or manually download from https://github.com/CloakHQ/CloakBrowser/releases and set CLOAK_BINARY_PATH.","cause":"First launch downloads a ~250MB binary; network issues or proxy blocks may cause download failure.","error":"Error: The browser binary could not be fetched. Please check your internet connection."},{"fix":"Use `browser.new_page()` or `await browser.new_context()` depending on sync/async. Check Playwright docs for correct method names.","cause":"Using Playwright syntax inconsistently; cloakbrowser uses the same API but some methods may differ.","error":"AttributeError: 'Browser' object has no attribute 'new_context'"},{"fix":"Remove any custom CLOAK_BINARY_PATH or ensure it points to the correct executable.","cause":"The browser binary path was set incorrectly via environment variable or manually.","error":"Error: Failed to launch chromium: executable path is not a file"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}