Versão: 0.1.0 | Atualizado: 2026-05-04 | Status: ATIVO (apps selecionados) Parte do ecossistema EGOS
Monorepo que hospeda as aplicações e agents do ecossistema EGOS. O runtime de agents e a governança foram consolidados no kernel egos; este repo mantém as apps em produção e os agents especializados.
O egos-lab nasceu como lab de prototipagem (daí o sufixo), mas evoluiu para hospedar apps e agents que já estão em produção real. É o ponto de entrada para quem quer rodar, contribuir ou estender:
- Eagle Eye — monitor OSINT de gazetas oficiais (licitações, contratações, nomeações)
- Telegram Bot — interface pública do EGOS (
@EGOSin_bot), com 26 ferramentas e acesso a agents - Agent Commander — pipeline seguro Telegram → GitHub para execução de agents remotamente
- egos-web — landing + vitrine comercial do EGOS Lab em lab.egos.ia.br
- 23 agents registrados — desde gem-hunter até security-scanner, todos com suporte a
--drye--exec
| App | Descrição | Stack | Status | URL |
|---|---|---|---|---|
| egos-web | Landing + vitrine comercial EGOS Lab | React + Vite | Live | lab.egos.ia.br (VPS Hetzner, Caddy estático) |
| eagle-eye | Monitor de gazetas + análise OSINT | Bun + TypeScript | Live | VPS Hetzner |
| telegram-bot | @EGOSin_bot — bot AI comunitário, 26 ferramentas |
Telegraf + Bun | Live | VPS Hetzner (PM2) |
| agent-commander | Pipeline Telegram → GitHub, execução segura | Bun + TypeScript | Ativo | VPS Hetzner |
| App | Motivo |
|---|---|
intelink (legado) |
Portado para repo próprio /home/enio/intelink |
nexus |
Prototype descontinuado |
radio-philein |
Em pausa |
marketplace-core |
Arquivado — funcionalidade absorvida por carteira-livre |
carteira-x |
Dormant (agent carteira-x-engine registrado, app arquivado) |
egos-self |
Experimental |
symphony-egos |
Experimental |
23 agents registrados em agents/registry/agents.json.
| Agent | Descrição | Status |
|---|---|---|
gem-hunter |
Discovery engine — 7 APIs, 14 categorias, cron semanal | ativo |
master-orchestrator |
Roda todos os agents em sequência | ativo |
ssot-auditor |
Detecção de drift de tipos estruturais | ativo |
security-scanner |
Varredura de vulnerabilidades e secrets | ativo |
auth-roles-checker |
Validação de RBAC e permissões | ativo |
contract-tester |
Testes de contrato entre módulos | ativo |
integration-tester |
Testes de integração E2E | ativo |
regression-watcher |
Monitoramento de regressões | ativo |
ai-verifier |
Validação de outputs de IA | ativo |
domain-explorer |
Exploração de domínios de negócio | ativo |
living-laboratory |
Laboratório de experimentação | ativo |
showcase-writer |
Geração de showcases e demos | ativo |
open-source-readiness |
Checklist de abertura de código | ativo |
uptime-monitor |
Monitor de uptime de serviços | ativo |
quota-guardian |
Guardião de quotas de APIs | ativo |
etl-orchestrator |
Orquestração de pipelines ETL | ativo |
autoresearch |
Loop de pesquisa automática | ativo |
ui-designer |
Designer de UI via Stitch | ativo |
report-generator |
Geração de relatórios | ativo |
prompt |
Builder de prompts | ativo |
orchestrator |
Orquestrador geral | ativo |
e2e-smoke |
Smoke tests E2E | dormant |
social-media |
Gerenciador de redes sociais | dead |
bun agent:list # lista todos os agents
bun agent:run <id> --dry # dry-run (sem efeitos colaterais)
bun agent:run <id> --exec # execução real
bun agent:lint # valida o registry| Camada | Tecnologia |
|---|---|
| Runtime | Bun |
| Linguagem | TypeScript (ESM) |
| Workspaces | Bun workspaces (packages/*, apps/*) |
| Bot | Telegraf 4.x |
| Social / Discovery | twitter-api-v2, exa-js, Discord.js |
| Banco | Supabase PostgreSQL + pg |
| Cache | Redis |
| Frontend (egos-web) | React + Vite |
| Infra | VPS Hetzner + PM2 + Caddy |
# 1. Clonar
git clone https://github.com/enioxt/egos-lab.git && cd egos-lab
# 2. Instalar dependências
bun install
# 3. Verificar agents disponíveis
bun agent:list
# 4. Rodar egos-web em desenvolvimento
cd apps/egos-web && bun dev # http://localhost:5173
# 5. Rodar Eagle Eye (dry-run)
bun eagle-eye:fetchegos-lab/
├── agents/
│ ├── cli.ts # CLI: list, run, lint-registry
│ ├── runtime/runner.ts # Motor de execução dos agents
│ ├── registry/agents.json # Definições dos 23 agents (SSOT)
│ └── agents/ # Implementações individuais
├── apps/
│ ├── egos-web/ # Mission Control (React + Vite) → egos.ia.br
│ ├── telegram-bot/ # @EGOSin_bot — Live
│ ├── eagle-eye/ # Monitor OSINT → VPS
│ ├── agent-commander/ # Pipeline Telegram→GitHub → VPS
│ └── _archived/ # Apps descontinuados
├── packages/
│ └── shared/ # AI client, types, social APIs, sacred-math
├── scripts/
│ ├── orchestrator/ # Health monitor, log analyzer, DB auditor
│ └── mycelium/ # File signature sync
├── .guarani/ # Identidade dos agents + regras de código (DNA)
└── .windsurfrules # Regras de ativação por contexto
# Agents
bun agent:list # listar agents
bun agent:run gem_hunter --dry # gem-hunter em dry-run
bun agent:ssot --exec # SSOT Auditor
bun agent:test:exec # todos os test agents (5 camadas)
# Eagle Eye (OSINT)
bun eagle-eye:fetch # buscar gazetas
bun eagle-eye:analyze # analisar gazette
bun eagle-eye:batch # varredura em lote
# Monitoramento
bun orchestrator:health # health check geral
bun orchestrator:logs # análise de logs
bun ssot:drift # verificar drift de SSOT
# Segurança
bun security:scan # varredura de segurança# Agent Commander e Eagle Eye rodam no VPS via PM2
ssh -i ~/.ssh/hetzner_ed25519 root@204.168.217.125
pm2 list # ver processos
pm2 logs telegram-bot # logs do bot
# egos-web é deployado automaticamente via Vercel (push para main)
git push origin main| Repo | Relação | Status |
|---|---|---|
| egos | Kernel upstream — runtime migrado, governança | PROD |
| intelink | Repo irmão — inteligência policial | PROD |
Upstream (o que este repo usa): padrões de governança .guarani/, tipos do event bus do kernel.
Downstream (quem usa este repo): Eagle Eye alimenta dados OSINT para o ecossistema; Telegram Bot serve como interface pública do EGOS.
Leia CLAUDE.md antes de contribuir. Padrões obrigatórios:
- Commits convencionais (
feat:,fix:,docs:,chore:) - Todo agent DEVE suportar
--dryantes de--exec - Agents não têm dependências externas além de Node/Bun stdlib
- Sem secrets em código — use
.env
AGPL-3.0
Parte do ecossistema EGOS — Governance Kernel for AI Systems.