Metadata-Version: 2.4
Name: camouchat-core
Version: 0.7.2
Summary: Anti-detection Account automation SDK. Standardized protocols, async-first, and encrypted storage.
Keywords: whatsapp,whatsapp-automation,whatsapp-bot,whatsapp-web,whatsapp-api,whatsapp-api-alternative,playwright,camoufox,anti-detection,browser-automation,encrypted-storage,aes-256,e2e-encryption,async,sqlite,postgresql,camouchat,stealth,bypass,chat-bot,agents,automation-framework,web-automation
Author: BITS-Rohit
Author-email: BITS-Rohit <rohitguptaradheradhe123@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Requires-Dist: cryptography>=41.0.0
Requires-Dist: colorlog>=6.10.1
Requires-Dist: concurrent-log-handler>=0.9.29
Maintainer: BITS-Rohit
Maintainer-email: BITS-Rohit <rohitguptaradheradhe123@gmail.com>
Requires-Python: >=3.11
Project-URL: Bug Tracker, https://github.com/CamouChat-Team/camouchat-core/issues
Project-URL: Changelog, https://github.com/CamouChat-Team/camouchat-core/releases
Project-URL: Homepage, https://github.com/CamouChat-Team
Project-URL: Repository, https://github.com/CamouChat-Team/camouchat-core
Description-Content-Type: text/markdown

# 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](https://github.com/CamouChat-Team/CamouChat)**.

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

<p align="center">
  <a href="https://pypi.org/project/camouchat-core/">
      <img src="https://img.shields.io/badge/PyPI-camouchat--core-green" alt="PyPI" />
  </a>
  <a href="https://pepy.tech/projects/camouchat-core">
      <img src="https://static.pepy.tech/personalized-badge/camouchat-core?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads" />
  </a>
  <a href="https://opensource.org/licenses/MIT">
      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" />
  </a>
</p>

## 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

### Requirements

- Python **3.11 or higher**
- Recommended: Use a virtual environment

### Setup (Recommended)

Create and activate a virtual environment:

```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
```

### Install using `uv` (recommended)

```bash
uv add camouchat-core
```

### Install using `pip`

```bash
pip install camouchat-core
```

## Documentation

- [Core SDK Docs](https://github.com/CamouChat-Team/camouchat-core/tree/main/docs) — Contracts, storage, logging.
- [Browser Plugin](https://github.com/CamouChat-Team/camouchat-browser) — Stealth browser engine.
- [CHANGELOG](https://github.com/CamouChat-Team/camouchat-core/blob/main/CHANGELOG.md) — Full release history.

### Supported Social Platforms :

- whatsapp : [WhatsApp Plugin](https://github.com/CamouChat-Team/camouchat-whatsapp) — 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:

👉 **[SECURITY.md](https://github.com/CamouChat-Team/CamouChat/blob/main/SECURITY.md)**

## Thanks to all the Contributors

<!-- readme: contributors -start -->
<table>
	<tbody>
		<tr>
            <td align="center">
                <a href="https://github.com/BITS-Rohit">
                    <img src="https://avatars.githubusercontent.com/u/125949183?v=4" width="60;" alt="BITS-Rohit"/>
                    <br />
                    <sub><b>Ivy </b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/bibhupradhanofficial">
                    <img src="https://avatars.githubusercontent.com/u/77357902?v=4" width="60;" alt="bibhupradhanofficial"/>
                    <br />
                    <sub><b>Bibhu Pradhan</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/xinss-plus">
                    <img src="https://avatars.githubusercontent.com/u/260048405?v=4" width="60;" alt="xinss-plus"/>
                    <br />
                    <sub><b>Xinss</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/Adez017">
                    <img src="https://avatars.githubusercontent.com/u/142787780?v=4" width="60;" alt="Adez017"/>
                    <br />
                    <sub><b>aditya singh rathore</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/AnkithaMadhyastha">
                    <img src="https://avatars.githubusercontent.com/u/174180608?v=4" width="60;" alt="AnkithaMadhyastha"/>
                    <br />
                    <sub><b>AnkithaMadhyastha</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/Vaishnav-Sabari-Girish">
                    <img src="https://avatars.githubusercontent.com/u/88036970?v=4" width="60;" alt="Vaishnav-Sabari-Girish"/>
                    <br />
                    <sub><b>Vaishnav-sabari-girish</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/dharapandya85">
                    <img src="https://avatars.githubusercontent.com/u/109461918?v=4" width="60;" alt="dharapandya85"/>
                    <br />
                    <sub><b>Dhara Pandya </b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/OVERDOZZZE">
                    <img src="https://avatars.githubusercontent.com/u/113797353?v=4" width="60;" alt="OVERDOZZZE"/>
                    <br />
                    <sub><b>Saparbekov Nurdan</b></sub>
                </a>
            </td>
            <td align="center">
                <a href="https://github.com/magic-peach">
                    <img src="https://avatars.githubusercontent.com/u/146705736?v=4" width="60;" alt="magic-peach"/>
                    <br />
                    <sub><b>Akanksha Trehun</b></sub>
                </a>
            </td>
		</tr>
	<tbody>
</table>
<!-- readme: contributors -end -->

---

<p align="center">
  Built with ❤️ by BITS-Rohit and the CamouChat community
</p>
