Metadata-Version: 2.4
Name: camouchat
Version: 0.7.0
Summary: High-performance, stealth-aware WhatsApp automation SDK. One install for the entire CamouChat plugin ecosystem.
Keywords: whatsapp,whatsapp-automation,whatsapp-bot,whatsapp-web,whatsapp-api,whatsapp-api-alternative,wa-js,wppconnect,playwright,camoufox,anti-detection,anti-ban,fingerprinting,browser-automation,stealth,bypass,encrypted-storage,aes-256,e2e-encryption,async,sqlite,postgresql,multi-account,chat-bot,agents,automation-framework,web-automation,camouchat
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.14
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Requires-Dist: camouchat-core>=0.7.0
Requires-Dist: camouchat-browser>=0.7.0
Requires-Dist: camouchat-whatsapp>=0.7.1
Requires-Dist: camoufox[geoip]>=0.4.11
Maintainer: BITS-Rohit
Maintainer-email: BITS-Rohit <rohitguptaradheradhe123@gmail.com>
Requires-Python: >=3.10
Project-URL: Bug Tracker, https://github.com/CamouChat-Team/CamouChat/issues
Project-URL: Changelog, https://github.com/CamouChat-Team/CamouChat/releases
Project-URL: Documentation, https://github.com/CamouChat-Team/CamouChat#readme
Project-URL: Homepage, https://github.com/CamouChat-Team/CamouChat
Project-URL: Repository, https://github.com/CamouChat-Team/CamouChat
Description-Content-Type: text/markdown

<div align="center">
  <h1>🦊 CamouChat Ecosystem</h1>
  <p><b>The High-Performance, Stealth-Aware Automation Framework</b></p>
</div>

<p align= "center">
  <a href="https://github.com/CamouChat-Team/camouchat-core">
      <img src="https://img.shields.io/badge/Status-Active-brightgreen.svg" alt="Status" />
  </a>
  <a href="https://pypi.org/project/camouchat/">
      <img src="https://img.shields.io/pypi/v/camouchat?label=camouchat-core&color=blue" />
  </a>
  <a href="https://opensource.org/licenses/MIT">
      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" />
  </a>
</p>

---

## Introduction to CamouChat

CamouChat is an advanced, strictly decoupled ecosystem designed for researchers and developers to build high-performance Web Automation agents safely. Initially built for highly secured chat applications like WhatsApp, it utilizes **Camoufox** to achieve industry-leading anti-detection capabilities.

It provides a standardized framework incorporating **end-to-end encrypted local storage**, **isolated sandbox profiling**, and **humanized interaction schemas** — completely removing the fragility associated with raw DOM scraping or unsecured automation libraries.

This repository serves as the central hub and entry point for the entire CamouChat plugin ecosystem.

> [!IMPORTANT]
> **v0.7.0 Update** — CamouChat is now a decoupled plugin ecosystem. The `camouchat` package on PyPI is the umbrella entry point. WhatsApp automation lives in **[`camouchat-whatsapp`](https://pypi.org/project/camouchat-whatsapp/)** — install that for full functionality. Existing users of the old monolithic `camouchat` package: no API changes, just point your install to `camouchat-whatsapp` going forward.

---

## Why CamouChat?

Before building CamouChat, maintaining reliable web automation pipelines across restricted platforms presented major challenges:

* **Fragile Automation**: Hardcoded CSS selectors break constantly on platform UI updates. 
* **Bot Identification**: Basic Puppeteer/Playwright instances trigger modern captchas and integrity scanners immediately.
* **Account Risk**: Lack of isolated cookie/cache containment leads to swift cross-account detection and IP shadowbans.
* **Architecture Bloat**: Existing libraries are typically monolithic, tightly coupled wrappers that force you into a single way of handling tasks.

**CamouChat solves this by establishing a protocol-driven SDK, routing actions through secure internal APIs (injecting JS bridges without triggering scanners) and standardizing storage schemas globally.**

---

## 🧩 The Plugin Ecosystem

Starting from `v0.7.0`, CamouChat has been strictly decoupled into specialized plugins. You install exactly what you need.

### 1. [camouchat-core](https://github.com/CamouChat-Team/camouchat-core) — The Foundation &nbsp; [![PyPI](https://img.shields.io/pypi/v/camouchat-core?color=blue)](https://pypi.org/project/camouchat-core/)
The required central SDK interface. Provides the foundational structures:
- Standardized `typing.Protocol` contracts for interoperability.
- Asynchronous Logging Engine (`concurrent-log-handler`).
- Strict AES-GCM-256 Storage & Metadata interfaces.

### 2. [camouchat-browser](https://github.com/CamouChat-Team/camouchat-browser) — The Engine &nbsp; [![PyPI](https://img.shields.io/pypi/v/camouchat-browser?color=blue)](https://pypi.org/project/camouchat-browser/)
The stealth browser layer built for Web interactions.
- Embeds [Camoufox](https://camoufox.com/) for deep connection and JS fingerprint spoofing.
- Generates dynamic hardware profiles via `browserforge`.
- Automated OS-aware profile sandboxing and encryption.

### 3. [camouchat-whatsapp](https://github.com/CamouChat-Team/camouchat-whatsapp) — The Implementation &nbsp; [![PyPI](https://img.shields.io/pypi/v/camouchat-whatsapp?color=blue)](https://pypi.org/project/camouchat-whatsapp/)
A platform-specific plugin leveraging the Core and Browser ecosystems to automate WhatsApp Web perfectly.
- Complete internal API bridge using [wa-js](https://github.com/wppconnect-team/wa-js) natively.
- Zero DOM Scraping — Event-driven interaction.
- Support for complex media fetching, stealth timing, and fully-typed async architectures.

---

## 🚀 Quick Install

> 📦 **Full WhatsApp plugin → [`camouchat-whatsapp` on PyPI](https://pypi.org/project/camouchat-whatsapp/)** — detailed docs, changelog, and API reference live there.

To build a full, automated WhatsApp agent utilizing the Camoufox engine, install the ecosystem via `uv` or `pip`:

### Using `uv` (Recommended)
```bash
uv add camouchat-whatsapp "camoufox[geoip]"
uv run python -m camoufox fetch
```

### Using `pip`
```bash
pip install camouchat-whatsapp "camoufox[geoip]"
python -m camoufox fetch
```

> [!WARNING]
> Running `camoufox fetch` is a **mandatory** one-time step that downloads the compiled Firefox binaries. Normal package managers cannot perform this hook automatically.

---

## 📚 Global Documentation

* 📖 **Core Architecture**: [Link](https://github.com/CamouChat-Team/camouchat-core/tree/main/docs)
* 📖 **Browser Configurations**: [Link](https://github.com/CamouChat-Team/camouchat-browser/tree/main/docs)
* 📖 **WhatsApp API & Models**: [Link](https://github.com/CamouChat-Team/camouchat-whatsapp/tree/main/docs)

---

## ⚖️ Security & Ethics

CamouChat provides powerful browser automation and stealth infrastructure. With this power comes the responsibility to use it ethically and in compliance with the rules of the platforms you interact with. 

Please read our mandatory **[Security & Ethics Guidelines](https://github.com/CamouChat-Team/CamouChat/blob/main/SECURITY.md)** regarding acceptable use, anti-spam policies, and anti-detection disclaimers before utilizing the ecosystem.

---

## 🤝 Community & Support

* [Code of Conduct](https://github.com/CamouChat-Team/camouchat-core/blob/main/CODE_OF_CONDUCT.md)
* [Changelog / Release Notes](https://github.com/CamouChat-Team/camouchat-core/releases)
* Submitting issues: Please file platform-specific issues directly in the corresponding plugin repository (`camouchat-whatsapp`, etc.).

---

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