camoufox

What it is and what it does

This package wraps Playwright's API to launch a modified Firefox browser with automatically generated device fingerprints that mimic real-world traffic patterns. Instead of using a generic browser profile, it uses browserforge to create unique OS, CPU, navigator, font, screen, and WebGL characteristics for each session. It also calculates matching geolocation, timezone, and locale data to avoid proxy detection mismatches.

The package is designed for web scraping, testing, and automation scenarios where detection avoidance matters. It provides both a Python API and CLI tools to manage browser versions, switch between official and community builds, and configure active channels. Optional GeoIP support requires downloading a MaxMind database to map proxy IPs to realistic location data.

Use it for:

• Web scraping sites that detect and block headless browsers or detect mismatched geolocation and proxy origin
• Automated testing of anti-bot systems to verify they catch realistic fingerprints
• Running browser automation tasks through residential proxies with matching timezone and locale
• Generating multiple concurrent browser sessions with statistically realistic device profiles
• Debugging browser fingerprinting by inspecting injected characteristics via Playwright inspector

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python wrapper around Playwright that automatically generates and injects realistic device fingerprints (OS, CPU, navigator, fonts, screen dimensions, WebGL, etc.) into a headless Firefox browser to avoid detection.

Yes, if you need browser automation with anti-detection fingerprinting. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. Install with the [geoip] extra if using proxies. Requires downloading the browser binary separately via CLI before first use.

Install

camoufox on PyPI

pip install camoufox

uv add camoufox

poetry add camoufox

Installing camoufox

Before you install

Low friction: pure Python wheel with 16 runtime dependencies including playwright and browserforge. Active maintenance—last commit 2026-08-12, released 29 days ago. Supports Python 3.10 through 3.14. No known vulnerabilities.

License in practice

MIT license (permissive). You can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.

Quickstart

pip install 'camoufox[geoip]'
python3 -m camoufox fetch

from camoufox import launch

async with await launch() as browser:
    page = await browser.new_page()
    await page.goto('https://example.com')

Requires the Camoufox browser binary to be downloaded separately via camoufox fetch before use. Python 3.10 or later required.

Verify before relying

• Whether fingerprint generation actually defeats modern anti-bot detection systems in practice
• Performance overhead compared to plain Playwright when generating unique fingerprints per session
• Compatibility with Playwright versions beyond those tested in the package's CI

Package facts

Evidence: camoufox-0.5.4-py3-none-any.whl

Keywords: client, fingerprint, browser, scraping, injector, firefox, playwright

Tags

More Python Modules packages