LembreMe
Assistente pessoal que roda inteiro no WhatsApp: finanças, tarefas, lembretes, metas e rotinas em linguagem natural
Autor principal, arquitetura e desenvolvimento
Repositório privado
Sobre o projeto
LembreMe é um assistente pessoal que opera inteiramente pelo WhatsApp. A pessoa escreve, manda áudio ou fotografa um comprovante, e o agente interpreta, registra e devolve o que precisa: gastos e receitas (inclusive fixos e parcelados), tarefas, lembretes, metas financeiras e pessoais, notas e buscas de restaurantes por GPS ou cidade. O núcleo é um agente ReAct em Python com LangChain, com ferramentas separadas por domínio e acesso a dados isolado por Repository Pattern. Um scheduler independente varre lembretes e prazos a cada 60 segundos e dispara notificações por prioridade; no plano Ultra, tarefas críticas não concluídas viram ligação telefônica automática pela API de voz da Vonage. O produto amadureceu para SaaS com planos Free, Premium e Ultra e limites por recurso. Entre as frentes mais recentes estão as rotinas proativas, que detectam padrões como picos em uma categoria de gasto e agem sem esperar comando, e o envio de mensagens e agendamentos a terceiros, construído com opt-in explícito, allowlist e teto anti-ban.
Como funciona
O gateway em Node.js com whatsapp-web.js recebe a mensagem e normaliza a entrada: áudio é transcrito por Whisper ou Google, imagem passa por OCR com Tesseract, e o texto resultante segue por HTTP para o agente Python. O agente FastAPI roda o loop ReAct com LangChain sobre GPT-4o-mini, com Gemini 1.5 Flash como alternativa, escolhe as ferramentas do domínio certo (finanças, tarefas, lembretes, metas, notas, restaurantes) e persiste tudo no Supabase, com Redis guardando cache, TTL e o estado compartilhado entre os workers do Gunicorn. Em paralelo, o scheduler com APScheduler verifica lembretes e tarefas próximas do prazo, e os relatórios financeiros semanais são gerados automaticamente com pandas e matplotlib. As buscas de viagem usam scrapers próprios em Playwright e Camoufox sobre Airbnb, Google Hotels, Google Flights e Kayak, executados em paralelo.
Arquitetura
- 01
Gateway Node.js com whatsapp-web.js: canal, transcrição de áudio e OCR de imagens
- 02
Agente Python FastAPI: loop ReAct com LangChain e ferramentas por domínio
- 03
Repository Pattern: acesso a dados isolado da lógica do agente
- 04
Scheduler com APScheduler: lembretes, prazos e notificações por prioridade
- 05
Redis: cache, TTL e estado compartilhado entre workers Gunicorn
- 06
Scrapers Playwright e Camoufox: buscas paralelas de voos e hospedagem
- 07
Vonage Voice: ligações automáticas para tarefas críticas no plano Ultra
- 08
Supabase PostgreSQL e Docker Compose com quatro containers em AWS EC2
Funcionalidades
- Assistente completo dentro do WhatsApp, por texto, áudio ou foto
- Finanças com gastos fixos, parcelados e relatório semanal automático
- Tarefas e lembretes com scheduler contínuo e notificação por prioridade
- Metas financeiras e pessoais com progresso e conclusão automática
- Rotinas proativas que reagem a padrões de gasto sem esperar comando
- Busca de voos e hospedagem por scraping paralelo
- Ligação automática por voz para tarefas críticas no plano Ultra
- Mensagens a terceiros com opt-in, allowlist e teto anti-ban
- Planos Free, Premium e Ultra com limites por recurso
Tecnologias
- Backend
- Python · FastAPI · Node.js · whatsapp-web.js
- AI/ML
- LangChain · GPT-4o-mini · Gemini 1.5 Flash · Whisper · Tesseract OCR
- Tools
- Playwright · Vonage Voice
- Database
- Supabase
- Infrastructure
- Redis · Docker · AWS EC2
- Data
- pandas