wa_llm
by ilanbenb
A WhatsApp bot that can participate in group conversations, powered by AI. The bot monitors group messages and responds when mentioned.
142stars
52forks
Python
Added 12/27/2025
MCP Serverscommunitiesmcpmcp-serverwhatsappwhatsapp-api
Installation
# Add to your Claude Code skills
git clone https://github.com/ilanbenb/wa_llm📱 WhatsApp Group Summary Bot
AI-powered WhatsApp bot that joins any group, tracks conversations, and generates intelligent summaries.
Features
- 🤖 Automated group chat responses (when mentioned)
- 📝 Smart LLM-based conversation summaries
- 📚 Knowledge base integration for context-aware answers
- 📂 Persistent message history with PostgreSQL +
pgvector - 🔗 Support for multiple message types (text, media, links)
- 👥 Group management & customizable settings
- 🔕 Opt-out feature: Users can opt-out of being tagged in summaries/answers via DM.
- ⚡ REST API with Swagger docs (
localhost:8000/docs)
🐳 Docker Compose Configurations
This project includes multiple Docker Compose files for different environments:
| File | Purpose | Usage |
| ------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------ |
| docker-compose.yml | Default/Development. Builds the application from source code. | docker compose up -d |
| docker-compose.prod.yml | Production. Uses pre-built images from GHCR. Recommended for deployment. | |
| | . For running the app on host while services run in Docker. | |
| | . Contains shared service definitions. | ❌ |