redcell

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 capture el agente 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 continúa 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 a las que las herramientas de shell no llegan, un agente maneja un Chromium real en el contenedor Kali. Lo ves 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 controla al orquestador en vivo, o reabre una ejecución terminada para asumir trabajo nuevo. 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 los hallazgos mapeados a archivo y línea.
• Configuración por sesión. Define 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 refrescan 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 quede sin verse.

Arquitectura

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.

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.

Las ejecuciones ejecutan herramientas reales por defecto. Añade una clave de API de proveedor en Settings y asegúrate de que Docker puede descargar la imagen Kali (martian56/kali:latest). Para hacer una ejecución en seco contra salida predefinida, define REDCELL_RUN_MODE=sim en .env.

Objetivos de práctica

Aplicaciones intencionadamente vulnerables a las que apuntar REDCELL, todas locales:

Despliegue (autoalojado)

Ejecuta REDCELL en un servidor con las imágenes publicadas detrás de un proxy inverso Caddy, para que la aplicación web y la API compartan un mismo origen (sin CORS) y HTTPS se gestione por ti. En un servidor nuevo:

El script instala Docker si falta y luego pregunta cómo se accederá a REDCELL:

1. Este servidor directamente, sin dominio — HTTP simple en la IP del servidor. Bueno para una prueba rápida o una red privada.
2. Un dominio apuntando directamente a este servidor — Caddy provisiona un certificado de Let's Encrypt automáticamente (apunta primero un registro A o AAAA al servidor) y sirve https://tu-dominio.
3. Un dominio detrás de Cloudflare, Coolify u otro proxy o CDN — el proxy proporciona el certificado HTTPS público y reenvía a este servidor. El origen sirve tanto HTTP simple (:80) como HTTPS autofirmado (:443), así que funciona con un proxy que conecta por HTTP o con uno que acepta el certificado del origen (para Cloudflare, modo SSL Full; Full (strict) necesita un Cloudflare Origin Certificate).

Escribe tus respuestas en .env, descarga las imágenes e inicia el stack. Lee la contraseña de administrador generada con docker compose logs init-secrets, luego inicia sesión como admin y cámbiala. Para cambiar cómo se accede más adelante, simplemente vuelve a ejecutar ./deploy.sh y elige una opción diferente.

Solo se publican los puertos 80 y 443; Postgres, Redis, MinIO, la API y la aplicación web permanecen en la red interna. Los archivos almacenados se transmiten a través de la API, así que el almacenamiento de objetos nunca queda expuesto. Consulta docs/DEPLOY.md para los detalles de cada modo.

Configuración

La configuración del backend es un único .env raíz (ver .env.example), leído tanto por la API como por el worker. Los que conviene conocer:

• REDCELL_RUN_MODE: live (por defecto) o sim.
• REDCELL_DATABASE_URL, REDCELL_REDIS_URL, REDCELL_S3_*: infraestructura.
• REDCELL_SECRET_KEY: clave Fernet para cifrar las credenciales almacenadas. Define una real antes de pasar a producción.

Las claves de API de proveedores, la imagen de ejecución, las barreras de alcance y la marca del informe viven en la página Settings y se almacenan en la base de datos, cifradas donde sea necesario.

Estructura del proyecto

Documentación

• Arquitectura — los componentes, cómo fluye una ejecución, coordinación entre procesos.
• Endurecimiento y modelo de amenazas — despliega de forma segura, secretos, alcance y retención de datos. Lee esto antes de ejecutar REDCELL en cualquier sitio que no sea tu propia máquina.
• Superficie de preautenticación — qué puede observar un cliente no autenticado y cómo mantenerlo al mínimo.
• Coste y contabilidad de tokens — cómo se mide el gasto de una ejecución, la tabla de precios y el coste real de OpenRouter.
• Paleta de comandos y atajos — Cmd/Ctrl+K para buscar sesiones, servidores y proxies, y navegación por teclado.
• Actualización — el botón Update dentro de la aplicación y la actualización desde el shell.
• Shell de la consola — la barra lateral, los menús y las reglas de posicionamiento de los desplegables.
• Controles de formulario — el combobox con búsqueda y cuándo usarlo en lugar de un select nativo.

Contribuir

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md para la configuración, las pruebas y las convenciones, y el Código de Conducta. Reporta problemas de seguridad de forma privada a través de SECURITY.md, no en issues públicos.

Uso responsable

Esto es tooling defensivo y ofensivo autorizado para profesionales de seguridad, CTFs y tus propios laboratorios. No lo uses contra sistemas para los que no tengas permiso por escrito de probar. Los mantenedores no son responsables del mal uso.