Open-source antivirus and firewall for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.
 | Blocca le azioni AI rischiose prima che compromettano la tua macchina. HOL Guard è un livello di sicurezza local-first per agenti AI, strumenti, plugin, skill, server MCP e installazioni di pacchetti. Installa HOL Guard Leggi la documentazione Pacchetto PyPI ( hol-guard)Segnala un problema |
|---|
HOL Guard esamina le azioni degli agenti prima che vengano eseguite: comandi shell, accesso ai file, installazioni di pacchetti e chiamate agli strumenti MCP. Rileva l'esposizione di segreti, le operazioni distruttive, il prompt injection e i rischi della supply chain, quindi consente, blocca o richiede approvazione in base alla tua policy.
Eseguilo localmente senza un account. Usa la CLI e la dashboard locale per gestire la protezione, risolvere le approvazioni e ispezionare la cronologia delle decisioni. Guard Cloud opzionale aggiunge cronologia condivisa, policy di team e gestione della flotta.
Per iniziare · Agenti supportati · Scanner di plugin · Documentazione · Contribuisci con un'estensione · Contribuisci con un adapter · Sviluppo
Richiede Python 3.10 o versioni successive, pipx e un runtime nativo compatibile. Consulta le note sul supporto delle piattaforme e sulla configurazione di Windows ARM64 prima di installare.
pipx install hol-guard
hol-guard init
La procedura guidata al primo avvio rileva gli agenti supportati e ti guida nella configurazione della protezione. Chiede conferma prima di ogni modifica alla configurazione, inclusa l'apertura della dashboard, l'installazione delle integrazioni degli agenti e la connessione di servizi cloud opzionali.
Verifica l'installazione:
hol-guard --version
hol-guard status
Per aggiornare un'installazione esistente:
hol-guard update
Per la configurazione manuale, consulta la guida all'installazione. Le note di rilascio annotate con il contesto di aggiornamento sono disponibili su hol.org/guard/releases; i rilasci grezzi e le prerelease sono sulla pagina delle release di GitHub.
| Superficie | Protezione |
|---|---|
| Comandi shell e accesso ai file | Esamina operazioni distruttive, accesso a file sensibili, esposizione di credenziali e comandi in uscita sospetti. |
| Installazione di pacchetti | Valuta le operazioni supportate dei gestori di pacchetti rispetto alle informazioni sulla supply chain prima dell'installazione. |
| Plugin, skill e configurazione degli agenti | Inventaria gli artefatti locali ed esamina strumenti nuovi o modificati prima dell'avvio. |
| Server e strumenti MCP | Ispeziona la configurazione dei server ed esamina le chiamate agli strumenti tramite hook supportati e proxy gestiti. |
| Prompt e risultati degli strumenti | Analizza gli eventi supportati per individuare prompt injection e contenuti sensibili. |
| Approvazioni ed evidenze | Instrada le decisioni verso i prompt nativi o il centro approvazioni e registra ricevute locali per la revisione. |
Guard si connette tramite hook nativi degli agenti, proxy MCP gestiti e integrazioni di avvio. La copertura dipende dagli eventi esposti da ciascun agente; la matrice di supporto documenta l'applicazione, la consegna delle approvazioni e il comportamento in caso di errore per ogni integrazione.
Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity, ZCode e Devin. Paseo è supportato tramite queste integrazioni native dei provider, con copertura per singolo provider.
Ad esempio, per configurare esplicitamente Codex:
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
La prova a vuoto registra lo stato corrente degli artefatti prima dell'avvio. Per Codex, Guard installa hook nativi pre-tool e rifiuta un avvio gestito se tali hook sono mancanti o disabilitati.
Matrice di supporto degli agenti · Risoluzione dei problemi