Seu assistente pessoal leve, proativo e brasileiro.
"Um assistente virtual projetado para rodar em hardware modesto (como um Raspberry Pi 3), democratizando o acesso à Inteligência Artificial Agêntica."
Baseado na Arquitetura da Restrição e no Conceito Diet, ele transforma limitações de hardware em eficiência, "vivendo" no seu servidor para monitorar, alertar e assistir, sem exigir supercomputadores.
📜 Leia nosso Manifesto Curupira para entender a filosofia por trás do código.
- 🚀 Início Rápido
- 🛠️ Tecnologias
- 🧠 Desenvolvimento de Skills
- ⚖️ Filosofia
- 📦 Instalação Completa
- 🤝 Como Contribuir
- 🗺️ Roadmap
- 🧠 Memória Persistente: Lembra do seu nome, suas preferências e contexto de conversas passadas.
- 🎭 Personalidade Dinâmica: Escolhe um "sobrenome" único para se diferenciar de outros Curupiras e mantém consistência na comunicação.
- 💓 Heartbeat & Proatividade: Sistema de agendamento interno (
JobQueue) que permite ao bot iniciar interações e monitorar o sistema sem dependências externas (cron). - ⏰ Lembretes Naturais: Peça "Me lembre de tirar o bolo em 20 min" e o Curupira entende, agenda e te avisa.
- 🌦️ Previsão do Tempo: Pergunte "Vai chover?" e ele verifica a previsão local (Open-Meteo) para você.
- 🔌 Multi-Provedor de IA: Suporte nativo para Groq (LLaMA 3 - default para velocidade) e Google Gemini (Flash - para janelas de contexto maiores).
- 🌡️ Monitoramento de Hardware: Pergunte "Como está o sistema?" para ver uso de CPU, RAM, Disco e Temperatura do Raspberry Pi em tempo real.
- 📰 RSS Reader: Peça "Quais são as notícias de hoje?" e o Curupira busca as últimas manchetes de feeds RSS/Atom configurados.
- 📅 Google Calendar: Integração completa com OAuth2 para listar, adicionar e cancelar eventos. Sincronização automática que transforma eventos em lembretes proativos.
- 🔍 Análise de Padrões: Detecta quais skills você usa com frequência e sugere automações proativamente — ex: "Você sempre me pergunta sobre o Botafogo. Quer alertas automáticos de jogos?"
- Python 3.10+
- python-telegram-bot (Async + JobQueue)
- SQLite + JSON (Sistema de Memória Lite)
- Groq API / Google GenAI
- Democratização: Funciona em hardware de baixo custo (1GB RAM).
- Eficiência "Diet": Processamento offboard, lógica local leve.
- Acessibilidade: Interface via Telegram, sem complexidade.
- Privacidade: Você controla quem fala com seu agente.
Veja mais em MANIFESTO.md
Se você já tem experiência com Python, siga estes passos:
- Clone e Acesse:
git clone https://github.com/felipefernandes/curupira.git && cd curupira - Ambiente:
python -m venv venv && source venv/bin/activate - Instale:
pip install -r requirements.txt - Configure: Copie o template de configuração e edite com seus tokens:
cp default.config.toml config.toml # Edite config.toml com suas chaves e preferênciasAlternativamente, crie um
.envbaseado no exemplo do Guia de Instalação. - Rode:
python bot.py
Se o bot apresentar problemas ou se você quiser validar sua instalação (ZRAM, FFmpeg, chaves de API, etc), execute o script de diagnóstico standalone:
python check_health.py📖 Instruções detalhadas? Veja o nosso Guia de Instalação e Setup.
- Python 3.10+ (Core)
- python-telegram-bot (Interface Async)
- SQLite + JSON (Memória Lite e Persistente)
- Groq / Google Gemini (Provedores de IA)
O Curupira é modular. Você pode estender as capacidades dele criando novas Skills.
- Democratização: Funciona em hardware de baixo custo (1GB RAM).
- Eficiência "Diet": Processamento offboard, lógica local leve.
- Acessibilidade: Interface via Telegram, sem complexidade.
- Privacidade: Você controla quem fala com seu agente.
Leia o MANIFESTO.md para a visão completa.
Este é um projeto Open Source e adoramos colaborações!
Para detalhes sobre o fluxo de trabalho obrigatório (GitFlow + Revisão pela 🧜♀️ Iara), consulte o arquivo CONTRIBUTING.md.
Distribuído sob a licença MIT. Veja LICENSE para mais informações.