프로젝트 소개

FamilyBot은 WhatsApp을 통한 가족 조정을 위해 설계된 개인용 AI 어시스턴트입니다. 지정된 그룹 채팅(학교 또는 커뮤니티 그룹 등)을 모니터링하고, Claude LLM(Anthropic)을 사용하여 실행 가능한 이벤트와 공지사항을 추출하며, 이 정보를 Google Calendars에 자동으로 동기화합니다. 주요 기능은 다음과 같습니다: - WhatsApp 통합: Baileys를 네이티브 WebSocket 클라이언트로 구축하여 헤드리스 브라우저의 필요성을 제거했습니다. - 캘린더 동기화: 중복 항목 방지를 위한 4단계 중복 제거 게이트를 갖춘 Google Calendar 읽기/쓰기 기능을 제공합니다. - 조정 허브: 공지사항을 일괄 처리하여 지정된 '마스터' 가족 그룹에 게시하는 트리아지 엔진과 일일 오전 요약 기능을 포함합니다. - 로컬 데이터 관리: 메시지, 공지 및 이벤트 저장을 위해 SQLite를 사용하며 S3 백업을 지원합니다. - 맞춤 설정: 이름 해석을 위한 가족 구성원 시딩과 현지화를 위한 구성 가능한 프롬프트 템플릿을 지원합니다. 이 시스템은 소형 Linux VPS에서 단일 프로세스로 실행되도록 설계되었으며, 외부 메시지 전송을 위한 음성 서버가 포함되어 있습니다.