Sobre o projeto

Stefy-Agent é um assistente pessoal inteligente que opera via WhatsApp. Construído sobre o ai-agente-core, ele usa a Claude API para entender intenções em linguagem natural e decidir autonomamente quais ações tomar, sem menus ou comandos fixos.

A motivação do projeto foi centralizar o gerenciamento de tarefas, e-mails e lembretes em um único canal de comunicação familiar (WhatsApp), com uma IA que entende contexto e executa ações reais em sistemas externos.

O que ele faz

  • Recebe mensagens de linguagem natural pelo WhatsApp e decide autonomamente qual ação executar
  • Gerencia lembretes com agendamento via cron, avisando no horário certo sem intervenção manual
  • Integração com Gmail API para leitura, organização e resposta de e-mails por comando de voz
  • Gestão de tarefas persistida em PostgreSQL com rastreamento de status
  • Arquitetura tool-based: cada capacidade é uma ferramenta isolada que o LLM pode invocar
  • Servidor Fastify com logging estruturado via Pino para observabilidade em tempo real

Stack

TypeScript Node.js Fastify Claude API WhatsApp (Baileys) Gmail API PostgreSQL node-cron Pino