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.
Before building CamouChat, several existing libraries were evaluated.
👉 Docs
- Fragile selector-based automation
- No proper multi-account isolation
- Weak or no anti-detection strategies
- Poor long-term maintenance
- No unified architecture
CamouChat is a developer-focused SDK, not just another wrapper.
Core priorities:
- Reliability over shortcuts
- Stealth-aware automation
- Extensible architecture
-
Anti-Detection Browser Layer Built on Camoufox
-
Dynamic Fingerprinting Uses BrowserForge
-
Multi-Profile Management
-
Secure Message Storage AES-GCM-256 encryption
-
Database Flexibility Powered by SQLAlchemy
-
Browser Sandboxing
-
Reliable Session Handling
-
Extensible Architecture
-
Rate Limiting Support
-
Humanized Interaction Layer
-
Local-First Privacy
- No telemetry
- No external transmission
- Cross-Platform
- Linux
- macOS
- Windows
Provide a unified, reliable automation SDK
Focus on reducing detection signals, not bypassing safeguards
🚀 CamouChat v0.6 is officialy out on PyPI
uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install camouchat "camoufox[geoip]"
python -m camoufox fetchpython -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install camouchat "camoufox[geoip]"
python -m camoufox fetchExplore the following resources for detailed guides, architecture overviews, and community standards:
👉 Docs
- Selector stability improvements
- WhatsApp reliability
- Tests ≥80%
- Media saving
- WebUI hardening
- Tests ≥85%
- Additional WhatsApp features
- Stability improvements
- arattai integration
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
MIT — see LICENSE
- Research
- Personal automation
- Prototyping
- Learning
- ToS violations
- Spam
- Safeguard bypass attempts
- Harmful automation
- Use test accounts
- Respect limits
- Avoid unnatural behavior
- Secure credentials
- Local-first
- No external transmission
- No guarantee of undetectability
- Not responsible for misuse
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