Skip to main content

CamouChat Browser 🦊

A high-performance, stealth-oriented browser orchestration layer designed for the CamouChat ecosystem. Built on top of Camoufox, it provides advanced anti-detection capabilities, hardware-level fingerprint spoofing, and robust session management.

Key Features

  • Advanced Stealth: Powered by Camoufox for industry-leading anti-bot bypass.
  • Fingerprint Spoofing: Deep integration with browserforge for authentic hardware and software headers.
  • Session Isolation: Automated profile management with persistent storage for cookies and local data.
  • GeoIP & Proxy Ready: Built-in support for residential proxies and automated GeoIP matching.
  • Humanized Interaction: Smooth mouse movements and typing patterns to maintain high stealth scores.
  • Async-First Architecture: All blocking I/O is wrapped in asyncio.to_thread — zero event-loop blocking.
  • Python 3.11+: Compatible with Python 3.11, 3.12, 3.13, and 3.14.

Installation

Add to your project using uv:

uv add camouchat-browser

Or with pip:

pip install camouchat-browser

After installing, fetch the Camoufox browser binary:

camoufox fetch

Quick Start

from camouchat_browser import BrowserConfig, CamoufoxBrowser, ProfileManager
from camouchat_core import Platform

# 1. Setup Configuration
config = BrowserConfig.from_dict({
    "platform": Platform.WHATSAPP,
    "headless": False,
    "locale": "en-US",
    # fingerprint=None → BrowserForge auto-generates one
})

# 2. Manage Profiles
pm = ProfileManager(platform=Platform.WHATSAPP)
profile = pm.get_profile(platform=Platform.WHATSAPP, profile_id="stealth_user_1")

# 3. Launch Browser
browser = CamoufoxBrowser(config=config, profile=profile)
page = await browser.get_page()

await page.goto("https://check.camoufox.com")

Documentation

Roadmap

  • 🐳 Docker Containerization: Full headless Docker image with Xvfb, Camoufox binaries, and proxy-routing pre-configured out of the box (Targeting v0.8.0).

⚖️ Security & Ethics

CamouChat's strict policy regarding acceptable automation, anti-spam, and stealth disclaimers can be found in our central ecosystem hub:

👉 SECURITY.md

License

MIT License. See LICENSE for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

camouchat_browser-0.7.1.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

camouchat_browser-0.7.1-py3-none-any.whl (19.1 kB view details)

Uploaded Python 3

File details

Details for the file camouchat_browser-0.7.1.tar.gz.

File metadata

  • Download URL: camouchat_browser-0.7.1.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for camouchat_browser-0.7.1.tar.gz
Algorithm Hash digest
SHA256 e69b7db0d704b30a3e407a39020023c0a8fd729413efa734fc3d5ab415fc047f
MD5 421199ceef853b6029d18487824c234a
BLAKE2b-256 126ba937fbe7f53056ddf0984b0b1bdfe5a228c93a2bc171036e71cf76cc86bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for camouchat_browser-0.7.1.tar.gz:

Publisher: publish.yml on CamouChat-Team/camouchat-browser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file camouchat_browser-0.7.1-py3-none-any.whl.

File metadata

File hashes

Hashes for camouchat_browser-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a7b67818d627dc9b1322ec444a641c5513bd4643d59feacda6de003c39c77a76
MD5 427a736bcae9b2f0a8fbf7cf3bca1a39
BLAKE2b-256 649c5b95a864efac460d6b10a40abcffbc0d259a747c27c56a5cd142f3934072

See more details on using hashes here.

Provenance

The following attestation bundles were made for camouchat_browser-0.7.1-py3-none-any.whl:

Publisher: publish.yml on CamouChat-Team/camouchat-browser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.7.1 This release

2 files

0.7.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page