Agent de test de sécurité piloté par LLM qui exécute une boucle continue d'appels d'outils contre une cible, avec plus de 160 adaptateurs d'outils de reconnaissance, web, cloud, AD et post-exploitation, ainsi que des rapports d'exécution persistés.
Un agent de test de sécurité piloté par LLM : une seule boucle continue d'appel d'outils, et non un pipeline par étapes reconnaissance→exploitation. Le modèle décide quoi exécuter ensuite, tour après tour, contre une cible réelle.
Avertissement : les outils de Tradecraft peuvent causer des dommages permanents s'ils ne sont pas correctement configurés. Ne l'utilisez que contre des cibles que vous possédez ou pour lesquelles vous avez l'autorisation explicite de tester. Ne vous fiez pas aux valeurs par défaut — comprenez la configuration (
docs/tools.md,docs/policy.md,docs/profiles.md) avant votre première mission.
Les Outils sont les actions que le modèle peut appeler — chacun un contrat YAML
(ce qu'il fait, quelles entrées il nécessite) plus un adaptateur qui exécute une
commande réelle et analyse sa sortie en données structurées. Voir
docs/tools.md pour savoir comment un outil est construit, ou la liste complète
de ce qui est enregistré — plus de 160 outils couvrant la reconnaissance, le web, le cloud, l'AD,
Kubernetes et la post-exploitation — dans docs/tool-list.md.
Les Compétences sont des notes markdown indicatives fournissant au modèle des connaissances
de tradecraft transversales — quand préférer un outil à un autre, comment les sorties de deux
outils s'enchaînent. Elles ne constituent jamais une phase imposée, et
elles sont toujours rendues intégralement. Voir docs/skills.md.
Chaque exécution de mission est persistée sur disque et peut être transformée en
rapport (--report), explorée ensuite dans une console de questions-réponses (tradecraft chat), ou exportée comme données de fine-tuning SFT/DPO (tradecraft dataset).
Voir docs/report.md, docs/post-engagement.md,
et 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
La direction des dépendances est unidirectionnelle : 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
Utilisez un modèle abliterated (dépourvu de refus de sécurité) pour LLM_MODEL — un modèle standard ajusté pour la sécurité refusera une grande partie de ce que cet agent doit faire en cours d'engagement.
Le binaire requis de chaque outil (voir son config/tools/<id>.yaml) doit être présent sur le PATH ; un binaire manquant est renvoyé au modèle sous forme d'erreur d'outil, et non de plantage. scripts/verify_container_tools.py vérifie lesquels des binaires des outils enregistrés sont présents. Pour obtenir un ensemble d'outils complet et éprouvé sans tout installer vous-même, consultez docs/setup.md pour construire et exécuter l'image Docker à la place.
tradecraft 10.0.0.5 --profile web
--profile sélectionne un ensemble d'outils organisé pour la forme de l'engagement (web,
ad-network, cloud, kubernetes, post-exploitation, ou full pour
chaque outil enregistré) ; --tools le remplace par une liste explicite.
Les outils destructifs sont désactivés par défaut — passez --allow-destructive pour
les activer. Exécutez tradecraft --help pour la liste complète des options, ou consultez
docs/cli.md pour chaque sous-commande (chat, report,
dataset, memory) en un coup d'œil.
Le routage réseau/egress (VPN, passerelle SOCKS/TUN, ou network_mode du conteneur) est
géré au niveau de l'environnement plutôt qu'à l'intérieur des adaptateurs ; si vous définissez
HTTP_PROXY/HTTPS_PROXY, ajoutez l'hôte LLM_BASE_URL à NO_PROXY.
pytest
docs/cli.md — chaque sous-commande et option de tradecraft en un coup d'œil.docs/setup.md — construire/exécuter l'image Docker, récupérer les logs, extraire les données d'exécution.docs/tools.md — outils, adaptateurs.docs/tool-list.md — chaque outil enregistré, en un coup d'œil.docs/policy.md — le contrôle des outils destructifs, les catégories de rayon d'impact, le budget de verrouillage de compte.docs/skills.md — ce qu'est une compétence, comment/quand en ajouter une.docs/profiles.md — les profils de forme d'engagement, le chevauchement, comment en ajouter un.docs/report.md — générer un rapport à partir d'une exécution.docs/post-engagement.md — la console de questions-réponses post-exécution.docs/finetune.md — transformer les exécutions d'engagement en données de fine-tuning SFT/DPO.CONTRIBUTING.md — comment ajouter un nouvel outil.Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.