redcell

O que é

O REDCELL conduz uma equipe de agentes LLM por um teste de intrusão. Um orquestrador planeja o engajamento e entrega objetivos aos agentes executores, que rodam ferramentas reais dentro de um contêiner Kali e reportam de volta. Você acompanha e direciona a execução a partir de um console de operador: um chat que comanda o orquestrador, um grafo de agentes e feed de atividades ao vivo, uma visualização ao vivo 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 terminar.

Os modelos são plugáveis via LiteLLM, então você pode apontá-lo para OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, um Ollama local ou qualquer outra coisa que ele suporte. Cada execução faz checkpoint conforme avança, então uma queda ou reinício retoma de onde parou.

Recursos

• Motor multiagente. Um loop de planejar/agir em LangGraph. O orquestrador delega objetivos aos agentes executores que rodam ferramentas de shell e registram descobertas, loot e hosts conforme trabalham.
• Ferramentas estruturadas. Ferramentas dedicadas para nmap, nuclei, descoberta de diretórios e vhosts, e busca e execução no Metasploit. Cada uma analisa sua própria saída na superfície de ataque ou nas descobertas, então um scan registra hosts e vulnerabilidades sem uma etapa adicional. run_command cobre qualquer coisa sem uma ferramenta dedicada.
• Execução real, local ou remota. As ferramentas rodam em um contêiner Kali via docker exec. Escolha localhost ou um servidor salvo por sessão; um servidor remoto roda o mesmo contêiner via SSH com rede do host.
• Navegador do agente. Para fluxos de login e aplicações pesadas em JavaScript que ferramentas de shell não alcançam, um agente controla um Chromium real no contêiner Kali. Você o assiste ao vivo e pode assumir o controle para clicar em algo você mesmo, depois devolvê-lo.
• Reverse shells. Um agente abre um listener, captura o shell e lhe dá um terminal interativo nele. Você também pode abrir seus próprios terminais e rodar comandos você mesmo.
• Pivoteamento de rede. Roteie o tráfego das ferramentas através de um reverse shell capturado para alcançar hosts que só são visíveis a partir da máquina comprometida. Um túnel SOCKS reverso via chisel o transporta, e o nmap roda pelo túnel automaticamente.
• O chat comanda a execução. Diga ao chat o que você quer e ele direciona o orquestrador ao vivo, ou reabre uma execução concluída para assumir novo trabalho. Ele também responde perguntas sobre o engajamento.
• Sessões de scan 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 para arquivo 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. Servidores e proxies vêm com um teste de conexão real para você saber que funcionam antes de depender deles.
• Triagem de descobertas. Verifique ou descarte descobertas e mescle duplicatas que o agente registrou 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 refinado para parecer escrito por uma pessoa, com sumário executivo, metodologia, descobertas e remediação em ordem de prioridade.
• Console ao vivo. O feed de atividades, os terminais e o navegador do agente transmitem via WebSockets; o grafo de agentes, descobertas, loot, superfície de ataque, listeners e histórico de proxy atualizam em um polling curto. Tudo atualiza ao vivo conforme a execução trabalha.
• Notificações. Toasts no aplicativo, além de notificações do navegador quando a aba está em segundo plano, para que uma pergunta do agente ou um shell capturado não fique sem ser visto.

Arquitetura

A API não executa agentes. Ela enfileira uma execução, o worker a executa, e o worker publica a saída em canais do Redis que a API retransmite ao navegador via WebSockets.

Stack

Python 3.12, FastAPI, SQLAlchemy assíncrono + 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

Você vai precisar de Docker, uv e bun.

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

Abra http://localhost:5183 e entre com admin / admin.

As execuções rodam ferramentas reais por padrão. Adicione uma chave de API de provedor em Settings e certifique-se de que o Docker consegue baixar a imagem Kali (martian56/kali:latest). Para simular contra saída pré-definida, defina REDCELL_RUN_MODE=sim em .env.

Alvos de prática

Aplicações intencionalmente vulneráveis para apontar o REDCELL, todas locais:

Implantação (auto-hospedada)

Rode o REDCELL em um servidor com as imagens publicadas atrás de um proxy reverso Caddy, para que o aplicativo web e a API compartilhem uma origem (sem CORS) e o HTTPS seja tratado para você. Em um servidor novo:

O script instala o Docker se estiver faltando e então pergunta como o REDCELL será acessado:

1. Este servidor diretamente, sem domínio — HTTP simples no IP do servidor. Bom para um teste rápido ou uma rede privada.
2. Um domínio apontado diretamente para este servidor — o Caddy provisiona um certificado Let's Encrypt automaticamente (aponte um registro A ou AAAA para o servidor primeiro) e serve https://seu-dominio.
3. Um domínio atrás do Cloudflare, Coolify ou outro proxy ou CDN — o proxy fornece o certificado HTTPS público e encaminha para este servidor. A origem serve tanto HTTP simples (:80) quanto HTTPS autoassinado (:443), então funciona com um proxy que conecta via HTTP ou um que aceita o certificado da origem (para Cloudflare, modo SSL Full; Full (strict) precisa de um Cloudflare Origin Certificate).

Ele grava suas respostas em .env, baixa as imagens e inicia a stack. Leia a senha de admin gerada com docker compose logs init-secrets, então entre como admin e altere-a. Para mudar como ele é acessado depois, basta rodar ./deploy.sh novamente e escolher uma opção diferente.

Apenas as portas 80 e 443 são publicadas; Postgres, Redis, MinIO, a API e o aplicativo web permanecem na rede interna. Os arquivos armazenados são transmitidos pela API, então o armazenamento de objetos nunca é exposto. Veja docs/DEPLOY.md para os detalhes de cada modo.

Configuração

A configuração do backend é um único .env na raiz (veja .env.example), lido tanto pela API quanto pelo worker. As que vale a pena conhecer:

• REDCELL_RUN_MODE: live (padrão) ou sim.
• REDCELL_DATABASE_URL, REDCELL_REDIS_URL, REDCELL_S3_*: infraestrutura.
• REDCELL_SECRET_KEY: chave Fernet para criptografar credenciais armazenadas. Defina uma real antes de ir para produção.

Chaves de API de provedores, a imagem de execução, guardrails de escopo e a marca do relatório ficam na página Settings e são armazenados no banco de dados, criptografados onde necessário.

Estrutura do projeto

Documentação

• Arquitetura — os componentes, como uma execução flui, coordenação entre processos.
• Hardening e modelo de ameaças — implante com segurança, segredos, escopo e retenção de dados. Leia isto antes de rodar o REDCELL em qualquer lugar que não seja sua própria máquina.
• Superfície de pré-autenticação — o que um cliente não autenticado pode observar e como manter isso mínimo.
• Custo e contagem de tokens — como o gasto da execução é medido, a tabela de preços e o custo real do OpenRouter.
• Paleta de comandos e atalhos — Cmd/Ctrl+K para pesquisar sessões, servidores e proxies, e navegação por teclado.
• Atualização — o botão Update no aplicativo e a atualização pelo shell.
• Shell do console — a barra lateral, os menus e as regras de posicionamento de dropdowns.
• Controles de formulário — o combobox pesquisável e quando usá-lo em vez de um select nativo.

Contribuindo

Contribuições são bem-vindas. Veja CONTRIBUTING.md para configuração, testes e convenções, e o Código de Conduta. Relate problemas de segurança de forma privada através de SECURITY.md, não em issues públicas.

Uso responsável

Esta é uma ferramenta defensiva e ofensiva autorizada para profissionais de segurança, CTFs e seus próprios laboratórios. Não a use contra sistemas para os quais você não tem permissão escrita de teste. Os mantenedores não são responsáveis por uso indevido.