redcell

Agentes de IA que executam um teste de intrusão de ponta a ponta e escrevem o relatório.

[!WARNING] O REDCELL é fornecido apenas para fins de educação, investigação e testes de segurança legais e autorizados. Utilize-o apenas para testar sistemas que possui ou para os quais tem permissão escrita explícita para testar, e apenas dentro de um âmbito acordado. O acesso não autorizado a sistemas informáticos ou a interferência com os mesmos é crime no Azerbaijão (artigos 271 a 273 do Código Penal) e ao abrigo das leis da maioria dos outros países. A forma como o utiliza, e a manutenção dentro da legalidade, é inteiramente da sua responsabilidade.

---

O que é

O REDCELL executa uma equipa de agentes LLM ao longo de um teste de intrusão. Um orquestrador planeia o envolvimento e entrega objetivos a agentes executores, que executam ferramentas reais dentro de um contentor Kali e reportam de volta. Pode observar e orientar a execução a partir de uma consola de operador: um chat que comanda o orquestrador, um grafo de agentes e feed de atividade em direto, uma vista em direto do navegador que o agente controla, um terminal em qualquer reverse shell que o agente capture, e um relatório para entregar quando o trabalho estiver concluído.

Os modelos são plugáveis através do LiteLLM, pelo que pode apontá-lo para OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, um Ollama local ou qualquer outra coisa que suporte. Cada execução faz checkpoint à medida que avança, pelo que uma falha ou reinício retoma de onde parou.

Funcionalidades

• Motor multiagente. Um ciclo plan/act em LangGraph. O orquestrador delega objetivos a agentes executores que executam ferramentas de shell e registam descobertas, loot e hosts à medida que trabalham.
• Ferramentas estruturadas. Ferramentas dedicadas para nmap, nuclei, descoberta de diretórios e vhosts, e pesquisa e execução do Metasploit. Cada uma analisa a sua própria saída para a superfície de ataque ou descobertas, pelo que um scan regista hosts e vulnerabilidades sem um passo adicional. O run_command cobre tudo o que não tenha uma ferramenta dedicada.
• Execução real, local ou remota. As ferramentas são executadas num contentor Kali através de docker exec. Escolha localhost ou um servidor guardado por sessão; um servidor remoto executa o mesmo contentor via SSH com host networking.
• Navegador do agente. Para fluxos de login e aplicações com muito JavaScript que as ferramentas de shell não conseguem alcançar, um agente controla um Chromium real no contentor Kali. Pode observá-lo em direto e assumir o controlo para clicar em algo você mesmo, devolvendo-o depois.
• Reverse shells. Um agente abre um listener, captura a shell e dá-lhe um terminal interativo sobre ela. Também pode abrir os seus próprios terminais e executar comandos você mesmo.
• Pivot de rede. Encaminhe o tráfego das ferramentas através de uma reverse shell capturada para alcançar hosts que só são visíveis a partir da máquina comprometida. Um túnel SOCKS reverso chisel transporta-o, e o nmap é executado através do túnel automaticamente.
• O chat comanda a execução. Diga ao chat o que quer e ele orienta o orquestrador em direto, ou reabre uma execução concluída para assumir novo trabalho. Também responde a perguntas sobre o envolvimento.
• Sessões de análise de código. Aponte uma sessão para um repositório git público ou uma pasta local para uma revisão de segurança de código-fonte, com descobertas mapeadas de volta ao ficheiro e linha.
• Configuração por sessão. Defina o servidor de execução, o modelo e um proxy de saída opcional por sessão. Os servidores e proxies vêm com um teste de ligação real para que saiba que funcionam antes de depender deles.
• Triagem de descobertas. Verifique ou descarte descobertas e faça merge de duplicados que o agente registou duas vezes. O relatório omite as descartadas e marca as verificadas.
• Relatórios. Exporte um PDF mais JSON e SARIF. O texto é gerado pelo modelo da sessão e limpo para parecer escrito por uma pessoa, com sumário executivo, metodologia, descobertas e remediação por ordem de prioridade.
• Consola em direto. O feed de atividade, os terminais e o navegador do agente são transmitidos por WebSockets; o grafo de agentes, descobertas, loot, superfície de ataque, listeners e histórico de proxy atualizam-se com um polling curto. Tudo se atualiza em direto à medida que a execução avança.
• Notificações. Toasts na aplicação, mais notificações do navegador quando o separador está em segundo plano, para que uma pergunta do agente ou uma shell capturada não fique sem ser vista.

Arquitetura

flowchart LR
  UI["Operator console<br/>React + Vite"] -->|REST + WebSocket| API["FastAPI"]
  API --> PG[(PostgreSQL)]
  API --> RS[(Redis<br/>pub/sub + queue)]
  API --> S3[(MinIO<br/>files & reports)]
  RS --> W["Worker (arq)"]
  W --> ENG["Engine<br/>LangGraph + LiteLLM"]
  ENG -->|docker exec| KALI["Kali container<br/>local or remote over SSH"]
  KALI --> TGT["Targets"]
  W -->|events / chat / shell| RS
  RS -->|stream| API

A API não executa agentes. Coloca uma execução em fila, o worker executa-a, e o worker publica a saída em canais Redis que a API retransmite para o navegador através de WebSockets.

Stack

Python 3.12, FastAPI, async SQLAlchemy + asyncpg, Alembic, arq, LangGraph, LiteLLM, ReportLab, PostgreSQL, Redis, MinIO, asyncssh. Frontend: React 18, Vite, TypeScript, Tailwind, TanStack Query, xterm. Ferramentas: uv para Python, bun para o frontend.

Início rápido

Vai precisar de Docker, uv e bun.

# 1. infrastructure (Postgres, Redis, MinIO)
docker compose -f docker-compose.dev.yml up -d

# 2. Python deps, database, and seed data
uv sync --group live
uv run rc db upgrade
uv run rc seed              # admin user, provider catalog, buckets

# 3. copy the env template
cp .env.example .env

# 4. run the three processes (separate terminals)
cd apps/api    && uv run uvicorn app.main:app --host 127.0.0.1 --port 8080
cd apps/worker && uv run arq worker.settings.WorkerSettings
cd apps/web    && bun install && bun run dev

Ou inicie os três de uma vez com um gestor de processos (estão declarados no Procfile): pipx install honcho e depois honcho start.

Abra http://localhost:5183 e inicie sessão com admin / admin.