---
id: camoufox
version: "0.5.4"
license: MIT
license_treatment: permissive
maintenance: active
---

# camoufox — Wrapper around Playwright to help launch Camoufox

License: permissive · Maintenance: active · Downloads: 948.4K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 948.4K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

browser fingerprint injection, playwright firefox wrapper, anti-detection browser automation, device characteristic spoofing, headless firefox with fingerprints, web scraping with realistic headers, proxy-aware browser launcher, anti-detection, browser-fingerprinting, web-scraping

[View on SkillFed](https://skillfed.io/packages/camoufox) · [View on PyPI](https://pypi.org/project/camoufox/)