redcell

Des agents IA qui mènent un test d'intrusion de bout en bout et rédigent le rapport.

[!WARNING] REDCELL est fourni uniquement à des fins d'éducation, de recherche et de tests de sécurité légaux et autorisés. Utilisez-le uniquement pour tester des systèmes que vous possédez ou pour lesquels vous disposez d'une autorisation écrite explicite, et uniquement dans le cadre d'un périmètre convenu. L'accès non autorisé à des systèmes informatiques ou leur perturbation est un crime en Azerbaïdjan (articles 271 à 273 du Code pénal) et en vertu des lois de la plupart des autres pays. La manière dont vous l'utilisez, et le respect de la loi, relèvent entièrement de votre responsabilité.

---

Ce que c'est

REDCELL fait travailler une équipe d'agents LLM sur un test d'intrusion. Un orchestrateur planifie la mission et confie des objectifs à des agents exécuteurs, qui lancent de vrais outils dans un conteneur Kali et rendent compte. Vous observez et pilotez l'exécution depuis une console opérateur : un chat qui pilote l'orchestrateur, un graphe d'agents et un flux d'activité en direct, une vue en direct du navigateur que l'agent pilote, un terminal sur tout reverse shell que l'agent intercepte, et un rapport à remettre une fois le travail terminé.

Les modèles sont interchangeables via LiteLLM, ce qui vous permet de le pointer vers OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, un Ollama local, ou tout autre modèle pris en charge. Chaque exécution est sauvegardée au fur et à mesure, de sorte qu'un plantage ou un redémarrage reprend là où il s'était arrêté.

Fonctionnalités

• Moteur multi-agents. Une boucle plan/action LangGraph. L'orchestrateur délègue des objectifs à des agents exécuteurs qui lancent des outils shell et consignent les vulnérabilités, le butin et les hôtes au fil de leur travail.
• Outils structurés. Des outils dédiés pour nmap, nuclei, la découverte de répertoires et de vhosts, ainsi que la recherche et l'exécution Metasploit. Chacun analyse sa propre sortie pour l'intégrer à la surface d'attaque ou aux vulnérabilités, de sorte qu'un scan enregistre les hôtes et les vulnérabilités sans étape supplémentaire. run_command couvre tout ce qui n'a pas d'outil dédié.
• Exécution réelle, locale ou distante. Les outils s'exécutent dans un conteneur Kali via docker exec. Choisissez localhost ou un serveur enregistré par session ; un serveur distant exécute le même conteneur via SSH avec le réseau de l'hôte.
• Navigateur d'agent. Pour les flux de connexion et les applications fortement dépendantes de JavaScript que les outils shell ne peuvent pas atteindre, un agent pilote un vrai Chromium dans le conteneur Kali. Vous le regardez en direct et pouvez prendre le contrôle pour cliquer vous-même, puis le lui rendre.
• Reverse shells. Un agent ouvre un listener, intercepte le shell et vous fournit un terminal interactif dessus. Vous pouvez aussi ouvrir vos propres terminaux et lancer des commandes vous-même.
• Pivot réseau. Acheminez le trafic des outils à travers un reverse shell intercepté pour atteindre des hôtes visibles uniquement depuis la machine compromise. Un tunnel SOCKS inverse chisel le transporte, et nmap s'exécute automatiquement à travers le tunnel.
• Le chat pilote l'exécution. Dites au chat ce que vous voulez et il pilote l'orchestrateur en direct, ou rouvre une exécution terminée pour entreprendre de nouveaux travaux. Il répond aussi aux questions sur la mission.
• Sessions d'analyse de code. Pointez une session vers un dépôt git public ou un dossier local pour une revue de sécurité du code source, avec les vulnérabilités rattachées au fichier et à la ligne.
• Configuration par session. Définissez le serveur d'exécution, le modèle et un proxy de sortie facultatif par session. Les serveurs et les proxys disposent d'un véritable test de connexion pour que vous sachiez qu'ils fonctionnent avant de vous y fier.
• Tri des vulnérabilités. Vérifiez ou écartez les vulnérabilités et fusionnez les doublons que l'agent a enregistrés deux fois. Le rapport omet celles qui ont été écartées et marque celles qui ont été vérifiées.
• Rapports. Exportez un PDF ainsi que du JSON et du SARIF. La rédaction est générée par le modèle de la session et retravaillée pour se lire comme si une personne l'avait écrite, avec un résumé exécutif, une méthodologie, les vulnérabilités et les remédiations par ordre de priorité.
• Console en direct. Le flux d'activité, les terminaux et le navigateur de l'agent sont diffusés via WebSockets ; le graphe d'agents, les vulnérabilités, le butin, la surface d'attaque, les listeners et l'historique du proxy se rafraîchissent par interrogation à court intervalle. Tout se met à jour en direct au fil de l'exécution.
• Notifications. Des toasts dans l'application, plus des notifications du navigateur lorsque l'onglet est en arrière-plan, pour qu'une question de l'agent ou un shell intercepté ne reste pas sans réponse.

Architecture

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

L'API n'exécute pas les agents. Elle met une exécution en file d'attente, le worker l'exécute, et le worker publie la sortie sur des canaux Redis que l'API relaie au navigateur via 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. Outillage : uv pour Python, bun pour le frontend.

Démarrage rapide

Vous aurez besoin de Docker, uv et 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