redcell

Agentes de IA que ejecutan una prueba de penetración de principio a fin y redactan el informe.

[!WARNING] REDCELL se proporciona únicamente para educación, investigación y pruebas de seguridad legales y autorizadas. Úsalo solo para probar sistemas que poseas o para los que tengas permiso escrito explícito de probar, y solo dentro de un alcance acordado. El acceso no autorizado o la interferencia con sistemas informáticos es un delito en Azerbaiyán (artículos 271 a 273 del Código Penal) y según las leyes de la mayoría de los demás países. Cómo lo uses, y mantenerte dentro de la ley, es enteramente tu responsabilidad.

---

Qué es

REDCELL ejecuta un equipo de agentes LLM a lo largo de una prueba de penetración. Un orquestador planifica el encargo y entrega objetivos a los agentes ejecutores, que ejecutan herramientas reales dentro de un contenedor Kali e informan de vuelta. Tú observas y diriges la ejecución desde una consola de operador: un chat que controla al orquestador, un grafo de agentes y un feed de actividad en vivo, una vista en vivo del navegador que maneja el agente, una terminal sobre cualquier reverse shell que el agente capture, y un informe para entregar cuando el trabajo esté hecho.

Los modelos son intercambiables a través de LiteLLM, así que puedes apuntarlo a OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, un Ollama local o cualquier otra cosa que soporte. Cada ejecución guarda puntos de control a medida que avanza, así que un fallo o un reinicio retoma donde lo dejó.

Características

• Motor multiagente. Un bucle plan/act de LangGraph. El orquestador delega objetivos a agentes ejecutores que ejecutan herramientas de shell y registran hallazgos, botín y hosts mientras trabajan.
• Herramientas estructuradas. Herramientas dedicadas para nmap, nuclei, descubrimiento de directorios y vhosts, y búsqueda y ejecución de Metasploit. Cada una analiza su propia salida hacia la superficie de ataque o los hallazgos, así que un escaneo registra hosts y vulnerabilidades sin un paso adicional. run_command cubre cualquier cosa que no tenga una herramienta dedicada.
• Ejecución real, local o remota. Las herramientas se ejecutan en un contenedor Kali mediante docker exec. Elige localhost o un servidor guardado por sesión; un servidor remoto ejecuta el mismo contenedor por SSH con red de host.
• Navegador del agente. Para flujos de inicio de sesión y aplicaciones con mucho JavaScript que las herramientas de shell no pueden alcanzar, un agente maneja un Chromium real en el contenedor Kali. Lo observas en vivo y puedes tomar el control para hacer clic tú mismo en algo, y luego devolvérselo.
• Reverse shells. Un agente abre un listener, captura la shell y te da una terminal interactiva sobre ella. También puedes abrir tus propias terminales y ejecutar comandos tú mismo.
• Pivoting de red. Enruta el tráfico de las herramientas a través de una reverse shell capturada para alcanzar hosts que solo son visibles desde la máquina comprometida. Un túnel SOCKS inverso con chisel lo transporta, y nmap se ejecuta a través del túnel automáticamente.
• El chat dirige la ejecución. Dile al chat lo que quieres y este dirige al orquestador en vivo, o reabre una ejecución finalizada para asumir nuevo trabajo. También responde preguntas sobre el encargo.
• Sesiones de escaneo de código. Apunta una sesión a un repositorio git público o a una carpeta local para una revisión de seguridad del código fuente, con hallazgos mapeados a archivo y línea.
• Configuración por sesión. Establece el servidor de ejecución, el modelo y un proxy de salida opcional por sesión. Los servidores y proxies incluyen una prueba de conexión real para que sepas que funcionan antes de depender de ellos.
• Triaje de hallazgos. Verifica o descarta hallazgos y fusiona duplicados que el agente registró dos veces. El informe omite los descartados y marca los verificados.
• Informes. Exporta un PDF más JSON y SARIF. El texto lo genera el modelo de la sesión y se pule para que se lea como si lo hubiera escrito una persona, con un resumen ejecutivo, metodología, hallazgos y remediación en orden de prioridad.
• Consola en vivo. El feed de actividad, las terminales y el navegador del agente se transmiten por WebSockets; el grafo de agentes, los hallazgos, el botín, la superficie de ataque, los listeners y el historial del proxy se actualizan con un sondeo corto. Todo se actualiza en vivo mientras la ejecución trabaja.
• Notificaciones. Avisos dentro de la aplicación, además de notificaciones del navegador cuando la pestaña está en segundo plano, para que una pregunta del agente o una shell capturada no queden sin verse.

Arquitectura

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

La API no ejecuta agentes. Encola una ejecución, el worker la ejecuta, y el worker publica la salida en canales de Redis que la API retransmite al navegador por WebSockets.

Stack

Python 3.12, FastAPI, SQLAlchemy asíncrono + asyncpg, Alembic, arq, LangGraph, LiteLLM, ReportLab, PostgreSQL, Redis, MinIO, asyncssh. Frontend: React 18, Vite, TypeScript, Tailwind, TanStack Query, xterm. Herramientas: uv para Python, bun para el frontend.

Inicio rápido

Necesitarás Docker, uv y 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

O inicia los tres a la vez con un gestor de procesos (están declarados en el Procfile): pipx install honcho y luego honcho start.

Abre http://localhost:5183 e inicia sesión con admin / admin.