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.
- Interface-First Design: Pure
typing.Protocolcontracts 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.
- Python 3.11 or higher
- Recommended: Use a virtual environment
Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activateuv add camouchat-corepip install camouchat-core- Core SDK Docs — Contracts, storage, logging.
- Browser Plugin — Stealth browser engine.
- CHANGELOG — Full release history.
Are you an AI assistant helping to build or debug CamouChat?
👉 Read the Agents Guide (Agents.md) for a strict breakdown of core protocols, encryption flows, and architectural rules.
- whatsapp : WhatsApp Plugin — Full automation plugin.
CamouChat's strict policy regarding acceptable automation, anti-spam, and stealth disclaimers can be found in our central ecosystem hub:
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