Skip to content

Introducing PyWacli

Meet PyWacli — a Python WhatsApp CLI that captures your WhatsApp activity in real time and puts it in your terminal: a live message feed, full event history in a SQL database, media synced to the cloud, and an AI bot that can reply for you.

Why we built it

WhatsApp is where a huge amount of conversation happens, but it's a black box from a developer's point of view. We wanted something that:

  • Captures everything — messages, edits, reactions, statuses, and media — in real time.
  • Stores it in a real database so it's queryable, not locked in an app.
  • Lives in the terminal, the place developers already are.
  • Can act, not just observe — send messages and even auto-reply with AI.

How it works

Under the hood, PyWacli bridges three worlds:

WhatsApp (mobile)  →  Node.js / Baileys  →  Python  →  SQL + object storage + Rich UI

A single connect session owns the live WhatsApp socket, streams normalized events to Python, and hosts a tiny local command server so other commands can send through the same connection. Read the full architecture overview for the details.

What you can do today

  • Live dashboard — watch messages and stats update in real time.
  • Media syncing — push images, videos, and documents to S3, R2, B2, or local disk.
  • Send messages — interactively or with a one-shot command.
  • AI auto-reply — pick a skill and a provider (Ollama, OpenAI, Gemini, Claude, GLM) and let the bot handle a chat.

Get started

pip install pywacli
pywacli init
pywacli setup
pywacli connect

That's it — scan the QR and you're live. The Quickstart walks through every step.

We're just getting started. Star the project on GitHub and watch this blog for what's next.