camouchat-browser 0.7.0

Plugin for CamouChat providing anti-detection browser management via Camoufox and Playwright.

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.

Installation

Add to your project using uv:

uv add camouchat-browser

Quick Start

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

# 1. Setup Configuration
config = BrowserConfig.from_dict({
    "platform": Platform.WHATSAPP,
    "headless": False,
    "locale": "en-US",
    "fingerprint_obj": BrowserForge()
})

# 2. Manage Profiles
pm = ProfileManager(platform=Platform.WHATSAPP)
profile = pm.get_profile(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

• Browser Configuration - Finetuning stealth settings.
• Browser Engine - Deep dive into Camoufox integration.
• Profile Management - Managing sandboxes and encryption.
• Fingerprinting - hardware-level spoofing logic.

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.