PyWacli¶

Real-time WhatsApp ingestion and monitoring, straight from your terminal.

PyWacli is a Python WhatsApp CLI built on Baileys, WebSockets, SQLite, and Rich. It captures messages, edits, reactions, statuses, and media in real time, syncs media to S3/R2/B2/local storage, and can run an AI-powered auto-reply bot — all from a single, friendly terminal menu.

Get started View on GitHub Read the blog

Why PyWacli?¶

Live Terminal Dashboard

A real-time Rich UI with a message feed and database statistics, refreshed on an interval — with Default, Dark, and Light themes.

Dashboard guide
Full Event Capture

Messages, edits, reactions, statuses, and media — captured via Baileys and normalized into clean events your Python code can consume.

Events reference
Media Syncing

Automatically sync images, videos, and documents to Amazon S3, Cloudflare R2, Backblaze B2, or the local filesystem — with per-type toggles.

Storage providers
AI Auto-Reply

Hand a conversation to an AI bot. Choose a provider (Ollama, OpenAI, Gemini, Claude, GLM) and a skill (sales, support, translator, clone…).

AI Automate guide
SQL Storage

SQLite by default, with support for online SQLite, PostgreSQL, and MySQL through SQLAlchemy. Seven tables track everything.

Database schema
Simple CLI

One numbered menu, or direct commands: dashboard, connect, send, automate, media, config, setup, init.

CLI reference

60-second tour¶

# 1. Install dependencies
pip install -r requirements.txt   # Python
pywacli init                      # Node.js (Baileys) deps

# 2. Configure everything interactively
pywacli setup

# 3. Connect WhatsApp (scan the QR), keep this terminal open
pywacli connect

# 4. In a second terminal — watch it live, send, or automate
pywacli dashboard
pywacli send
pywacli automate

New here?

Start with the Installation guide, then the Quickstart. It takes about five minutes to go from zero to a live WhatsApp feed in your terminal.

Built with :material-heart: by Mantiz · MIT Licensed