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.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.
Installation
Requirements
- Python 3.11 or higher
- Recommended: Use a virtual environment
Setup (Recommended)
Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
Install using uv (recommended)
uv add camouchat-core
Install using pip
pip install camouchat-core
Documentation
- Core SDK Docs — Contracts, storage, logging.
- Browser Plugin — Stealth browser engine.
- CHANGELOG — Full release history.
🤖 For AI Agents
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.
Supported Social Platforms :
- whatsapp : WhatsApp Plugin — Full automation plugin.
⚖️ Security & Ethics
CamouChat's strict policy regarding acceptable automation, anti-spam, and stealth disclaimers can be found in our central ecosystem hub:
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
1 maintainer
Metadata
1 maintainer
Release files for camouchat-core 0.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| camouchat_core-0.7.3.tar.gz | 13.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| camouchat_core-0.7.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.5 kB
Release files / camouchat_core-0.7.3.tar.gz
| Download URL | camouchat_core-0.7.3.tar.gz |
|---|---|
| Size | 13.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3afaa2fdfdab74724da18fc76cd855ecbad8ce5a481ca3f9ea01657ae42232d
|
|
BLAKE2b-256 checksum How to use checksums |
104c70dae8d431924e04d60bcc632ff0f43d46c0c69de6a9a1c3e99732508804
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / camouchat_core-0.7.3-py3-none-any.whl
| Download URL | camouchat_core-0.7.3-py3-none-any.whl |
|---|---|
| Size | 19.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a4397ae21472355fc52429fc083a16a699c8deca018470495fd1a476ed6eef04
|
|
BLAKE2b-256 checksum How to use checksums |
9ba15bf8cdfc5aaa3b568ad1f73f09f2a122f9f52315f40a5b889dc9d524fb35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
