Violin ☤ — Profil de pentest Hermes agentique supervisé

31 playbooks · 10 références · 11 modèles · garde d'exécution obligatoire · natif Hermes

Violin est un profil de pentest agentique natif Hermes pour des tests d'intrusion supervisés et autorisés — de la reconnaissance à la validation sûre d'exploits, jusqu'au reporting. Il utilise les toolsets intégrés d'Hermes, trois compétences routées et le plugin requis violin-guard à la frontière d'exécution sur cible. Le CLI autonome prend en charge les vérifications de release, les diagnostics et la récupération administrative ; les commandes cibles passent par le plugin. Violin n'ajoute aucun identifiant spécifique au profil et hérite des backends de fournisseur et d'outils déjà configurés dans Hermes.

hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin

Fonctionnalités

Démarrage rapide

# 1. Install the profile
hermes profile install https://github.com/Strategic-Automation/violin

# 2. Start a session
hermes -p violin

# 3. Let Violin ask scoping questions, then run your test
> Run a pentest against example.com

hermes profile use violin

Workflow d'engagement

flowchart LR
    A["1. Scoping"] --> B["2. Recon"]
    B --> C["3. Vuln Research"]
    C --> D["4. Exploitation"]
    D --> E["5. Reporting"]
    E --> F["6. Retrospective"]
    
    A -.->|"clarify"| G("Approval Gate")
    B -.->|"guard check"| G
    C -.->|"guard check"| G
    D -.->|"clarify + guard"| G

    style A fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style B fill:#16213e,stroke:#0f3460,stroke-width:2px
    style C fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style D fill:#16213e,stroke:#0f3460,stroke-width:2px
    style E fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style F fill:#16213e,stroke:#0f3460,stroke-width:2px
    style G fill:#2d2d2d,stroke:#ffd700,stroke-width:2px

Architecture

graph TB
    subgraph "Your Machine"
        HE["Hermes Agent"]
        VI["Violin Profile"]
        GUARD["violin_guard execution + evidence"]
    end
    
    subgraph "Violin Skills"
        SK["pentest orchestrator"]
        WEB["web-attacks skill"]
        AC["access-control skill"]
        PB["31 Playbooks"]
        REF["10 References"]
        TEMP["11 Templates"]
    end
    
    subgraph "Configured Toolsets"
        T["terminal"]
        W["web"]
        B["browser"]
        F["file"]
        CE["code_execution"]
        S["skills"]
        CL["clarify"]
        D["delegation"]
        V["vision"]
        TD["todo"]
        VG["violin_guard"]
    end
    
    LLM["Your LLM Provider"]
    
    HE -->|"hermes -p violin"| VI
    VI -->|"loads"| SK
    VI -->|"requires"| GUARD
    SK -->|"routes to"| WEB & AC & PB
    WEB --> PB
    AC --> PB
    SK --> REF & TEMP
    HE -->|"calls"| T & W & B & F & CE & S & CL & D & V & TD & VG
    HE -->|"inherits"| LLM

    style HE fill:#2d2d2d,stroke:#ffd700,stroke-width:2px
    style VI fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style GUARD fill:#16213e,stroke:#0f3460,stroke-width:2px

Toolsets activés

11 toolsets configurés dans config.yaml (platform_toolsets.cli) : 10 intégrés — terminal, web, browser, file, code_execution, skills, todo, clarify, delegation, vision — plus le toolset du plugin de garde violin_guard.

Isolation de la conversation et de la mémoire

• memory.memory_enabled: false — aucun rappel/écriture mémoire global
• memory.user_profile_enabled: false — aucun accès au profil utilisateur global
• La continuité de l'engagement réside dans les fichiers du projet (documents de périmètre, preuves, rapports)
• Conservez une conversation Hermes par engagement ; après compression, reprenez dans cette conversation depuis $ENG_DIR/state/

Modèle de sécurité

flowchart LR
    subgraph "Layer 1"
        A["9 Scoping Questions"]
        B["Written Authorisation"]
    end
    subgraph "Layer 2"
        C["violin_guard.py validate-scope"]
    end
    subgraph "Layer 3"
        D["violin_guard.py check-command"]
    end
    subgraph "Layer 4"
        E["clarify approval gate"]
    end
    subgraph "Layer 5"
        F["Standards & Blocked Actions"]
    end
    
    A --> B --> C --> D --> E --> F

• Tests autorisés uniquement — aucune sonde avant la fin du cadrage
• Portes d'approbation — le périmètre, la recon active et l'exploitation exigent chacun une approbation explicite de l'utilisateur
• Vérification de la garde — chaque commande touchant la cible est validée via violin_exec ou un autre outil de garde typé. violin_exec n'a pas de liste blanche de binaires, donc tout outil CLI Kali/Parrot non interactif installé peut cibler l'hôte explicitement dans le périmètre tant que le périmètre, la phase, le PTT, l'hypothèse, l'historique, les preuves, le délai d'attente et les portes de synchronisation restent actifs. Le hook de plugin pre_tool_call de Violin bloque génériquement les littéraux de cible dans les commandes terminal brutes au lieu de maintenir une liste partielle de noms d'outils. Le CLI expose la même vérification pour les diagnostics (exit 0=autorisé, 1=bloqué, 2=révision)
• Non destructif par défaut — exploitation limitée à un PoC sûr et reproductible
• Preuves d'abord — chaque constat appuyé par une sortie d'outil reproductible, des captures d'écran, des paires requête/réponse
• Validation exploit d'abord — aucune hypothèse ne passe à Validated sans commande de vérification
• Récupération avec état — les résumés de phase et les points de contrôle restaurent l'engagement en cours après compression du contexte sans démarrer une nouvelle conversation
• Garde auto-explicative — violin_status (ou python scripts/violin_guard.py status --eng-dir "$ENG_DIR") affiche la tâche et la phase actives, les commandes en attente et leurs phases requises, les exigences de phase, l'état de la compétence, les bloqueurs et les prochaines actions exactes sans exécuter de commande

Politique de sécurité complète : skills/pentest/references/standards.md. Actions interdites : .hermes.md §Forbidden Behaviour.

Structure du dépôt

violin/
├── .hermes.md              # Project-level agent context
├── SOUL.md                 # Agent identity — senior pentester persona
├── config.yaml             # Profile config (toolsets, safety, memory)
├── distribution.yaml       # Hermes distribution manifest
├── plugins/violin_guard/   # Required Hermes guard plugin and execution boundary
│   ├── bash_ast.py         # bashlex AST command tokenization and parsing
│   ├── terminal_policy.py  # AST-based best-effort blocks for target-touching raw terminal calls
│   ├── targets.py          # Scope enforcement using netaddr and yarl URL parsing
│   ├── schemas.py          # Pydantic v2 tool schemas and validation
│   └── code_execution_audit.py # Engagement audit contract for execute_code
├── scripts/                # CLI and release smoke helpers
│   ├── violin_guard.py     # Diagnostic/admin CLI over the plugin modules
│   ├── smoke-test.sh       # Linux/macOS release smoke
│   ├── smoke-test.ps1      # Windows supplemental smoke
│   └── kali.sh             # Docker Kali helper
└── skills/
    ├── pentest/            # Engagement orchestrator (23 playbooks, 10 refs, 11 templates)
    │   ├── SKILL.md
    │   ├── playbooks/      # 7 operational + 16 vulnerability-class playbooks
    │   ├── references/     # 10 reference files
    │   └── templates/      # 11 templates (reports, evidence, methodology, contracts)
    ├── web-attacks/        # Routed skill — 5 injection/web playbooks (SQLi, XSS, SSRF, cmdi, traversal)
    └── access-control/     # Routed skill — 3 auth/authorisation playbooks (auth-bypass, IDOR, JWT)

Vérification de la release

python scripts/violin_guard.py check-release

Valide le manifeste du plugin et les outils enregistrés, l'import de plugin isolé de style Hermes, les références de compétences obsolètes, Ruff et la suite pytest complète.

Les compétences Hermes sont chargées à la demande et appliquées par les reçus Violin. Commencez par pentest, puis utilisez violin_record_ptt pour sélectionner la compétence requise par la route. Le premier appel prépare son contenu skill_view réel sans modifier le PTT ; répétez la même transition après que ce résultat d'outil est renvoyé au modèle pour la lier. violin_status rapporte la route, la liaison, la génération de contexte, l'action de récupération et tout marqueur hérité obsolète. L'activité cible et navigateur est bloquée uniquement dans le même appel de modèle que la livraison ou la liaison, puis s'ouvre automatiquement à la prochaine continuation de boucle d'outil.

Optionnel : conteneur Docker Kali

docker pull kalilinux/kali-rolling
docker create -it --name kali-pentest \
  -v /path/to/violin/engagements:/engagements \
  kalilinux/kali-rolling bash
docker start kali-pentest
docker exec kali-pentest apt update
docker exec kali-pentest apt install -y kali-linux-headless

Contribuer

Voir CONTRIBUTING.md pour la configuration de développement, le processus de PR et le style de code.

Sécurité

Voir SECURITY.md pour signaler des vulnérabilités.

Licence

MIT — voir LICENSE.