camouchat-core 0.7.0

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

[!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. It provides the strict asynchronous interfaces (typing.Protocol), end-to-end encrypted storage engines (AES-GCM-256), and standardized logging systems used by all CamouChat plugins.

---

Core SDK Features

• Interface-First Design: Pure typing.Protocol contracts for seamless cross-plugin interoperability.
• Encrypted Storage Pipeline: Built-in 256-bit AES-GCM encryption bridging abstract messages to SQLAlchemy.
• Database Agnostic: SQLAlchemyStorage supports SQLite, PostgreSQL, and MySQL completely natively.
• Unified Metadata: Centralized enums (Platform, StorageType, MediaType) ensures consistency.
• Concurrent Logging: Automatic structured, thread-safe, colored console & rotating file logging via LoggerFactory.

---

Installation

uv add camouchat-core

(If you are building an agent, you likely want to install camouchat-whatsapp instead, which includes this core SDK automatically).

---

Installation

🚀 CamouChat v0.7 is on PyPI

Using uv (Recommended)

uv add camouchat-core

If installing the full stack with browser support:

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

Using pip

pip install camouchat-core

If installing with full browser + WhatsApp support:

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

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

---

Documentation & Community

• 👉 Core SDK Docs
• 👉 Browser Plugin
• 👉 Browser Plugin Docs
• 👉 WhatsApp Plugin
• 👉 WhatsApp Plugin Docs
• 👉 Code of Conduct
• 👉 Changelog

---

Roadmap

v0.7 — Plugin Architecture

• Decoupled core, browser, and whatsapp packages
• Centralized logging via LoggerFactory
• Standardized Protocol contracts

FAQ

Will I get banned? Rare but possible. Use rate limiting. Avoid spam. Soft bans (logout) are more common than number bans.

Can I use this for spam? No. Use at your own risk.

Why not WhatsApp Business API?

• Template restrictions
• Approval process
• Costs per message
• Limited flexibility

---

License

MIT — see LICENSE

---

⚖️ 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

Dhara Pandya

Vaishnav-sabari-girish

Saparbekov Nurdan

Akanksha Trehun

---

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