About this project

FamilyBot is a personal AI assistant designed for family coordination via WhatsApp. It monitors specified group chats (such as school or community groups), uses the Claude LLM (Anthropic) to extract actionable events and notices, and automatically syncs this information to Google Calendars. Key features include: - WhatsApp Integration: Built with Baileys as a native WebSocket client, removing the need for a headless browser. - Calendar Syncing: Read/write capabilities for Google Calendar with a 4-stage deduplication gate to prevent duplicate entries. - Coordination Hub: A triage engine that batches notices and posts them to a designated 'master' family group, including a daily morning digest. - Local Data Management: Uses SQLite for storing messages, notices, and events, with support for S3 backups. - Customization: Supports family member seeding for name resolution and configurable prompt templates for localization. The system is designed to run as a single process on a small Linux VPS and includes a voice server for outbound messaging.