redcell

KI-Agenten, die einen Penetrationstest von Anfang bis Ende durchführen und den Bericht schreiben.

[!WARNING] REDCELL wird ausschließlich für Bildung, Forschung und rechtmäßige, autorisierte Sicherheitstests bereitgestellt. Verwende es nur, um Systeme zu testen, die dir gehören oder für die du eine ausdrückliche schriftliche Genehmigung zum Testen hast, und nur im Rahmen eines vereinbarten Umfangs. Unbefugter Zugriff auf oder Eingriffe in Computersysteme sind in Aserbaidschan (Strafgesetzbuch, Artikel 271 bis 273) und nach den Gesetzen der meisten anderen Länder strafbar. Wie du es verwendest und ob du dich im Rahmen des Gesetzes bewegst, liegt vollständig in deiner Verantwortung.

---

Was es ist

REDCELL führt ein Team von LLM-Agenten durch einen Pentest. Ein Orchestrator plant den Auftrag und übergibt Ziele an Executor-Agenten, die echte Tools in einem Kali-Container ausführen und Bericht erstatten. Du beobachtest und steuerst den Lauf über eine Betreiberkonsole: einen Chat, der den Orchestrator steuert, einen Live-Agenten-Graphen und Aktivitäts-Feed, eine Live-Ansicht des Browsers, den der Agent steuert, ein Terminal auf jeder Reverse Shell, die der Agent abfängt, und einen Bericht zur Übergabe, wenn die Arbeit erledigt ist.

Modelle sind über LiteLLM austauschbar, sodass du es auf OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, ein lokales Ollama oder alles andere richten kannst, das es unterstützt. Jeder Lauf wird fortlaufend mit Checkpoints gesichert, sodass ein Absturz oder Neustart dort weitermacht, wo er aufgehört hat.

Funktionen

• Multi-Agenten-Engine. Eine LangGraph-Plan/Act-Schleife. Der Orchestrator delegiert Ziele an Executor-Agenten, die Shell-Tools ausführen und Findings, Loot und Hosts während der Arbeit erfassen.
• Strukturierte Tools. Dedizierte Tools für nmap, nuclei, Verzeichnis- und Vhost-Discovery sowie Metasploit-Suche und -Ausführung. Jedes parst seine eigene Ausgabe in die Angriffsfläche oder Findings, sodass ein Scan Hosts und Schwachstellen ohne einen Folgeschritt erfasst. run_command deckt alles ab, wofür es kein dediziertes Tool gibt.
• Echte Ausführung, lokal oder remote. Tools laufen in einem Kali-Container über docker exec. Wähle pro Sitzung localhost oder einen gespeicherten Server; ein Remote-Server führt denselben Container über SSH mit Host-Netzwerk aus.
• Agenten-Browser. Für Login-Abläufe und JavaScript-lastige Apps, die Shell-Tools nicht erreichen können, steuert ein Agent ein echtes Chromium im Kali-Container. Du siehst live zu und kannst die Kontrolle übernehmen, um selbst etwas durchzuklicken, und sie dann zurückgeben.
• Reverse Shells. Ein Agent öffnet einen Listener, fängt die Shell ab und gibt dir ein interaktives Terminal darauf. Du kannst auch eigene Terminals öffnen und selbst Befehle ausführen.
• Netzwerk-Pivoting. Leite Tool-Verkehr durch eine abgefangene Reverse Shell, um Hosts zu erreichen, die nur von der kompromittierten Maschine aus sichtbar sind. Ein Chisel-Reverse-SOCKS-Tunnel trägt ihn, und nmap läuft automatisch durch den Tunnel.
• Chat steuert den Lauf. Sag dem Chat, was du willst, und er steuert den laufenden Orchestrator oder öffnet einen abgeschlossenen Lauf wieder, um neue Arbeit aufzunehmen. Er beantwortet auch Fragen zum Auftrag.
• Code-Scan-Sitzungen. Richte eine Sitzung auf ein öffentliches Git-Repo oder einen lokalen Ordner für eine Quellcode-Sicherheitsüberprüfung, mit Findings, die auf Datei und Zeile zurückgeführt werden.
• Konfiguration pro Sitzung. Lege den Ausführungsserver, das Modell und einen optionalen Egress-Proxy pro Sitzung fest. Server und Proxys kommen mit einem echten Verbindungstest, damit du weißt, dass sie funktionieren, bevor du dich auf sie verlässt.
• Findings-Triage. Verifiziere oder verwerfe Findings und führe Duplikate zusammen, die der Agent doppelt erfasst hat. Der Bericht lässt die verworfenen weg und markiert die verifizierten.
• Berichte. Exportiere ein PDF plus JSON und SARIF. Die Ausarbeitung wird vom Modell der Sitzung generiert und so aufbereitet, dass sie sich liest, als hätte ein Mensch sie geschrieben, mit Executive Summary, Methodik, Findings und Behebung in Prioritätsreihenfolge.
• Live-Konsole. Der Aktivitäts-Feed, Terminals und der Browser des Agenten streamen über WebSockets; der Agenten-Graph, Findings, Loot, Angriffsfläche, Listener und Proxy-Verlauf aktualisieren sich über ein kurzes Polling. Alles aktualisiert sich live, während der Lauf arbeitet.
• Benachrichtigungen. In-App-Toasts sowie Browser-Benachrichtigungen, wenn der Tab im Hintergrund ist, damit eine Frage des Agenten oder eine abgefangene Shell nicht unbemerkt bleibt.

Architektur

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

Die API führt keine Agenten aus. Sie reiht einen Lauf in die Warteschlange ein, der Worker führt ihn aus, und der Worker veröffentlicht Ausgaben auf Redis-Kanälen, die die API über WebSockets an den Browser weiterleitet.

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. Tooling: uv für Python, bun für das Frontend.

Schnellstart

Du benötigst Docker, uv und 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

Oder starte alle drei auf einmal mit einem Prozessmanager (sie sind in der Procfile deklariert): pipx install honcho, dann honcho start.