Install & Compatibility
Where this runs
tested against v0.5.5 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 9.6s · import 2.246s · 275MB
272MB installed
● package 272MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Camoufox
✓ from camoufox import Camoufox
✗ from camoufox import launch
AsyncCamoufox
✓ from camoufox import AsyncCamoufox
NewBrowser
✓ from camoufox import NewBrowser
Launches a Camoufox browser instance (visible by default), navigates to a page, prints its title, takes a screenshot, and then closes the browser. This demonstrates basic browser automation with Camoufox.
import asyncio
from camoufox import launch
async def main():
# headless=False launches a visible browser; set to True for background operation
browser = await launch(headless=False)
page = await browser.new_page()
await page.goto("https://www.example.com")
print(f"Page title: {await page.title()}")
await page.screenshot(path="example.png")
await browser.close()
if __name__ == '__main__':
asyncio.run(main())
Debug
Known issues
gotchaCamoufox is explicitly stated to be in active development and may not be suitable for a production environment. Users should anticipate frequent changes, potential bugs, and a lack of long-term stability guarantees.fixUse with caution in non-critical environments. Monitor the Camoufox GitHub repository for updates and bug reports. Consider locking your project's dependencies to specific working versions.
affects: All versions (0.x.x)
breakingA critical leak fix was implemented, requiring users to update the Python library. Older versions (specifically pre-0.4.4) may suffer from unpatched leaks that could compromise privacy or stealth capabilities.fixUpgrade the Camoufox Python library to version 0.4.4 or newer to incorporate the leak fix: `pip install --upgrade camoufox`.
affects: <0.4.4
gotchaUnderlying Camoufox browser builds (e.g., v146-hardware, FF146-BETA) are often released with warnings about being untested, unstable, or having known issues on specific platforms (e.g., Linux failing to launch pages, MacOS with known bugs).fixBefore deployment, review the Camoufox GitHub releases page for known issues relevant to the browser version your `camoufox` Python library will pull and launch. Test thoroughly on your target operating system.
affects: Specific browser builds launched by any camoufox Python version. Refer to Camoufox GitHub releases for details on browser binaries.
gotchaEarlier beta browser builds (e.g., v135.0-beta.21) had a bug that broke Playwright's routing API functionality. While fixed in subsequent browser builds, users on older `camoufox` Python library versions that pull these specific problematic browser builds might encounter issues.fixEnsure you are using a recent version of the `camoufox` Python library to benefit from updated and fixed browser binaries. Always test routing functionality if it's critical to your application.
affects: Potentially `camoufox` Python versions that are designed to launch browser builds prior to `v135.0-beta.22`.
Upgrade
Version history
0.5.5latest on PyPI · released Aug 18, 2026
Audit
Dependencies
playwrightrequiredCamoufox is a wrapper around Playwright and depends on its browser automation capabilities.