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.
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.
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.Protocolcontracts 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.
📦 Full WhatsApp plugin →
camouchat-whatsappon 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:
uv add camouchat-whatsapp "camoufox[geoip]"
uv run python -m camoufox fetchpip install camouchat-whatsapp "camoufox[geoip]"
python -m camoufox fetchWarning
Running camoufox fetch is a mandatory one-time step that downloads the compiled Firefox binaries. Normal package managers cannot perform this hook automatically.
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.
CamouChat follows a plugin-based and modular architecture. This repository acts as the umbrella repository for the complete CamouChat ecosystem.
Many components, integrations, automation modules, and internal systems are maintained across multiple repositories under the CamouChat-Team organization. These repositories are not isolated projects — together they form the complete CamouChat platform.
To avoid contributor confusion:
- Contributors should explore all repositories under the organization before starting development.
- Issues, plugins, integrations, and platform-specific implementations may exist in separate repositories.
- Some repositories may depend on or extend functionality from others.
- Contributors must always read the
CODE_OF_CONDUCT.mdand contribution guidelines of the target repository before contributing.
Contributors are expected to work in the actual implementation/plugin repositories where the real codebase exists.
Contribution Steps:
- Select and work on issues in the appropriate plugin/code repository.
- After the PR is successfully merged in the target repository, open a verification issue in the umbrella
CamouChatrepository. - Raise an Issue, the verification issue must contain:
- Contributor name
- Open source program/organization name (if applicable)
- Actual merged PR link
- Repository name
- Short summary of the contribution
- After admin verification: Contributor may create a PR in the umbrella repository updating the contribution tracking file (
PR_validation.md).
This workflow exists to maintain centralized contribution tracking, contributor visibility, and ecosystem-level coordination across the modular CamouChat architecture.
- Code of Conduct
- Contribution Guidelines
- 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