Início Rápido¶

Bem-vindo ao Aguia-Cibernetica — ELROI OS. Este guia te coloca operacional em minutos.

Pré-requisitos¶

Ferramenta	Versão mínima	Instalação
Node.js	v20+	nodejs.org
Docker Desktop	4.x	docs.docker.com
Git	2.x	git-scm.com
Claude Code CLI	2.x	`npm i -g @anthropic-ai/claude-code`

Setup em 4 passos¶

1. Clonar o repositório¶

git clone https://github.com/Vinicius-Rodegheri-BR/aguia-cibernetica.git
cd aguia-cibernetica

2. Configurar variáveis de ambiente¶

cd infrastructure/docker
cp .env.docker.example .env.docker
# Editar .env.docker com suas credenciais

Variáveis obrigatórias no .env.docker:

POSTGRES_PASSWORD=sua_senha_forte
REDIS_PASSWORD=sua_senha_redis
N8N_ENCRYPTION_KEY=chave_32_chars_minimo
N8N_PASSWORD=senha_n8n
JWT_SECRET=secret_64_chars_minimo
ANTHROPIC_API_KEY=sk-ant-...

Segurança

Nunca commite o arquivo .env.docker. Ele está no .gitignore. Rotacione todas as credenciais se alguma vazar.

3. Subir a infraestrutura¶

make up

Saída esperada:

elroi-postgres    running   ✅
elroi-redis       running   ✅
elroi-n8n         running   ✅
elroi-api-gateway running   ✅

4. Verificar¶

# API Gateway
curl http://localhost:3000/health
# → {"status":"ok","service":"elroi-api-gateway","version":"1.0.0"}

# n8n
open http://localhost:5678

Próximos passos¶

📋

Instalação detalhada

Configuração completa de MCPs, RTK e todas as ferramentas.

Ver guia completo →

🏢

Primeira Squad

Aprenda a ativar uma squad e enviar sua primeira tarefa.

Ativar squad →

💡

Sessão de trabalho

Protocolo de início e encerramento de sessão com Claude Code.

Ver protocolo →