W Agent v0.1.0
Your WhatsApp, with a brain. Self-hosted bridge that gives an AI agent continuous, searchable context over your chats — and lets it reply for you, safely.
Highlights
- Provider adapter: Baileys (default) and Meta Cloud API (
WHATSAPP_PROVIDER=meta) - Durable ingest → Postgres + pgvector hybrid search + rolling summaries
- Engagement engine, injection guard, approval outbox, send rate limits
- MCP (stdio + HTTP/SSE) for Claude Desktop and remote clients
- Dashboard: pairing QR, chats, approvals, health
- Ops: watchdog,
/healthz, backup/red-team scripts, Docker Compose + CI
Getting started
git clone https://github.com/Chessing234/w-agent.git
cd w-agent
cp .env.example .env # set OPENAI_API_KEY
docker compose up -d --build
pnpm install && pnpm migrate
docker compose logs -f app # scan QRFull notes: CHANGELOG.md
Security
See SECURITY.md for responsible disclosure. Baileys use carries WhatsApp ban risk — prefer a dedicated number; use Cloud API for business workloads.