camouchat 0.6.1

CamouChat: Stealth-aware WhatsApp automation SDK. Standardized, async, and encrypted by design.

CamouChat is a high-performance, stealth-aware WhatsApp automation SDK. Designed for researchers and developers, it provides a standardized framework for building multi-account WhatsApp agents with end-to-end encrypted storage, per-profile sandboxing, and human-like browser behavior.

[!IMPORTANT] CamouChat v0.6 is officially released on PyPI. It is built on Playwright and Camoufox to provide industry-leading anti-detection capabilities.

---

Why CamouChat?

Before building CamouChat, several existing libraries were evaluated.

👉 Docs

Problem Summary

• Fragile selector-based automation
• No proper multi-account isolation
• Weak or no anti-detection strategies
• Poor long-term maintenance
• No unified architecture

---

Introducing CamouChat

CamouChat is a developer-focused SDK, not just another wrapper.

Core priorities:

• Reliability over shortcuts
• Stealth-aware automation
• Extensible architecture

---

Key Benefits

1. Anti-Detection Browser Layer Built on Camoufox

2. Dynamic Fingerprinting Uses BrowserForge

3. Multi-Profile Management

4. Secure Message Storage AES-GCM-256 encryption

5. Database Flexibility Powered by SQLAlchemy

6. Browser Sandboxing

7. Reliable Session Handling

8. Extensible Architecture

9. Rate Limiting Support

10. Humanized Interaction Layer

11. Local-First Privacy

• No telemetry
• No external transmission

1. Cross-Platform

• Linux
• macOS
• Windows

---

Philosophy

Provide a unified, reliable automation SDK

Focus on reducing detection signals, not bypassing safeguards

---

Installation

🚀 CamouChat v0.6 is officialy out on PyPI

Using uv (Recommended)

uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

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

Using pip

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

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

---

Quick Start

👉 Docs

---

Contributor Flow

1. Fork & Clone

git clone https://github.com/YOUR_USERNAME/CamouChat.git
cd CamouChat

2. Setup (uv)

uv sync
source .venv/bin/activate
python -m camoufox fetch

3. Verify

uv run pytest

4. Contribute

git checkout -b feat/your-feature
git commit -m "feat: your feature"
git push origin feat/your-feature

Open a PR.

---

Roadmap

v0.6 — Core Infrastructure

👉 Docs

v0.7

• Selector stability improvements
• WhatsApp reliability
• Tests ≥80%

v0.8

• Media saving
• WebUI hardening
• Tests ≥85%

v0.9

• Additional WhatsApp features
• Stability improvements

v1.0+

• arattai integration

---

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 & Usage

Acceptable Use

• Research
• Personal automation
• Prototyping
• Learning

Prohibited Use

• ToS violations
• Spam
• Safeguard bypass attempts
• Harmful automation

Best Practices

• Use test accounts
• Respect limits
• Avoid unnatural behavior
• Secure credentials

Data & Privacy

• Local-first
• No external transmission

Disclaimer

• No guarantee of undetectability
• Not responsible for misuse

---

Thanks to all the Contributors

Ivy

Xinss

aditya singh rathore

AnkithaMadhyastha

Dhara Pandya

Vaishnav-sabari-girish

Saparbekov Nurdan

Akanksha Trehun

---

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