हर्मीस के लिए एजेंटिक पेंटेस्ट प्रोफ़ाइल: अधिकृत रिकॉन, वेब/एक्सेस-कंट्रोल हमलों, सुरक्षित एक्सप्लॉइट सत्यापन, और गार्ड गेट्स के साथ साक्ष्य-आधारित रिपोर्टिंग के लिए 31 प्लेबुक।
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/50022/55f1c11f1fa53cb32838b487d5b5b6f1745b609c7123ce0a2b28ff21108c765b.png" alt="Violin" width="256"/>
</p>
<h1 align="center">Violin ☤ — पर्यवेक्षित एजेंटिक हर्मीस पेंटेस्ट प्रोफ़ाइल</h1>
<p align="center">
<a href="https://github.com/Strategic-Automation/violin"><img src="https://img.shields.io/badge/Status-Release%20Ready-2ea44f?style=for-the-badge" alt="Release Ready"></a>
<a href="https://github.com/Strategic-Automation/violin/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License: MIT"></a>
<a href="https://hermes-agent.nousresearch.com/"><img src="https://img.shields.io/badge/Hermes-%3E=0.21.5-FFD700?style=for-the-badge" alt="Hermes >=0.21.5"></a>
<a href="https://www.kali.org/"><img src="https://img.shields.io/badge/Kali%20Linux-557C94?style=for-the-badge&logo=kali-linux&logoColor=white" alt="Kali Linux"></a>
<a href="https://www.parrotsec.org/"><img src="https://img.shields.io/badge/Parrot%20OS-2E8B57?style=for-the-badge" alt="Parrot OS"></a>
<a href="https://strategic-automation.github.io/violin/"><img src="https://img.shields.io/badge/Site-Landing%20page-FF3B4A?style=for-the-badge" alt="Landing page"></a>
<a href="https://github.com/Strategic-Automation/violin/stargazers"><img src="https://img.shields.io/github/stars/Strategic-Automation/violin?style=for-the-badge&color=FFD166" alt="GitHub stars"></a>
</p>
<p align="center">
<b>35 प्लेबुक · 19 संदर्भ · 14 टेम्पलेट · अनिवार्य निष्पादन गार्ड · हर्मीस-नेटिव</b>
</p>
Violin, पर्यवेक्षित और अधिकृत पेनेट्रेशन टेस्ट के लिए एक **हर्मीस-नेटिव एजेंटिक पेंटेस्ट प्रोफ़ाइल** है — रेकॉनिसेंस से लेकर सुरक्षित एक्सप्लॉइट सत्यापन तक और रिपोर्टिंग तक। यह हर्मीस के अंतर्निहित टूलसेट, सात रूटेड स्किल्स, और लक्ष्य-निष्पादन सीमा पर अनिवार्य `violin_guard` प्लगइन का उपयोग करता है। स्टैंडअलोन CLI रिलीज़ जाँच, डायग्नोस्टिक्स और प्रशासनिक रिकवरी का समर्थन करता है; लक्ष्य कमांड प्लगइन के माध्यम से चलते हैं। Violin कोई प्रोफ़ाइल-विशिष्ट क्रेडेंशियल नहीं जोड़ता और हर्मीस में पहले से कॉन्फ़िगर किए गए प्रोवाइडर और टूल बैकएंड को विरासत में लेता है।
<p align="center">
<a href="#quick-start">त्वरित शुरुआत</a> ·
<a href="#engagement-lifecycle">वर्कफ़्लो</a> ·
<a href="#guard-tools">गार्ड टूल्स</a> ·
<a href="#benchmarks">बेंचमार्क</a> ·
<a href="https://strategic-automation.github.io/violin/">लैंडिंग पेज</a> ·
<a href="https://github.com/Strategic-Automation/violin/discussions">चर्चाएँ</a> ·
<a href="#development">विकास</a>
</p>
<p align="center">
<strong>Violin का अनुसरण कर रहे हैं?</strong>
<a href="https://github.com/Strategic-Automation/violin/stargazers">रिपॉज़िटरी को स्टार करें</a>
ताकि इसे खोजना आसान बना रहे और अन्य सुरक्षा इंजीनियरों को पर्यवेक्षित एजेंटिक पेंटेस्टिंग खोजने में मदद मिले।
</p>
### समुदाय खोज
Violin समुदाय-क्यूरेटेड संग्रहों में सूचीबद्ध है, जिनमें शामिल हैं
[awesome-ai-security](https://github.com/gmh5225/awesome-ai-security),
[awesome-hermes-skills](https://github.com/ZeroPointRepo/awesome-hermes-skills),
[awesome-hermes-agent](https://github.com/Anil-matcha/awesome-hermes-agent), और
[awesome-infosec](https://github.com/onlurking/awesome-infosec).
तृतीय-पक्ष कवरेज:
[Starlog तकनीकी विश्लेषण](https://starlog.is/articles/cybersecurity/strategic-automation-violin) और
[“Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent”](https://hamradio.my/violin-supervised-agentic-pentest-profile-hermes/).
स्वतंत्र मूल्यांकन के लिए,
[समीक्षक किट](https://strategic-automation.github.io/violin/review.html) का उपयोग करें, जो
बेंचमार्क पथ, ज्ञात सीमाएँ, समीक्षा संदर्भ, और स्वायत्त पेंटेस्ट-एजेंट डिज़ाइनों के साथ एक तथ्यात्मक
तुलना एकत्र करता है।
---
<table>
<tr><td width="240"><strong>संरक्षित लक्ष्य निष्पादन</strong></td><td>लक्ष्य कमांड शुरू होने से पहले स्कोप, फ़ेज़, PTT, स्किल, परिकल्पना, इतिहास और सिंक्रोनाइज़ेशन जाँचें चलती हैं।</td></tr>
<tr><td><strong>स्थायी एंगेजमेंट स्थिति</strong></td><td>PTT कार्य, परिकल्पनाएँ, कमांड इतिहास, चेकपॉइंट, साक्ष्य और रिपोर्टें कॉन्टेक्स्ट कम्प्रेशन के बाद भी बनी रहती हैं।</td></tr>
<tr><td><strong>साक्ष्य-समर्थित निष्कर्ष</strong></td><td>एक टाइप्ड सबमिशन प्रत्येक सत्यापित निष्कर्ष को प्रमाणित निष्पादन रसीदों से जोड़ता है।</td></tr>
<tr><td><strong>रूटेड कार्यप्रणाली</strong></td><td>एक पेंटेस्ट ऑर्केस्ट्रेटर केंद्रित web, identity, API, business-logic, LLM-security और misconfiguration प्लेबुक्स का चयन करता है।</td></tr>
<tr><td><strong>सीमित निष्पादन</strong></td><td>एकल कमांड, कमांड बर्स्ट, बैकग्राउंड प्रोसेस, बैच समीक्षा, हार्टबीट जाँच और रद्दीकरण एक ही स्टेट मॉडल साझा करते हैं।</td></tr>
<tr><td><strong>सत्यापन-योग्य रिलीज़</strong></td><td>प्लगइन पंजीकरण, स्कीमा, स्किल स्नैपशॉट, दस्तावेज़ीकरण अनुबंध, lint, फ़ॉर्मेटिंग और पूरा टेस्ट सूट रिलीज़-गेटेड हैं।</td></tr>
</table>
## त्वरित शुरुआत
### प्रोफ़ाइल इंस्टॉल करें
```bash
hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin plugins disable violin_guard
hermes -p violin plugins enable violin_guard --no-allow-tool-override
hermes -p violin
```
Guard निर्भरताएँ `plugins/violin_guard/plugin.yaml` में घोषित की गई हैं। प्लगइन का नाम, निर्देशिका, और सक्षम कॉन्फ़िगरेशन सभी `violin_guard` का उपयोग करते हैं, इसलिए Hermes बिना किसी निर्देशिका वर्कअराउंड के इसकी निर्भरताओं को हल कर सकता है। विकास `.venv` में निर्भरताएँ स्थापित करने से वे Hermes में स्थापित नहीं होती हैं। ऊपर दिया गया disable/enable चक्र निर्भरता प्रवेश को बाध्य करता है, भले ही प्रोफ़ाइल कॉन्फ़िगरेशन पहले से ही प्लगइन को सक्षम करता हो। स्थापना के बाद पंजीकरण सत्यापित करें:
```bash
hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list
```
Plugin Doctor को 12 टूल्स और 5 हुक्स की रिपोर्ट करनी चाहिए, और `violin_guard` एक सक्षम टूलसेट के रूप में दिखना चाहिए। एंगेजमेंट शुरू करने से पहले इंस्टॉलेशन के बाद Hermes को पुनः आरंभ करें। पुराने `violin-guard` इंस्टॉलेशन को माइग्रेट करने के लिए प्रोफ़ाइल को पुनः इंस्टॉल करें।
फिर एक अधिकृत लक्ष्य से शुरू करें और किसी भी लक्ष्य इंटरैक्शन से पहले Violin को स्कोप एकत्र करने दें:
```text
Run an authorized penetration test against example.com.
```
### आवश्यकताएँ
- [Hermes Agent](https://hermes-agent.nousresearch.com/) 0.21.5 या नया (कंटेनर `v2026.9.24` रिलीज़ कमिट को पिन करता है)
- स्थानीय विकास के लिए Python 3.11 और `uv`
- अपेक्षित सुरक्षा-टूल वातावरण के लिए Kali Linux या Parrot OS
- लिखित प्राधिकरण और एक स्वीकृत स्कोप
Violin किसी मॉडल या प्रदाता का चयन नहीं करता। इन्हें Hermes में कॉन्फ़िगर करें। एक
सक्षम डिफ़ॉल्ट के लिए, स्थानीय रूप से **Qwen3.8 27B** या होस्टेड प्रदाता के माध्यम से
**DeepSeek V4 Flash** का उपयोग करें।
## एंगेजमेंट जीवनचक्र
```mermaid
flowchart LR
S[Scope] --> R[Recon]
R --> V[Vulnerability research]
V --> E[Exploit validation]
E --> P[Reporting]
P --> X[Retrospective]
G[Violin Guard] -. validates .-> R
G -. validates .-> V
G -. validates .-> E
```
1. एंगेजमेंट प्रारंभ करें और `scope/scope.yaml` को स्वीकृत करें।
2. `violin_record_ptt` के साथ एक सक्रिय PTT कार्य और उसका रूट किया गया कौशल चुनें।
3. `violin_exec` या `violin_exec_burst` के साथ लक्ष्य कमांड चलाएँ।
4. साक्ष्य द्वारा उनकी स्थिति बदलने पर परिकल्पनाओं को अपडेट करें।
5. `violin_review_batch` के साथ प्रत्येक सीमित कमांड बैच की समीक्षा करें।
6. सत्यापित निष्कर्ष सबमिट करें और अंतिम रिपोर्ट तैयार करें।
7. पश्चदृष्टि (retrospective) पूर्ण करें।
पूर्ण चरण मॉडल है:
```text
SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
→ POST_EXPLOITATION / PRIVESC / FLAGS
→ REPORTING → RETROSPECTIVE
```
एक नए चरण में काम शुरू करने के लिए उस चरण के अंतर्गत एक PTT कार्य आवश्यक है। मौजूदा
कार्यों को चरण अनुभागों के बीच स्थानांतरित नहीं किया जाता है।
## गार्ड टूल्स
प्लगइन एक टाइप्ड रजिस्ट्री से बारह Hermes टूल्स को पंजीकृत करता है:
| टूल | उद्देश्य |
|---|---|
| `violin_record_ptt` | एक PTT कार्य बनाएँ, प्रारंभ करें, रीफ़्रेश करें, बंद करें, या रद्द करें |
| `violin_record_hypothesis` | एक स्कोप्ड परिकल्पना बनाएँ या अपडेट करें |
| `violin_submit_finding` | इसकी हस्ताक्षरित निष्पादन रसीदों से बंधा एक सत्यापित निष्कर्ष सबमिट करें |
| `violin_exec` | एक गार्डेड कमांड निष्पादित करें |
| `violin_exec_burst` | एक सीमित कमांड फ़ाइल निष्पादित करें |
| `violin_exec_status` | पृष्ठभूमि निष्पादन स्थिति पढ़ें |
| `violin_exec_cancel` | ट्रैक किए गए पृष्ठभूमि निष्पादन को रद्द करें |
| `violin_review_batch` | एक पूर्ण बैच की समीक्षा करें और स्थिति स्थिर करें |
| `violin_rebind_pending_batch` | पुष्टि के बाद एक लंबित बैच को रीबाइंड करें |
| `violin_heartbeat_done` | एक पूर्ण हार्टबीट समीक्षा साफ़ करें |
| `violin_target` | स्वीकृत मूल्यांकन लक्ष्य को हल करें |
| `violin_status` | वर्तमान कार्यों, कौशलों और अवरोधकों को समझाएँ |
`violin_exec` सामान्य लक्ष्य-कमांड सीमा है। कोई
टूल-विशिष्ट निष्पादन एडाप्टर या बाइनरी अनुमति-सूचियाँ नहीं हैं। स्थापित
गैर-इंटरैक्टिव टूल्स केवल एंगेजमेंट गेट्स पास होने के बाद ही चल सकते हैं।
रॉ-टर्मिनल हुक एक बेस्ट-एफ़र्ट सुरक्षा जाल है, नेटवर्क कंटेनमेंट नहीं।
`terminal` का उपयोग केवल होस्ट-लोकल तैयारी और प्रशासन के लिए करें।
## सुरक्षा मॉडल
```mermaid
flowchart LR
A[Written authorization] --> B[Approved scope]
B --> C[Active phase task]
C --> D[Skill and hypothesis gates]
D --> E[Guarded execution]
E --> F[Evidence receipt]
F --> G[Batch review]
```
- दायरे की स्वीकृति और बूटस्ट्रैप सत्यापन से पहले लक्ष्य के साथ कोई इंटरैक्शन नहीं।
- लक्ष्य कमांड के लिए कोई कच्चा शेल निष्पादन नहीं।
- स्पष्ट लिखित प्राधिकरण के बिना कोई विनाशकारी, विघटनकारी, क्रेडेंशियल, पर्सिस्टेंस, स्टेल्थ, या
तृतीय-पक्ष कार्रवाई नहीं।
- कच्चा साक्ष्य `$ENG_DIR/evidence/<phase>/` के अंतर्गत रहता है।
- सीक्रेट्स, डंप, और प्रूफ आउटपुट `$ENG_DIR/state/` से बाहर रहते हैं।
- कॉन्टेक्स्ट कम्प्रेशन वर्तमान Hermes
वार्तालाप में एंगेजमेंट फ़ाइलों से फिर से शुरू होता है।
विस्तृत नीति
[`skills/pentest/references/standards.md`](https://github.com/strategic-automation/violin/blob/master/skills/pentest/references/standards.md) में है।
## एंगेजमेंट स्थिति
`init-engagement` मानक कार्यशील संरचना बनाता है:
```text
$ENG_DIR/
├── scope/
│ └── scope.yaml
├── state/
│ ├── ptt.md
│ ├── history.md
│ └── checkpoint.json
├── hypotheses.md
├── evidence/
├── reporting/
└── retrospective/
```
### Violin 3.3 से अपग्रेड करना
Violin 4.0 executor स्थिति को `state/runtime.json` में संग्रहीत करता है और 3.3 की `sync.json`, `counts.json`, या `heartbeat.json` फ़ाइलों को माइग्रेट नहीं करता है। एक नई निर्देशिका में नया engagement शुरू करें; 3.3 निर्देशिका को ऐतिहासिक रिकॉर्ड के रूप में रखें। इसकी निर्देशिका का पुनः उपयोग करने पर legacy state फ़ाइलें यथावत रह जाती हैं, इसलिए Violin 4.0 इसे अस्वीकार कर देगा।
### Skill delivery
Skills मांग पर लोड होती हैं। किसी routed skill के लिए पहला `violin_record_ptt` कॉल PTT को बदले बिना `skill_prepared` लौटा सकता है। Hermes द्वारा skill सामग्री वितरित करने के बाद, receipt को बाइंड करने और task परिवर्तन लागू करने के लिए transition को दोहराएं। `violin_status` सटीक recovery action की रिपोर्ट करता है।
`.skill-loaded-*` जैसी marker फ़ाइलें skill delivery सिद्ध नहीं करती हैं।
## Routed skills
| Skill | Coverage |
|---|---|
| `pentest` | Scope, lifecycle, recon, exploitation, reporting, closeout |
| `web-app` | Injection, SSRF, traversal, deserialization, client-side flaws |
| `identity-auth` | Authentication, authorization, IDOR, JWT, CSRF, cryptography |
| `api-testing` | REST, SOAP, GraphQL, WebSocket |
| `business-logic` | Workflow, pricing, coupon, quota, referral, race conditions |
| `llm-security` | Prompt injection, MCP, JSON-RPC |
| `misconfig` | Deployment, error handling, observability, obscurity |
Orchestrator केवल वर्तमान task के लिए आवश्यक phase सामग्री और specialist playbook लोड करता है।
## Administrative CLI
CLI guarded target execution का स्थान नहीं लेता है।
```bash
python scripts/violin_guard.py --help
python scripts/violin_guard.py init-engagement engagements/example --host example.com
python scripts/violin_guard.py check-bootstrap --eng-dir engagements/example
python scripts/violin_guard.py status --eng-dir engagements/example
python scripts/violin_guard.py generate-closeout --eng-dir engagements/example
python scripts/violin_guard.py check-release
```
`check-command` निदान के लिए प्रवेश जाँच प्रदान करता है और दिए गए कमांड को निष्पादित नहीं करता है।
## आर्किटेक्चर
```text
plugins/violin_guard/
├── core/
│ ├── commands/ shell parsing, targets, HTTP proof
│ ├── engagement/ state, PTT, phases, hypotheses, bootstrap
│ ├── evidence/ findings, history, receipts, redaction
│ └── skills/ skill policy and receipts
├── gates/ command, scope, hypothesis, terminal policies
├── engine/ execution, runtime backend, code audit, release checks
├── handlers/ public Hermes tool handlers
├── hooks.py Hermes lifecycle hooks
└── registry.py registered tool definitions
skills/ orchestrator, routed skills, playbooks, references
benchmark/ runner, scorer, proof checks, calibration fixtures
scripts/ administrative CLI and platform smoke tests
tests/ runtime, integration, documentation, release tests
```
## बेंचमार्क
रिपॉज़िटरी में Escape Duck Store परिभाषा के साथ-साथ ज्ञात-अच्छे और
ज्ञात-खराब स्कोरर फ़िक्स्चर शामिल हैं। कैलिब्रेशन यह सिद्ध करता है कि स्कोरर उन
फ़िक्स्चर को संभालता है; यह लाइव-एजेंट रिकॉल, वर्कफ़्लो पूर्णता, या
रिपोर्ट गुणवत्ता को स्थापित नहीं करता है।
```bash
uv run python -m benchmark.score --calibrate known-good
uv run python -m benchmark.score --calibrate known-bad
uv run python -m benchmark.run \
--target http://localhost:<published-port> \
--provider <provider> \
--api-base <openai-compatible-base-url> \
--model <model-id> \
--target-isolation-id escape-duck-store-2026-04:<image-digest-or-reset-id>
```
क्रेडिबल परिणाम के लिए स्कोर प्रकाशित करने से पहले [बेंचमार्क कार्यप्रणाली](https://github.com/strategic-automation/violin/blob/master/docs/BENCHMARKS.md) पढ़ें।
यह प्रमाण, पुनरुत्पादन क्षमता, निजी मूल्यांकन और प्रकटीकरण
आवश्यकताओं को परिभाषित करता है।
## विकास
```bash
uv sync --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run python scripts/violin_guard.py check-release
```
रिलीज़ गेट संस्करण सतहों, पृथक प्लगइन आयात, पंजीकृत
टूल्स, जनरेट किए गए स्कीमा, स्किल स्नैपशॉट, दस्तावेज़ीकरण अनुबंध, Ruff, और
पूर्ण परीक्षण सूट की जाँच करता है।
प्लेटफ़ॉर्म स्मोक परीक्षण:
- `scripts/smoke-test.sh` — Linux और Kali/Parrot रिलीज़ स्मोक
- `scripts/smoke-test.ps1` — Windows बूटस्ट्रैप, स्कोप, और लक्ष्य-रिज़ॉल्यूशन
स्मोक; स्किल डिलीवरी और लक्ष्य निष्पादन के लिए Hermes आवश्यक है
योगदान नियमों के लिए [CONTRIBUTING.md](https://github.com/strategic-automation/violin/blob/master/CONTRIBUTING.md) देखें और
निजी भेद्यता रिपोर्टिंग के लिए [SECURITY.md](https://github.com/strategic-automation/violin/blob/master/SECURITY.md) देखें।
## ज़िम्मेदार उपयोग
Violin अधिकृत सुरक्षा आकलन के लिए है। ऑपरेटर स्कोप, अनुमोदन, लक्ष्य स्वामित्व, डेटा हैंडलिंग, और स्थानीय कानून के लिए ज़िम्मेदार हैं।
## Violin का समर्थन करें
Violin Strategic Automation Ltd. द्वारा अनुरक्षित एक ओपन-सोर्स प्रोजेक्ट है।
यदि Violin आपके या आपके संगठन के लिए उपयोगी है, तो आप
[इसके निरंतर विकास को प्रायोजित कर सकते हैं](https://github.com/sponsors/Strategic-Automation)।
प्रायोजन निरंतर विकास, परीक्षण, दस्तावेज़ीकरण,
संगतता कार्य, और रिलीज़ का समर्थन करता है।
Violin MIT लाइसेंस के अंतर्गत उपलब्ध रहता है। प्रायोजन में
गारंटीकृत सहायता, फ़ीचर प्राथमिकता, या सुरक्षा नीति पर प्रभाव शामिल नहीं है।
## लाइसेंस
MIT — देखें [LICENSE](https://github.com/strategic-automation/violin/blob/master/LICENSE)।