camouchat 0.7.0

High-performance, stealth-aware WhatsApp automation SDK. One install for the entire CamouChat plugin ecosystem.

🦊 CamouChat Ecosystem

The High-Performance, Stealth-Aware Automation Framework

---

Introduction to CamouChat

CamouChat is an advanced, strictly decoupled ecosystem designed for researchers and developers to build high-performance Web Automation agents safely. Initially built for highly secured chat applications like WhatsApp, it utilizes Camoufox to achieve industry-leading anti-detection capabilities.

It provides a standardized framework incorporating end-to-end encrypted local storage, isolated sandbox profiling, and humanized interaction schemas — completely removing the fragility associated with raw DOM scraping or unsecured automation libraries.

This repository serves as the central hub and entry point for the entire CamouChat plugin ecosystem.

[!IMPORTANT] v0.7.0 Update — CamouChat is now a decoupled plugin ecosystem. The camouchat package on PyPI is the umbrella entry point. WhatsApp automation lives in camouchat-whatsapp — install that for full functionality. Existing users of the old monolithic camouchat package: no API changes, just point your install to camouchat-whatsapp going forward.

---

Why CamouChat?

Before building CamouChat, maintaining reliable web automation pipelines across restricted platforms presented major challenges:

• Fragile Automation: Hardcoded CSS selectors break constantly on platform UI updates.
• Bot Identification: Basic Puppeteer/Playwright instances trigger modern captchas and integrity scanners immediately.
• Account Risk: Lack of isolated cookie/cache containment leads to swift cross-account detection and IP shadowbans.
• Architecture Bloat: Existing libraries are typically monolithic, tightly coupled wrappers that force you into a single way of handling tasks.

CamouChat solves this by establishing a protocol-driven SDK, routing actions through secure internal APIs (injecting JS bridges without triggering scanners) and standardizing storage schemas globally.

---

🧩 The Plugin Ecosystem

Starting from v0.7.0, CamouChat has been strictly decoupled into specialized plugins. You install exactly what you need.

1. camouchat-core — The Foundation  

The required central SDK interface. Provides the foundational structures:

• Standardized typing.Protocol contracts for interoperability.
• Asynchronous Logging Engine (concurrent-log-handler).
• Strict AES-GCM-256 Storage & Metadata interfaces.

2. camouchat-browser — The Engine  

The stealth browser layer built for Web interactions.

• Embeds Camoufox for deep connection and JS fingerprint spoofing.
• Generates dynamic hardware profiles via browserforge.
• Automated OS-aware profile sandboxing and encryption.

3. camouchat-whatsapp — The Implementation  

A platform-specific plugin leveraging the Core and Browser ecosystems to automate WhatsApp Web perfectly.

• Complete internal API bridge using wa-js natively.
• Zero DOM Scraping — Event-driven interaction.
• Support for complex media fetching, stealth timing, and fully-typed async architectures.

---

🚀 Quick Install

📦 Full WhatsApp plugin → camouchat-whatsapp on PyPI — detailed docs, changelog, and API reference live there.

To build a full, automated WhatsApp agent utilizing the Camoufox engine, install the ecosystem via uv or pip:

Using uv (Recommended)

uv add camouchat-whatsapp "camoufox[geoip]"
uv run python -m camoufox fetch

Using pip

pip install camouchat-whatsapp "camoufox[geoip]"
python -m camoufox fetch

[!WARNING] Running camoufox fetch is a mandatory one-time step that downloads the compiled Firefox binaries. Normal package managers cannot perform this hook automatically.

---

📚 Global Documentation

• 📖 Core Architecture: Link
• 📖 Browser Configurations: Link
• 📖 WhatsApp API & Models: Link

---

⚖️ Security & Ethics

CamouChat provides powerful browser automation and stealth infrastructure. With this power comes the responsibility to use it ethically and in compliance with the rules of the platforms you interact with.

Please read our mandatory Security & Ethics Guidelines regarding acceptable use, anti-spam policies, and anti-detection disclaimers before utilizing the ecosystem.

---

🤝 Community & Support

• Code of Conduct
• Changelog / Release Notes
• Submitting issues: Please file platform-specific issues directly in the corresponding plugin repository (camouchat-whatsapp, etc.).

---

Built with ❤️ by BITS-Rohit and the CamouChat community