camouchat-whatsapp 0.7.0

High-stealth WhatsApp Web automation plugin for CamouChat. WA-JS powered, async-first, multi-account with AES-256 encrypted storage.

CamouChat WhatsApp 🟢

High-stealth WhatsApp automation plugin for the CamouChat ecosystem. Built on top of camouchat-browser and WA-JS, providing a structured, API-driven pipeline for multi-account automation with end-to-end encrypted message storage.

[!IMPORTANT] This package requires a one-time binary fetch for the underlying Camoufox browser engine after installation. See Setup below.

Key Features

• WA-JS Integration: Uses the internal WhatsApp Web API via wa-js — not fragile DOM selectors.
• Multi-Account Isolation: Each account runs in a sandboxed profile with isolated cookies, storage, and fingerprints.
• E2E Encryption: All stored messages are encrypted at rest using AES-256-GCM.
• Async-First: Fully asyncio-native for high-throughput multi-session workloads.
• Humanized Behavior: Mouse movements, typing cadence, and delays mimic organic user behavior.
• Rate Limiting: Built-in configurable rate-limit support to prevent account bans.

Installation

Using uv (Recommended)

uv add camouchat-whatsapp "camoufox[geoip]"

Using pip

pip install camouchat-whatsapp "camoufox[geoip]"

Setup

[!WARNING]
uv sync / pip install alone are not enough. You must fetch the Camoufox browser binary separately.

With uv

uv run python -m camoufox fetch

With pip

python -m camoufox fetch

This downloads the latest hardened Firefox binary used internally by Camoufox.

Quick Start

import asyncio
from camouchat_browser import BrowserConfig, BrowserForge, ProfileManager
from camouchat_whatsapp import WhatsAppBot
from camouchat_core import Platform

async def main():
    pm = ProfileManager()
    profile = pm.create_profile(Platform.WHATSAPP, "my_account")

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

    bot = WhatsAppBot(config=config, profile=profile)
    await bot.start()

asyncio.run(main())

Anti-Ban Best Practices

• Use residential proxies and enable GeoIP matching.
• Run only one visible browser (others auto-switch to headless).
• Respect rate limits — avoid burst-sending messages.
• Use test accounts before deploying on real numbers.

Documentation

• WA-JS Integration
• API Models & Managers
• Controllers (Login, Interaction, Media)
• Storage & Filtering
• Core SDK
• Browser Plugin

⚖️ Security & Ethics

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

👉 SECURITY.md

---

Acknowledgements & Third-Party Code

CamouChat WhatsApp uses portions of the wa-js library developed by the WPPConnect Team.

wa-js provides the internal WhatsApp Web JavaScript bridge that powers reliable, selector-free automation. It is distributed under the Apache License 2.0.

See the NOTICE file for full compliance details.

License

MIT License. See LICENSE for details.