LLM-gesteuerter Sicherheitstest-Agent, der eine kontinuierliche Tool-Calling-Schleife gegen ein Ziel ausführt, mit über 160 Adaptern für Recon-, Web-, Cloud-, AD- und Post-Exploitation-Tools sowie persistierten Laufberichten.
Ein LLM-gesteuerter Agent für Sicherheitstests: eine einzige kontinuierliche Tool-Calling-Schleife, keine stufenweise Recon→Exploit-Pipeline. Das Modell entscheidet Zug um Zug, was als Nächstes ausgeführt wird, gegen ein reales Ziel.
Haftungsausschluss: Die Tools in Tradecraft können dauerhaften Schaden verursachen, wenn sie nicht ordnungsgemäß konfiguriert sind. Verwende sie nur gegen Ziele, die dir gehören oder für die du ausdrückliche Erlaubnis zum Testen hast. Verlasse dich nicht auf die Standardeinstellungen — verstehe die Konfiguration (
docs/tools.md,docs/policy.md,docs/profiles.md), bevor du deinen ersten Auftrag startest.
Tools sind die Aktionen, die das Modell aufrufen kann — jeweils ein YAML-Vertrag
(was es tut, welche Eingaben es benötigt) plus ein Adapter, der einen
echten Befehl ausführt und seine Ausgabe in strukturierte Daten parst. Siehe
docs/tools.md für den Aufbau eines Tools oder die vollständige
Liste der registrierten Tools — über 160 Tools aus den Bereichen Recon, Web, Cloud, AD,
Kubernetes und Post-Exploitation — in docs/tool-list.md.
Skills sind beratende Markdown-Notizen, die dem Modell toolübergreifendes
Tradecraft-Wissen vermitteln — wann ein Tool einem anderen vorzuziehen ist, wie die Ausgaben zweier
Tools miteinander verkettet werden. Sie sind niemals eine erzwungene Phase und
werden immer vollständig gerendert. Siehe docs/skills.md.
Jeder Engagement-Lauf wird auf der Festplatte gespeichert und kann in einen
Bericht umgewandelt (--report), anschließend in einer Q&A-Konsole (tradecraft chat) erkundet oder als SFT/DPO-Fine-Tuning-Daten exportiert werden (tradecraft dataset).
Siehe docs/report.md, docs/post-engagement.md
und docs/finetune.md.
config/tools/<id>.yaml model-facing contract (description, params, scope_param)
config/profiles/ curated tool sets per engagement shape (web, cloud, ad-network, ...)
tradecraft/domain.py pure shared types
tradecraft/adapters/<tool>/ execute.py (subprocess) + parse.py (pure parsing)
tradecraft/tools/ glues a YAML contract + adapter into one Tool.run()
tradecraft/memory/ append-only engagement log, facts, and evidence store
tradecraft/policy/ destructive-tool gate
tradecraft/skills/ advisory tradecraft markdown, rendered in full
tradecraft/execution/ the agentic loop + system-prompt assembly
tradecraft/reporting/ report generation + post-run investigation console
tradecraft/dataset/ offline SFT/DPO dataset extraction from persisted runs
tradecraft/cli.py entrypoint
Die Abhängigkeitsrichtung ist einseitig: domain → adapters → tools → execution → cli.
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
cp .env.example .env # configure LLM_MODEL, LLM_BASE_URL, and LLM_API_KEY
Verwende ein abliteriertes Modell (bei dem Sicherheitsverweigerungen entfernt wurden) für LLM_MODEL — ein standardmäßig sicherheitsabgestimmtes Modell wird große Teile dessen verweigern, was dieser Agent mitten im Engagement tun muss.
Die für jedes Tool erforderliche Binärdatei (siehe dessen config/tools/<id>.yaml) muss im PATH vorhanden sein; eine fehlende Binärdatei wird dem Modell als Tool-Fehler zurückgegeben, nicht als Absturz. scripts/verify_container_tools.py prüft, welche der Binärdateien der registrierten Tools vorhanden sind. Für ein bewährtes vollständiges Toolset, ohne alles selbst installieren zu müssen, siehe docs/setup.md zum Erstellen und Ausführen des Docker-Images.
tradecraft 10.0.0.5 --profile web
--profile wählt ein kuratiertes Tool-Set für die Form des Engagements (web,
ad-network, cloud, kubernetes, post-exploitation oder full für
jedes registrierte Tool); --tools überschreibt dies mit einer expliziten Liste.
Destruktive Tools sind standardmäßig deaktiviert — übergib --allow-destructive, um
sie zu aktivieren. Führe tradecraft --help für die vollständige Flag-Liste aus oder siehe
docs/cli.md für jeden Subcommand (chat, report,
dataset, memory) auf einen Blick.
Netzwerk-Routing/Egress (VPN, SOCKS/TUN-Gateway oder Container-network_mode) wird
auf der Umgebungsebene statt innerhalb von Adaptern behandelt; wenn du
HTTP_PROXY/HTTPS_PROXY setzt, füge den LLM_BASE_URL-Host zu NO_PROXY hinzu.
pytest
docs/cli.md — alle tradecraft-Unterbefehle und -Flags auf einen Blick.docs/setup.md — Erstellen/Ausführen des Docker-Images, Logs abrufen, Laufdaten extrahieren.docs/tools.md — Tools, Adapter.docs/tool-list.md — jedes registrierte Tool auf einen Blick.docs/policy.md — Gating destruktiver Tools, Blast-Radius-Kategorien, das Budget für Account-Sperrungen.docs/skills.md — was ein Skill ist, wie/wann man einen hinzufügt.docs/profiles.md — Profile für Engagement-Formen, Überschneidungen, wie man eines hinzufügt.docs/report.md — einen Bericht aus einem Lauf generieren.docs/post-engagement.md — die Q&A-Konsole nach dem Lauf.docs/finetune.md — Engagement-Läufe in SFT/DPO-Fine-Tuning-Daten umwandeln.CONTRIBUTING.md — wie man ein neues Tool hinzufügt.