Агент для тестирования безопасности на основе LLM, который выполняет непрерывный цикл вызова инструментов против цели, с более чем 160 адаптерами инструментов для разведки, веб-, облачных, AD- и постэксплуатационных задач и сохраняемыми отчётами о запусках.
Управляемый LLM агент для тестирования безопасности: единый непрерывный цикл вызова инструментов, а не поэтапный конвейер разведка→эксплуатация. Модель решает, что запускать дальше, ход за ходом, против реальной цели.
Отказ от ответственности: инструменты в Tradecraft могут причинить непоправимый ущерб при неправильной настройке. Используйте их только против целей, которыми вы владеете или на тестирование которых у вас есть явное разрешение. Не полагайтесь на настройки по умолчанию — разберитесь в конфигурации (
docs/tools.md,docs/policy.md,docs/profiles.md) перед первым использованием.
Инструменты — это действия, которые может вызывать модель: каждый из них представляет собой YAML-контракт
(что он делает, какие входные данные ему нужны) плюс адаптер, который выполняет
реальную команду и разбирает её вывод в структурированные данные. См.
docs/tools.md о том, как устроен инструмент, или полный
список зарегистрированных — 160+ инструментов для разведки, веба, облака, AD,
Kubernetes и постэксплуатации — в docs/tool-list.md.
Навыки — это рекомендательные markdown-заметки, дающие модели межынструментальные
знания по тактике и методикам — когда предпочесть один инструмент другому, как выходные данные двух
инструментов связываются вместе. Они никогда не являются принудительной фазой и
всегда отображаются полностью. См. docs/skills.md.
Каждый запуск взаимодействия сохраняется на диск и может быть превращён в
отчёт (--report), изучен afterward в консоли вопросов и ответов (tradecraft chat) или экспортирован как данные для дообучения SFT/DPO (tradecraft dataset).
См. docs/report.md, docs/post-engagement.md,
и 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
Направление зависимостей одностороннее: 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
Используйте abliterated-модель (с удалённым механизмом отказа по соображениям безопасности) для LLM_MODEL — стандартная модель с настроенной безопасностью откажется выполнять большую часть того, что этому агенту нужно делать в ходе взаимодействия.
Требуемый бинарный файл каждого инструмента (см. его config/tools/<id>.yaml) должен быть доступен в PATH; отсутствующий бинарный файл возвращается модели как ошибка инструмента, а не как сбой. scripts/verify_container_tools.py проверяет, какие из бинарных файлов зарегистрированных инструментов присутствуют. Чтобы получить заведомо рабочий полный набор инструментов без самостоятельной установки всего, см. docs/setup.md о сборке и запуске Docker-образа.
tradecraft 10.0.0.5 --profile web
--profile выбирает подобранный набор инструментов под тип задачи (web,
ad-network, cloud, kubernetes, post-exploitation или full для
всех зарегистрированных инструментов); --tools переопределяет его явным списком.
Деструктивные инструменты по умолчанию отключены — передайте --allow-destructive, чтобы
включить их. Запустите tradecraft --help для полного списка флагов или см.
docs/cli.md для всех подкоманд (chat, report,
dataset, memory) в кратком обзоре.
Сетевая маршрутизация/выход (VPN, шлюз SOCKS/TUN или network_mode контейнера)
реализуется на уровне окружения, а не внутри адаптеров; если задаёте
HTTP_PROXY/HTTPS_PROXY, добавьте хост LLM_BASE_URL в NO_PROXY.
pytest
docs/cli.md — все подкоманды и флаги tradecraft в одном месте.docs/setup.md — сборка/запуск Docker-образа, получение логов, извлечение данных запуска.docs/tools.md — инструменты, адаптеры.docs/tool-list.md — все зарегистрированные инструменты в одном месте.docs/policy.md — ограничение деструктивных инструментов, категории радиуса поражения, бюджет блокировок учётных записей.docs/skills.md — что такое навык, как и когда его добавлять.docs/profiles.md — профили формата взаимодействия, их пересечение, как добавить новый.docs/report.md — генерация отчёта по запуску.docs/post-engagement.md — консоль вопросов и ответов после запуска.docs/finetune.md — превращение запусков взаимодействия в данные для дообучения SFT/DPO.CONTRIBUTING.md — как добавить новый инструмент.