Skip to main content

CamouChat: Anti-detection WhatsApp automation SDK with end-to-end encrypted storage, async SQLite/PostgreSQL, per-profile sandboxing, and human-like browser behaviour

Project description

⚠ DEPRECATED

tweakio-sdk is now deprecated and no longer maintained.

The project has officially moved to CamouChat.

Please migrate by running:

pip install camouchat
CamouChat Text


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

BITS-Rohit
Ivy
xinss-plus
Xinss
Adez017
aditya singh rathore
AnkithaMadhyastha
AnkithaMadhyastha
dharapandya85
Dhara Pandya
Vaishnav-Sabari-Girish
Vaishnav-sabari-girish
OVERDOZZZE
Saparbekov Nurdan
magic-peach
Akanksha Trehun

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tweakio_sdk-0.6.1.tar.gz (53.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tweakio_sdk-0.6.1-py3-none-any.whl (69.4 kB view details)

Uploaded Python 3

File details

Details for the file tweakio_sdk-0.6.1.tar.gz.

File metadata

  • Download URL: tweakio_sdk-0.6.1.tar.gz
  • Upload date:
  • Size: 53.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for tweakio_sdk-0.6.1.tar.gz
Algorithm Hash digest
SHA256 8136e44d85dba02e36bbd98319fa0d62d2330cf744238847a0dce7f6a968612e
MD5 d5a5a93a9a759ddf3e2f8d56e0a52575
BLAKE2b-256 5fc7cc9ee47f30149aa5389c23f18787f7ca64c478f88b2cb8a55d00a463985c

See more details on using hashes here.

File details

Details for the file tweakio_sdk-0.6.1-py3-none-any.whl.

File metadata

  • Download URL: tweakio_sdk-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 69.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for tweakio_sdk-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0a87ed1a04dc4b80c6fa5d1536db7273023ee83f425c1a02629d580ab530e65e
MD5 2dab50a8a09b7767aade069d0b7f8bed
BLAKE2b-256 cc74f50b230280db90a3bcb7160727c0817d9441f5cd09d4de05c03d06da2dcd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page