LLM-संचालित सुरक्षा-परीक्षण एजेंट जो किसी लक्ष्य के विरुद्ध एक सतत टूल-कॉलिंग लूप चलाता है, जिसमें 160+ रेकॉन, वेब, क्लाउड, AD और पोस्ट-एक्सप्लॉइटेशन टूल एडाप्टर और सहेजी गई रन रिपोर्टें शामिल हैं।
एक LLM-संचालित सुरक्षा-परीक्षण एजेंट: एक एकल सतत टूल-कॉलिंग लूप, न कि चरणबद्ध recon→exploit पाइपलाइन। मॉडल यह तय करता है कि वास्तविक लक्ष्य के विरुद्ध, बारी-बारी से, आगे क्या चलाना है।
अस्वीकरण: यदि ठीक से कॉन्फ़िगर न किया जाए तो Tradecraft के टूल्स स्थायी क्षति पहुँचा सकते हैं। इसका उपयोग केवल उन लक्ष्यों के विरुद्ध करें जिनका आप स्वामी हैं या जिनका परीक्षण करने की आपके पास स्पष्ट अनुमति है। डिफ़ॉल्ट पर निर्भर न रहें — अपने पहले एंगेजमेंट से पहले कॉन्फ़िगरेशन (
docs/tools.md,docs/policy.md,docs/profiles.md) को समझें।
टूल्स वे क्रियाएँ हैं जिन्हें मॉडल कॉल कर सकता है — प्रत्येक एक YAML कॉन्ट्रैक्ट
(यह क्या करता है, इसे कौन-से इनपुट चाहिए) के साथ-साथ एक अडैप्टर जो एक
वास्तविक कमांड निष्पादित करता है और उसके आउटपुट को संरचित डेटा में पार्स करता है। यह देखने के लिए कि
एक टूल कैसे बनाया जाता है, docs/tools.md देखें, या recon, web, cloud, AD,
Kubernetes, और post-exploitation में पंजीकृत सभी चीज़ों की पूरी सूची — 160+ टूल्स — के लिए
docs/tool-list.md देखें।
स्किल्स सलाहकारी markdown नोट्स हैं जो मॉडल को क्रॉस-टूल
ट्रेडक्राफ्ट ज्ञान देते हैं — कब एक टूल को दूसरे पर प्राथमिकता दें, दो
टूल्स के आउटपुट कैसे एक साथ श्रृंखलाबद्ध होते हैं। ये कभी भी लागू किया गया चरण नहीं होते, और
ये हमेशा पूर्ण रूप में प्रस्तुत किए जाते हैं। docs/skills.md देखें।
प्रत्येक एंगेजमेंट रन डिस्क पर सहेजा जाता है और इसे
रिपोर्ट में बदला जा सकता है (--report), बाद में Q&A कंसोल (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
LLM_MODEL के लिए एक abliterated (safety-refusal-removed) मॉडल का उपयोग करें — एक मानक safety-tuned मॉडल इस एजेंट को mid-engagement में जो करने की आवश्यकता होती है, उसके बड़े हिस्से को अस्वीकार कर देगा।
प्रत्येक टूल का आवश्यक बाइनरी (इसका config/tools/<id>.yaml देखें) PATH पर होना चाहिए; अनुपलब्ध बाइनरी मॉडल को टूल त्रुटि के रूप में लौटाई जाती है, क्रैश के रूप में नहीं। scripts/verify_container_tools.py जाँचता है कि पंजीकृत टूल्स में से कौन-सी बाइनरियाँ मौजूद हैं। सब कुछ स्वयं इंस्टॉल किए बिना एक ज्ञात-अच्छे पूर्ण टूलसेट के लिए, Docker इमेज बनाने और चलाने हेतु docs/setup.md देखें।
tradecraft 10.0.0.5 --profile web
--profile एंगेजमेंट के स्वरूप के लिए एक क्यूरेटेड टूल सेट चुनता है (web,
ad-network, cloud, kubernetes, post-exploitation, या हर पंजीकृत टूल के लिए
full); --tools इसे एक स्पष्ट सूची से ओवरराइड करता है।
विनाशकारी टूल डिफ़ॉल्ट रूप से बंद रहते हैं — इन्हें सक्षम करने के लिए
--allow-destructive पास करें। पूरी फ़्लैग सूची के लिए tradecraft --help चलाएँ, या
हर सबकमांड (chat, report, dataset, memory) को एक नज़र में देखने के लिए
docs/cli.md देखें।
नेटवर्क रूटिंग/एग्रेस (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 — रन के बाद का Q&A कंसोल।docs/finetune.md — एंगेजमेंट रन को SFT/DPO फ़ाइन-ट्यूनिंग डेटा में बदलना।CONTRIBUTING.md — नया टूल कैसे जोड़ें।हमारे समुदाय द्वारा सबसे अधिक उपयोग किए जाने वाले उपकरण खोजें।
अभी तक कोई लोकप्रियता डेटा नहीं है।