Agente de pruebas de seguridad impulsado por LLM que ejecuta un bucle continuo de llamadas a herramientas contra un objetivo, con más de 160 adaptadores de herramientas de reconocimiento, web, nube, AD y post-explotación, e informes de ejecución persistidos.
Un agente de pruebas de seguridad impulsado por LLM: un único bucle continuo de llamadas a herramientas, no un pipeline por etapas de reconocimiento→explotación. El modelo decide qué ejecutar a continuación, turno a turno, contra un objetivo real.
Aviso: las herramientas de Tradecraft pueden causar daños permanentes si no se configuran correctamente. Úsalo solo contra objetivos que poseas o para los que tengas permiso explícito de probar. No confíes en los valores predeterminados: comprende la configuración (
docs/tools.md,docs/policy.md,docs/profiles.md) antes de tu primer engagement.
Las herramientas son las acciones que el modelo puede invocar: cada una es un contrato YAML (qué hace, qué entradas necesita) más un adaptador que ejecuta un comando real y analiza su salida en datos estructurados. Consulta docs/tools.md para saber cómo se construye una herramienta, o la lista completa de lo que está registrado —más de 160 herramientas en reconocimiento, web, cloud, AD, Kubernetes y post-explotación— en docs/tool-list.md.
Las habilidades son notas markdown de carácter orientativo que proporcionan al modelo conocimiento de tradecraft entre herramientas: cuándo preferir una herramienta sobre otra, cómo se encadenan las salidas de dos herramientas. Nunca son una fase impuesta y siempre se muestran en su totalidad. Consulta docs/skills.md.
Cada ejecución de engagement se persiste en disco y puede convertirse en un informe (--report), explorarse después en una consola de preguntas y respuestas (tradecraft chat) o exportarse como datos de ajuste fino SFT/DPO (tradecraft dataset). Consulta docs/report.md, docs/post-engagement.md y 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 dirección de dependencias es unidireccional: 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
Usa un modelo abliterated (con los rechazos de seguridad eliminados) para LLM_MODEL — un modelo estándar ajustado con seguridad rechazará gran parte de lo que este agente necesita hacer durante el compromiso.
El binario requerido de cada herramienta (véase su config/tools/<id>.yaml) debe estar en el PATH; un binario ausente se devuelve al modelo como un error de herramienta, no como un fallo. scripts/verify_container_tools.py comprueba cuáles de los binarios de las herramientas registradas están presentes. Para obtener un conjunto de herramientas completo y verificado sin instalar todo tú mismo, consulta docs/setup.md para construir y ejecutar la imagen de Docker en su lugar.
tradecraft 10.0.0.5 --profile web
--profile selecciona un conjunto de herramientas curado para la forma del engagement (web, ad-network, cloud, kubernetes, post-exploitation, o full para cada herramienta registrada); --tools lo sobrescribe con una lista explícita. Las herramientas destructivas están desactivadas por defecto — pasa --allow-destructive para habilitarlas. Ejecuta tradecraft --help para ver la lista completa de flags, o consulta docs/cli.md para cada subcomando (chat, report, dataset, memory) de un vistazo.
El enrutamiento/egress de red (VPN, gateway SOCKS/TUN, o network_mode del contenedor) se gestiona en la capa de entorno en lugar de dentro de los adaptadores; si configuras HTTP_PROXY/HTTPS_PROXY, añade el host LLM_BASE_URL a NO_PROXY.
pytest
docs/cli.md — todos los subcomandos y flags de tradecraft de un vistazo.docs/setup.md — compilar/ejecutar la imagen de Docker, obtener logs, extraer datos de ejecución.docs/tools.md — herramientas, adaptadores.docs/tool-list.md — todas las herramientas registradas, de un vistazo.docs/policy.md — control de herramientas destructivas, categorías de radio de impacto, el presupuesto de bloqueo de cuentas.docs/skills.md — qué es una skill, cómo y cuándo añadir una.docs/profiles.md — perfiles de forma de engagement, solapamiento, cómo añadir uno.docs/report.md — generar un informe a partir de una ejecución.docs/post-engagement.md — la consola de preguntas y respuestas posterior a la ejecución.docs/finetune.md — convertir ejecuciones de engagement en datos de fine-tuning SFT/DPO.CONTRIBUTING.md — cómo añadir una nueva herramienta.