tweakio-sdk 0.1.3

High-performance, anti-detection WhatsApp automation SDK. Features async SQLite storage, rate limiting, and human-like interaction loops.

🚀 Tweakio-Whatsapp Library

The Developer-First WhatsApp Automation Toolkit
Built on Playwright, Camoufox & BrowserForge for maximum reliability and undetectability.

---

This repository provides a powerful, modular toolkit for WhatsApp automation. Unlike standard libraries, Tweakio is designed for modern, human-like interactions, ensuring safety and longevity for your automation pipelines.

Whether you are building a smart chatbot, an automated alert system, or a workflow for your business, Tweakio gives you the granular control you need.

---

✨ Features

• 🛡️ Anti-Detection First: Built on Playwright + Camoufox to mimic real browser fingerprints.
• 🧩 Modular Architecture: Components like ChatRoller, MessageProcessor, and BrowserManager work together or standalone.
• 🤖 Human-Like Behavior: Simulates natural typing speeds, mouse movements, and pauses.
• ⚡ High-Performance Storage: Async Queue-based SQLite integration for blocking-free message persistence.
• ⚖️ Intelligent Rate Limiting: Built-in protection against number bans via smart request throttling.
• 📡 Dynamic Selectors: Smart element detection that adapts to WhatsApp Web UI changes.

---

📦 Installation

pip install tweakio-SDK

Note: Requires Python 3.8+

Currently we are supporting Whatsapp Web but in future we will add more support to different platforms

⚡ Quick Start

Here is a complete, working example using the latest MessageProcessor API:

import asyncio
from tweakio_whatsapp import BrowserManager, WhatsappLogin, MessageProcessor, ChatLoader


async def main():
    # 1️⃣ Initialize Browser with Anti-Detect capabilities
    browser_manager = BrowserManager(headless=False)
    page = await browser_manager.getPage()

    # 2️⃣ Perform Login (Scan QR Code if needed)
    wp_login = WhatsappLogin(page=page)
    await wp_login.login()

    # 3️⃣ Start Message Processor & Chat Loader
    # MessageProcessor handles rate limiting and async storage automatically
    processor = MessageProcessor(page=page)
    chat_loader = ChatLoader(page=page)

    print("🚀 Listening for messages...")

    # 4️⃣ Iterate through chats and process messages
    async for chat, name in chat_loader.ChatRoller(cycle=1, MaxChat=3):
        print(f"📂 Checking Chat: {name}")

        messages = await processor.MessageFetcher(chat=chat)
        for msg in messages:
            print(f"   📩 New Message: {msg.text} (Direction: {msg.Direction})")


if __name__ == "__main__":
    asyncio.run(main())

💡 Pro Tip: Check test/play.py in the repository for more advanced examples!

---

🛠️ Modules Overview

Module	Description
BrowserManager	Handles browser creation, fingerprinting, and proxy management.
WhastappLogin	Manages QR scanning, session saving, and login verification.
MessageProcessor	Fetches, traces, and filters messages with built-in rate limiting.
Storage	Async queue-powered SQLite wrapper for efficient persistence.
ChatRoller	Automates scrolling and loading old chats.

---

🤝 Contributing

We welcome contributions! If you have ideas for new features or bug fixes:

1. Fork the repo 🍴
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request 🚀

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

🛠️ Performance & Safety Note

Tweakio-SDK v0.1.2+ uses an Async SQL Writer. This means database operations never block your main automation loop, ensuring maximum responsiveness even during heavy message bursts.

---

Made with passion by the Tweakio Team