Violin ☤ — Perfil de Pentest Hermes Agêntico Supervisionado

35 playbooks · 19 referências · 14 templates · guarda de execução obrigatória · nativo do Hermes

Violin é um perfil de pentest agêntico nativo do Hermes para testes de penetração supervisionados e autorizados — desde o reconhecimento, passando pela validação segura de exploits, até o relatório. Ele utiliza os conjuntos de ferramentas integrados do Hermes, sete skills roteadas e o plugin obrigatório violin_guard na fronteira de execução no alvo. A CLI autônoma oferece verificações de release, diagnósticos e recuperação administrativa; os comandos no alvo são executados através do plugin. Violin não adiciona credenciais específicas do perfil e herda os backends de provedor e de ferramentas já configurados no Hermes.

Início rápido · Fluxo de trabalho · Ferramentas de guarda · Benchmarks · Landing page · Discussões · Desenvolvimento

Acompanhando o Violin? Dê uma estrela ao repositório para mantê-lo fácil de encontrar e ajudar outros engenheiros de segurança a descobrir o pentest agêntico supervisionado.

Descoberta pela comunidade

Violin está listado em coleções curadas pela comunidade, incluindo awesome-ai-security, awesome-hermes-skills, awesome-hermes-agent e awesome-infosec.

Cobertura de terceiros: análise técnica do Starlog e “Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent”.

Para avaliação independente, utilize o kit do revisor, que reúne o caminho de benchmark, os limites conhecidos, o contexto de revisão e uma comparação factual com designs autônomos de agentes de pentest.

---

Execução de alvo protegida	Verificações de escopo, fase, PTT, skill, hipótese, histórico e sincronização são executadas antes de um comando de alvo iniciar.
Estado de engajamento persistente	Tarefas de PTT, hipóteses, histórico de comandos, checkpoints, evidências e relatórios sobrevivem à compressão de contexto.
Descobertas respaldadas por evidências	Uma submissão tipada vincula cada descoberta validada a recibos de execução autenticados.
Metodologia roteada	Um orquestrador de pentest seleciona playbooks focados em web, identidade, API, lógica de negócio, segurança de LLM e configuração incorreta.
Execução limitada	Comandos únicos, rajadas de comandos, processos em segundo plano, revisão em lote, verificações de heartbeat e cancelamento compartilham um único modelo de estado.
Lançamentos verificáveis	Registro de plugins, esquemas, snapshots de skills, contratos de documentação, lint, formatação e a suíte de testes completa são condicionados ao lançamento.

Início rápido

Instalar o perfil

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

As dependências do guard são declaradas em plugins/violin_guard/plugin.yaml. O nome do plugin, o diretório e a configuração de ativação usam todos violin_guard, para que o Hermes possa resolver suas dependências sem um workaround de diretório. Instalar as dependências no .venv de desenvolvimento não as instala no Hermes. O ciclo de desativação/ativação acima força a admissão de dependências mesmo quando a configuração do perfil já ativa o plugin. Verifique o registro após a instalação:

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

O Plugin Doctor deve reportar 12 ferramentas e 5 hooks, e violin_guard deve aparecer como um toolset habilitado. Reinicie o Hermes após a instalação antes de iniciar um engajamento. Reinstale o perfil para migrar uma instalação mais antiga do violin-guard.

Em seguida, comece com um alvo autorizado e deixe o Violin coletar o escopo antes de qualquer interação com o alvo:

Run an authorized penetration test against example.com.

Requisitos

• Hermes Agent 0.21.5 ou mais recente (o contêiner fixa o commit de release v2026.9.24)
• Python 3.11 e uv para desenvolvimento local
• Kali Linux ou Parrot OS para o ambiente esperado de ferramentas de segurança
• Autorização por escrito e um escopo aprovado

O Violin não seleciona um modelo ou provedor. Configure-os no Hermes. Para um padrão capaz, use Qwen3.8 27B localmente ou DeepSeek V4 Flash por meio de um provedor hospedado.

Ciclo de vida do engajamento

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. Inicialize o engajamento e aprove scope/scope.yaml.
2. Selecione uma tarefa PTT ativa e sua skill roteada com violin_record_ptt.
3. Execute comandos de destino com violin_exec ou violin_exec_burst.
4. Atualize as hipóteses conforme as evidências alterarem seu status.
5. Revise cada lote de comandos delimitado com violin_review_batch.
6. Envie os achados validados e gere o relatório final.
7. Conclua a retrospectiva.

O modelo completo de fases é:

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