camouchat-core 0.7.1

Anti-detection Account automation SDK. Standardized protocols, async-first, and encrypted storage.

CamouChat Core 🛠️

[!IMPORTANT] 🦊 This is the CamouChat Core SDK Repository. If you are looking for the main CamouChat project, full ecosystem documentation, or the WhatsApp plugin, please visit our Central Repository.

camouchat-core is the foundational SDK package providing strict async interfaces, AES-GCM-256 encrypted storage, and structured logging used by all CamouChat plugins.

Key Features

• Interface-First Design: Pure typing.Protocol contracts for seamless cross-plugin interoperability.
• Encrypted Storage Pipeline: Built-in AES-GCM-256 encryption bridging abstract messages to SQLAlchemy.
• Database Agnostic: Supports SQLite, PostgreSQL, and MySQL via SQLAlchemyStorage.
• Unified Metadata: Centralized enums (Platform, StorageType, MediaType) across the ecosystem.
• Concurrent Logging: Thread-safe, colored console & rotating file logging via LoggerFactory.
• Python 3.11+: Compatible with Python 3.11, 3.12, 3.13, and 3.14.

Installation

uv add camouchat-core

Or with pip:

pip install camouchat-core

If building a full WhatsApp agent (recommended):

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

[!WARNING] camoufox fetch downloads the hardened Firefox binary. This is a one-time setup step that cannot be automated via uv sync.

Documentation

• Core SDK Docs — Contracts, storage, logging.
• Browser Plugin — Stealth browser engine.
• WhatsApp Plugin — Full automation plugin.
• CHANGELOG — Full release history.

Roadmap

• 🌐 More Plugins: Signal, Telegram, and Instagram automation plugins planned.
• 🐳 Docker: Headless container with Xvfb and Camoufox pre-configured (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

Thanks to all the Contributors

Ivy

Bibhu Pradhan

Xinss

aditya singh rathore

AnkithaMadhyastha

Vaishnav-sabari-girish

Dhara Pandya

Saparbekov Nurdan

Akanksha Trehun

---

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