📱 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.	docker compose -f docker-compose.prod.yml up -d
docker-compose.local-run.yml	Local Execution. For running the app on host while services run in Docker.	docker compose -f docker-compose.local-run.yml up -d
docker-compose.base.yml	Base Configuration. Contains shared service definitions.	❌ Do not use directly

---

📋 Prerequisites

• 🐳 Docker and Docker Compose
• 🐍 Python 3.13+
• 🗄️ PostgreSQL with pgvector extension
• 🔑 Voyage AI API key
• 📲 WhatsApp account for the bot

Quick Start

1. Clone & Configure

git clone https://github.com/YOUR_USER/wa_llm.git cd wa_llm

2. Create .env file

• Copy .env.example to .env and fill in required values.

cp .env.example .env

Environment Variables