Violin ☤ — Profilo di pentest agentico supervisionato per Hermes

35 playbook · 19 reference · 14 template · guard di esecuzione obbligatorio · nativo per Hermes

Violin è un profilo di pentest agentico nativo per Hermes per penetration test supervisionati e autorizzati — dalla ricognizione alla validazione sicura degli exploit fino al reporting. Utilizza i toolset integrati di Hermes, sette skill instradate e il plugin obbligatorio violin_guard al confine dell'esecuzione sul target. La CLI standalone supporta controlli di rilascio, diagnostica e ripristino amministrativo; i comandi sul target vengono eseguiti tramite il plugin. Violin non aggiunge credenziali specifiche del profilo ed eredita i backend di provider e strumenti già configurati in Hermes.

Avvio rapido · Flusso di lavoro · Strumenti di guardia · Benchmark · Landing page · Discussioni · Sviluppo

Segui Violin? Metti una stella al repository per mantenerlo facilmente reperibile e aiutare altri ingegneri della sicurezza a scoprire il pentesting agentico supervisionato.

Scoperta nella community

Violin è elencato in raccolte curate dalla community tra cui awesome-ai-security, awesome-hermes-skills, awesome-hermes-agent e awesome-infosec.

Copertura di terze parti: analisi tecnica di Starlog e “Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent”.

Per una valutazione indipendente, utilizza il kit per i revisori, che raccoglie il percorso dei benchmark, i limiti noti, il contesto di revisione e un confronto fattuale con i design dei pentest-agent autonomi.

---

Esecuzione controllata del target	I controlli di scope, fase, PTT, skill, ipotesi, cronologia e sincronizzazione vengono eseguiti prima dell'avvio di un comando sul target.
Stato di engagement persistente	Attività PTT, ipotesi, cronologia dei comandi, checkpoint, evidenze e report sopravvivono alla compressione del contesto.
Risultati supportati da evidenze	Una sottomissione tipizzata collega ogni risultato validato a ricevute di esecuzione autenticate.
Metodologia instradata	Un orchestratore di pentest seleziona playbook mirati per web, identità, API, business-logic, sicurezza LLM e misconfigurazioni.
Esecuzione limitata	Comandi singoli, raffiche di comandi, processi in background, revisione batch, controlli heartbeat e cancellazione condividono un unico modello di stato.
Release verificabili	Registrazione dei plugin, schemi, snapshot delle skill, contratti della documentazione, lint, formattazione e l'intera suite di test sono vincolati al rilascio.

Avvio rapido

Installare il profilo

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

Le dipendenze di Guard sono dichiarate in plugins/violin_guard/plugin.yaml. Il nome del plugin, la directory e la configurazione di abilitazione usano tutti violin_guard, così Hermes può risolvere le sue dipendenze senza un workaround sulla directory. Installare le dipendenze nella .venv di sviluppo non le installa in Hermes. Il ciclo di disabilitazione/abilitazione sopra forza l'ammissione delle dipendenze anche quando la configurazione del profilo abilita già il plugin. Verificare la registrazione dopo l'installazione:

hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list

Plugin Doctor dovrebbe riportare 12 strumenti e 5 hook, e violin_guard dovrebbe apparire come toolset abilitato. Riavvia Hermes dopo l'installazione prima di iniziare un engagement. Reinstalla il profilo per migrare un'installazione precedente di violin-guard.

Poi inizia con un target autorizzato e lascia che Violin raccolga lo scope prima di qualsiasi interazione con il target:

Run an authorized penetration test against example.com.

Requisiti

• Hermes Agent 0.21.5 o superiore (il container fissa il commit di rilascio v2026.9.24)
• Python 3.11 e uv per lo sviluppo locale
• Kali Linux o Parrot OS per l'ambiente previsto con gli strumenti di sicurezza
• Autorizzazione scritta e un perimetro approvato

Violin non seleziona un modello o un provider. Configurali in Hermes. Per un default adeguato, usa Qwen3.8 27B in locale oppure DeepSeek V4 Flash tramite un provider ospitato.

Ciclo di vita dell'engagement

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. Inizializza l'engagement e approva scope/scope.yaml.
2. Seleziona un'attività PTT attiva e la relativa skill instradata con violin_record_ptt.
3. Esegui i comandi sul target con violin_exec o violin_exec_burst.
4. Aggiorna le ipotesi man mano che le evidenze ne modificano lo stato.
5. Rivedi ogni batch di comandi delimitato con violin_review_batch.
6. Invia i risultati validati e genera il report finale.
7. Completa la retrospettiva.

Il modello completo delle fasi è:

SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
         → POST_EXPLOITATION / PRIVESC / FLAGS
         → REPORTING → RETROSPECTIVE