फिर एक स्थानीय लैब, CTF, स्वामित्व वाले ऐप या अधिकृत लक्ष्य से शुरू करें:```text
/doctor
/mode appsec
/runbook run appsec-web-triage http://localhost:3000
/share

महत्वपूर्ण भाग: ऑपरेशन केवल chat में नहीं रहता। numasec काम का एक स्थायी रिकॉर्ड रखता है ताकि agent जारी रख सके, operator समीक्षा कर सके, और report वास्तव में जो हुआ उससे आ सके।

## numasec किस तरह अलग है

अधिकांश AI security tools दो जाल में से एक में फंस जाते हैं: वे केवल बात करते हैं, या वे केवल tools को wrap करते हैं। numasec कुछ अलग करने की कोशिश करता है: agent के काम करते समय workflow को जीवित रखना।

| Compared with | What usually happens | What numasec does |
| --- | --- | --- |
| **Generic AI chats** | अच्छी सलाह, लेकिन वास्तविक कार्य से अलग। | Tools, memory और operation state के साथ terminal workflow के अंदर चलता है। |
| **Generic coding agents** | Repos और tests के लिए बढ़िया, लेकिन security work के आसपास आकार नहीं दिया गया। | Security agents, runbooks, scope, findings, evidence, replay और reports जोड़ता है। |
| **Scanner wrappers** | Fast output, weak context. | Tool output को एक बड़े operation के हिस्से में बदल देता है। |
| **Manual notes** | Flexible, लेकिन सब कुछ बिखर जाता है। | Findings, evidence, replay और reports को जुड़ा रखता है। |
| **Tool servers** | Capabilities को expose करते हैं, लेकिन workflow और memory user पर छोड़ देते हैं। | Tools के चारों ओर security workflow जोड़ता है। |

## Commands

numasec को keyboard से तेज़ रहने के लिए डिज़ाइन किया गया है: operation शुरू करें, agents switch करें, workflows चलाएं, tools का inspect करें, opsec tighten करें, work export करें और बाद में वापस आएं।```text
/doctor                        inspect local tool readiness
/mode appsec                   switch to the AppSec agent
/mode pentest                  switch to the Pentest agent
/agents                        open the agent switcher
/runbook list                  show available security workflows
/runbook run appsec-web-triage <target>
/runbook run web-surface <target>
/operations                    inspect, rename, resume or switch operations
/opsec strict                  tighten operation boundaries
/models                        switch provider or model
/share                         export the active operation bundle
/remediate <observation_id>    turn an observation into remediation guidance
/pwn <target>                  create a scoped pentest operation for a target

### Bun```bash
bun add -g numasec
numasec

### स्रोत से```bash
git clone https://github.com/FrancescoStabile/numasec.git
cd numasec
bun install
cd packages/numasec
bun run build

यह देखने के लिए `/doctor` का उपयोग करें कि वर्तमान मशीन पर क्या उपलब्ध, खराब या अनुपलब्ध है।

## मॉडल और प्रदाता

वह मॉडल लाएँ जिस पर आप भरोसा करते हैं। numasec मॉडल-अज्ञेयवादी है और आपके द्वारा चुने गए मॉडल को एक सुरक्षा वर्कफ़्लो में लपेटता है: टर्मिनल, उपकरण, एजेंट, रनबुक, संचालन स्मृति, निष्कर्ष, साक्ष्य और रिपोर्ट।

समर्थित प्रदाता परिवारों में OpenAI, Anthropic, Google, xAI, Bedrock, OpenRouter, Ollama, Vercel AI Gateway, OpenAI-संगत एंडपॉइंट और स्थानीय मॉडल स्टैक के माध्यम से समर्थित अन्य प्रदाता शामिल हैं।

दांव यह नहीं है कि एक मॉडल जादुई रूप से सुरक्षा को हल करता है। दांव यह है कि अच्छे मॉडल तब अधिक उपयोगी हो जाते हैं जब वे सही सुरक्षा वातावरण के अंदर काम करते हैं।

## आर्किटेक्चर

numasec मॉडल को एक सुरक्षा वर्कफ़्लो से लपेटता है। मॉडल तर्क कर सकता है और कार्य कर सकता है; numasec इसके चारों ओर संचालन रखता है: उपकरण, रनबुक, घटनाएँ, तथ्य, साक्ष्य, रीप्ले, निष्कर्ष और प्रतिफल।```mermaid
flowchart TB
  operator["Operator"] --> console["Terminal console"]
  console --> control["Permissioned / auto execution"]
  control --> agents["Cyber agents"]
  agents --> runbooks["Runbooks"]

  subgraph tool_layer["Tool layer"]
    browser["Browser"]
    http["HTTP"]
    scanner["Scanner"]
    shell["Shell"]
    knowledge["Knowledge broker"]
    vault["Vault"]
  end

  runbooks --> browser
  runbooks --> http
  runbooks --> scanner
  runbooks --> shell
  runbooks --> knowledge
  runbooks --> vault

  subgraph kernel["Cyber operation kernel"]
    ledger["Ledger"]
    facts["Facts"]
    relations["Relations"]
    evidence["Evidence"]
    replay["Replay"]
    workflow["Workflow"]
  end

  browser --> evidence
  http --> evidence
  scanner --> evidence
  shell --> evidence
  knowledge --> facts
  vault --> facts

  ledger --> facts
  facts --> relations
  evidence --> replay
  facts --> workflow

  facts --> lifecycle["Finding lifecycle"]
  relations --> lifecycle
  replay --> lifecycle
  workflow --> deliverables["Reports / share bundles / remediation"]
  lifecycle --> deliverables

  classDef top fill:#04130d,stroke:#00ff88,color:#eafff4,stroke-width:2px;
  classDef tool fill:#061014,stroke:#00c2ff,color:#eaf9ff,stroke-width:1.5px;
  classDef state fill:#0b0f0a,stroke:#7affb2,color:#eafff4,stroke-width:1.5px;
  classDef proofNode fill:#151104,stroke:#ffcc66,color:#fff7df,stroke-width:1.5px;
  classDef findingNode fill:#190808,stroke:#ff5f6d,color:#fff0f0,stroke-width:1.5px;

  class operator,console,control,agents,runbooks top;
  class browser,http,scanner,shell,knowledge,vault tool;
  class ledger,facts,relations,workflow state;
  class evidence,replay,deliverables proofNode;
  class lifecycle findingNode;

मॉडल को अन्वेषण करने की अनुमति है। वर्कफ़्लो को हर विचार को निष्कर्ष के रूप में प्रस्तुत करने की अनुमति नहीं है।

### रैंडम टूल स्पैम के बजाय रनबुक्स

सुरक्षा एजेंट शोरगुल करने लगते हैं जब वे बिना वर्कफ़्लो के टूल्स को कॉल कर सकते हैं। numasec रनबुक्स का उपयोग करता है ताकि एजेंट को एक पहचानने योग्य कार्य आकार में चलते रखा जा सके: सतह मैपिंग, AppSec ट्राइएज, स्कोप्ड पेंटेस्ट कार्य और भविष्य के डोमेन-विशिष्ट वर्कफ़लो।

आज सबसे मजबूत:

- `appsec-web-triage`
- `web-surface`
- `pwn` / पेंटेस्ट स्टार्टर फ्लो

परिपक्वता-लेबल वाली सतहें:

- रिपॉजिटरी AppSec ट्राइएज
- API और प्रमाणीकरण सतह कार्य
- नेटवर्क सतह कार्य
- OSINT लक्ष्य कार्य
- CTF और लैब वर्कफ़लो
- क्लाउड, कंटेनर, IaC और बाइनरी ट्राइएज

## AI सुरक्षा स्लॉप से बचने के लिए बनाया गया

numasec एक सरल नियम के आसपास बनाया गया है: **एजेंट आपको तेज़ी से आगे बढ़ने में मदद कर सकता है, लेकिन वर्कफ़्लो को इसे अतिदावा नहीं करने देना चाहिए।**

यही कारण है कि numasec स्कोप, संचालन स्थिति, निष्कर्ष, साक्ष्य, रीप्ले और रिपोर्ट आउटपुट को ट्रैक करता है।

परिपक्व फोकस:

- AppSec
- Pentest

अन्य साइबर सतहें मौजूद हैं या योजनाबद्ध हैं, लेकिन उन्हें अभी तक समान रूप से परिपक्व के रूप में विपणन नहीं किया गया है।

numasec प्राधिकरण, ऑपरेटर निर्णय, मैन्युअल समीक्षा या विशेष उपकरणों को बदलने का दावा नहीं करता है।

वह ईमानदारी विपणन विनम्रता नहीं है। यह उत्पाद का हिस्सा है। सुरक्षा उपकरण विश्वास खो देते हैं जब वे आत्मविश्वास को प्रमाण के साथ भ्रमित करते हैं।

## रोडमैप

दीर्घकालिक दृष्टि सरल है: **एक ओपन सोर्स AI सुरक्षा एजेंट जो समुदाय के साथ बढ़ सकता है।**

अल्पावधि में, numasec केंद्रित रह रहा है:

- बेहतर AppSec वर्कफ़लो
- बेहतर Pentest वर्कफ़लो
- मजबूत स्थानीय टूल एडेप्टर
- बेहतर साक्ष्य और रीप्ले कैप्चर
- स्वच्छ रिपोर्ट जनरेशन
- अधिक उपयोगी एजेंट
- बेहतर संचालन साझाकरण
- स्पष्ट परिपक्वता लेबल

लंबी अवधि:

- प्रोवेनेंस के साथ OSINT वर्कफ़लो
- CTF और लैब वर्कफ़लो
- क्लाउड, कंटेनर और IaC ट्राइएज
- टीम संचालन
- समीक्षा और हैंडऑफ़
- समृद्ध ज्ञान पैक
- सामुदायिक रनबुक्स

नियम वही रहता है: हर परिपक्व डोमेन को वास्तविक वर्कफ़्लो समर्थन की आवश्यकता होती है, न कि सिर्फ एक प्रॉम्प्ट।

## दस्तावेज़ीकरण

- [संचालन](https://github.com/francescostabile/numasec/blob/HEAD/docs/OPERATIONS.md)
- [उपकरण संदर्भ](https://github.com/francescostabile/numasec/blob/HEAD/docs/TOOLS.md)
- [संचालन फ़ाइल प्रारूप](https://github.com/francescostabile/numasec/blob/HEAD/docs/NUMASEC_FILE_FORMAT.md)
- [परिवर्तन लॉग](https://github.com/francescostabile/numasec/blob/HEAD/CHANGELOG.md)
- [योगदान](https://github.com/francescostabile/numasec/blob/HEAD/CONTRIBUTING.md)
- [सुरक्षा](https://github.com/francescostabile/numasec/blob/HEAD/SECURITY.md)

## विकास```bash
bun install
bun typecheck

cd packages/numasec
bun test --timeout 30000
bun run build

---

पैकेज परीक्षण रिपो रूट से न चलाएं। numasec Bun-first package-local workflows का उपयोग करता है।

## Contributing

सबसे मूल्यवान योगदान numasec को एक बेहतर संचालक बनाते हैं:

- स्पष्ट दायरे और प्रमाण शब्दार्थ के साथ रनबुक;
- पार्सर जो टूल आउटपुट को प्रोवेनेंस-समर्थित तथ्यों में बदलते हैं;
- वास्तविक सुरक्षा उपकरणों के लिए एडेप्टर;
- बेंचमार्क परिदृश्य जिन्हें नकली बनाना कठिन है;
- रिपोर्ट टेम्पलेट जो अतिदावा कम करते हैं;
- TUI पॉलिश जो दबाव में संचालन को पढ़ने में आसान बनाती है।

यदि कोई परिवर्तन एक पुष्ट सुरक्षा दावा बनाता है, तो उसे प्रमाण की आवश्यकता है। यदि कोई निष्कर्ष रिपोर्ट करने योग्य है, तो उसे रिप्ले या एक संरचित छूट की आवश्यकता है।

## Community

सबसे अच्छी प्रतिक्रिया "कूल प्रोजेक्ट" नहीं है।

सबसे अच्छी प्रतिक्रिया है:

- मैंने इसे इस प्रकार के अधिकृत कार्यप्रवाह पर आज़माया
- इस भाग ने मुझे तेज़ बनाया
- इस भाग ने मेरे रास्ते में अड़चन डाली
- इस उपकरण का बेहतर समर्थन होना चाहिए
- यह रनबुक मौजूद होनी चाहिए
- यह निष्कर्ष प्रवाह गलत लगा
- यह रिपोर्ट आउटपुट उपयोगी या बेकार था

बग, कार्यप्रवाह प्रतिक्रिया, रनबुक विचार, एडेप्टर और रिलीज़ प्रश्नों के लिए GitHub issues और discussions का उपयोग करें।

कृपया उदाहरणों को अधिकृत, प्रयोगशाला-आधारित या सुरक्षित रूप से अनामित रखें।

## Help shape numasec

numasec प्रारंभिक है, लेकिन दिशा स्पष्ट है:

**सुरक्षा कार्य को टर्मिनल में रहने वाले AI एजेंट के साथ तेज़, तीखा और कम बिखरा हुआ महसूस कराएं।**

यदि यह उपयोगी लगता है, तो रिपो को स्टार करें, इसे किसी अधिकृत कार्यप्रवाह पर आज़माएं और मुझे बताएं कि यह कहाँ टूटता है।

## License

[GNU Affero General Public License v3.0 or later](https://github.com/francescostabile/numasec/blob/HEAD/LICENSE). numasec का उपयोग अधिकृत सुरक्षा कार्य, अनुसंधान, शिक्षा और रक्षात्मक संचालन के लिए करें।

<p align="center">
  द्वारा निर्मित <a href="https://www.linkedin.com/in/francesco-stabile-dev">Francesco Stabile</a>
  | <a href="https://x.com/Francesco_Sta">@Francesco_Sta</a>
  <br/><sub>यदि numasec आपकी मदद करता है, तो <a href="https://github.com/FrancescoStabile/numasec/stargazers">एक स्टार ड्रॉप करें</a> और वर्कफ़्लो साझा करें।</sub>
</p>