🐴 Pegasus — Autonomous AI Agent System

Pegasus não é apenas um chatbot; é um organismo digital persistente projetado para o ecossistema Linux. Ele possui um cérebro neural com raciocínio forçado, memória semântica infinita e a capacidade de auto-diagnóstico e evolução através de "ciclos de sonho".

---

🚀 Visão Geral

O Pegasus foi arquitetado para ser um Universal Consumer do ecossistema Claude Code, permitindo que ele utilize regras (CLAUDE.md), habilidades e contextos de forma transparente, enquanto expande essas capacidades com uma estrutura de multi-modelos e proatividade real.

💎 Diferenciais de Engenharia

• Neural Cortex: Implementa o loop SEARCH → THINK → ACT → REMEMBER → RESPOND.
• Memória Híbrida: Busca vetorial via LanceDB combinada com Grafo de Conhecimento em SQLite.
• Proatividade Autonômica: Heartbeat constante e CronJobs que permitem ao agente executar tarefas enquanto você dorme.
• Sistema de "Sonhos": Processamento em background para consolidar memórias, remover duplicatas e gerar novos insights.
• Resiliência (Doctor System): Módulo de auto-cura que verifica 22 pontos críticos do sistema e repara falhas automaticamente.

---

🏗️ Arquitetura do Sistema

A estrutura é dividida em camadas modulares para garantir escalabilidade e fácil manutenção:

Camada	Função
Cortex	O motor de raciocínio que decide quando usar ferramentas ou buscar memórias.
Memory Store	Gerenciamento de vetores de alta dimensão e busca por similaridade.
Knowledge Graph	Banco de dados relacional que mapeia entidades e fatos complexos.
Brainstem	Controle de funções vitais: Heartbeats, Backups e Agendamentos.
Interfaces	Abstração para comunicação via Telegram Bot ou CLI Terminal.

Tip

Para um detalhamento técnico profundo, veja o Guia de Arquitetura.

---

🛠️ Instalação (Ubuntu/Debian)

Um comando — o script verifica dependências, clona o repo, builda e configura:

curl -fsSL https://raw.githubusercontent.com/faelsete/pegasus-agent/main/scripts/install.sh | bash

O que acontece:

1. ✅ Verifica dependências (Node 20+, Git, GCC). Se faltar algo, mostra o apt install exato.
2. 📥 Clona o repositório em ~/pegasus-agent.
3. 📦 Instala dependências e compila o TypeScript.
4. ⚙️ Abre o wizard interativo (pede suas chaves de API e token do Telegram).
5. 🚀 Oferece instalar como serviço systemd (24/7).

🧠 Alta Disponibilidade (Multi-Key Fallback)

Cadastre múltiplas API Keys por provedor (ex: 5 contas Gemini ou 3 NVIDIA). Se uma chave atingir rate limit, o Pegasus pula automaticamente para a próxima.

Tip

No npm run setup, separe chaves com vírgula: key1,key2,key3

Já instalou e quer reconfigurar?

cd ~/pegasus-agent && npm run setup
sudo systemctl restart pegasus

Trocar modelo de IA?

Veja o Guia de Modelos completo com catálogo e comandos.

🎮 Modos de Operação

🤖 Telegram Bot (Modo Principal)

Projetado para 24/7. Suporta sessões persistentes e notificações proativas.

npm start

💻 CLI Interativa

Ideal para desenvolvimento local e testes rápidos de ferramentas.

npm run start:cli

🏥 Doctor (Diagnóstico)

Sempre que algo parecer errado, chame o médico:

npm run doctor

---

🧰 Ferramentas Nativas (Standard Tools)

O Pegasus vem equipado com 13 ferramentas profissionais prontas para uso:

• Sistema: bash, system_info.
• Arquivos: file_read, file_write, glob, grep.
• Web: web_search (DuckDuckGo), web_fetch (Markdown converter).
• Memória: memory_search, memory_save.
• Autonomia: cron_create, cron_list, cron_delete.

---

📘 Documentação

Documento	O que cobre
Guia do Usuário	📋 TUDO: modelos, providers, memória, jailbreak, skills, MCP
Guia de Modelos	🤖 Catálogo completo com comandos
Arquitetura	🧠 Como o cérebro funciona
Memória	💾 LanceDB, SQLite, embeddings

---

🤝 Contribuição

Este é um projeto de alta performance. Siga os padrões de TypeScript strict e Conventional Commits.

---

Construído com o máximo de engenharia para ser o agente definitivo.