hol-guard

给 AI 代理装杀毒软件,实时拦截危险操作和攻击

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 256 🐛 待处理 91 👀 关注 2
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1080
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,可自行部署,免费使用。

项目预览

hol-guard 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队hashgraph-online
定价模式🏷️完全免费
价格说明开源项目,可自行部署,免费使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Rust
技术栈/模型agent-security,ai-agent-security,ai-agents,ai-antivirus,ai-security,claude-code,cursor,devsecops,gemini-cli,mcp,mcp-security,openclaw,opencode,prompt-injection,runtime-security,secrets-detection,security,security-scanner,supply-chain-security,vulnify
GitHub 星标★ 1080
上线时间2026-03-28 00:00:00
代码更新2026-11-09
仓库体积464.4 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数3

项目介绍

hol-guard 是一个面向 AI 智能体的开源防病毒工具,旨在解决 AI 代理在运行时面临的多类安全威胁。它能够实时拦截高风险工具调用、敏感凭据访问、提示注入攻击、恶意软件包、MCP 服务器、插件及技能等。该项目基于 Python 实现,支持与 Claude Code、Codex、Cursor、Gemini CLI 等主流 AI 编程助手集成,通过运行时监控和策略控制,为 AI 代理提供类似传统杀毒软件的保护层。其核心能力包括风险行为阻断、秘密访问控制、供应链防护和上下文感知的威胁检测,帮助开发者在 DevSecOps 流程中加固 AI 应用的安全性。作为早期项目,它聚焦于 AI 代理生态中日益突出的安全问题,提供轻量级、可嵌入的防护方案。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1080

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 6 步

环境要求

  • Python 3.10 或更高版本
  • 已安装 pipx(用于隔离安装命令行工具)
  • 与平台匹配的原生运行时(Windows ARM64 等平台需先查阅官方平台支持说明)
  • 可选:与 Claude Code、Codex、Cursor、Gemini CLI 等智能体客户端集成

安装与启动步骤

  1. 1安装 pipx

    hol-guard 通过 pipx 安装,先确认本机已有 pipx;已安装可跳过此步。

    python -m pip install --user pipx
    python -m pipx ensurepath
  2. 2安装 hol-guard

    用 pipx 安装 hol-guard 到独立环境,避免污染系统 Python 依赖。

    pipx install hol-guard
  3. 3运行首次配置向导

    向导会自动发现受支持的智能体并引导完成防护配置,每项改动前都会询问确认。

    hol-guard init
  4. 4检查安装结果

    查看版本号确认安装成功,再查看运行状态确认防护层已生效。

    hol-guard --version
    hol-guard status
  5. 5检查并打包插件

    如需分发插件,可用 Plugin Kit 校验源目录并生成各运行时可直接加载的副本,全程本地执行。

    hol-guard plugin check
    hol-guard plugin package
  6. 6后续升级

    需要更新已安装版本时执行自带更新命令,无需重新安装。

    hol-guard update

如何确认成功

执行 hol-guard --version 能输出版本号,且 hol-guard status 正常显示当前防护运行状态。

常见问题

Q:提示找不到 hol-guard 命令怎么办?

A:多为 pipx 的可执行目录未加入 PATH。执行 python -m pipx ensurepath 后重开终端再试。

Q:Python 版本不够会怎样?

A:项目要求 Python 3.10 或更新版本,低版本会导致安装失败,请先升级 Python 再安装。

Q:首次运行会擅自修改配置吗?

A:不会。init 向导在打开仪表盘、安装智能体集成、连接可选云服务等每项改动前都会先询问。

Q:必须注册账号才能用吗?

A:不需要。可在本地无账号运行,使用命令行和本地仪表盘管理防护、处理审批与查看决策历史。

Q:在 Windows ARM64 上安装失败怎么办?

A:需先阅读官方 get-started 文档中的平台支持与 Windows ARM64 配置说明,按说明准备匹配的原生运行时。

注意事项

  • 本地优先运行,插件打包与校验命令只读取指定目录,不发起网络请求。
  • 可选云端功能仅用于共享历史、团队策略与设备管理,本地使用无需开启。
  • 升级前建议查看官方发布说明,了解版本变更与升级注意事项。
  • hol-guard 处于早期阶段,接口与命令可能随版本调整,以官方文档为准。

核心亮点

  • 运行时实时拦截,不依赖事后审计,直接阻断高风险工具调用和提示注入
  • 覆盖多种攻击面:工具、秘密、包、MCP 服务器、插件,防护全面
  • 与主流 AI 编程助手(Claude Code、Cursor 等)无缝集成,易用性高

不足之处

  • 早期项目,文档和社区生态尚待完善
  • 运行时拦截可能带来性能开销,需评估对代理响应速度的影响

适用场景

  • 企业内使用 AI 编程助手时,防止敏感数据泄露和恶意指令注入
  • 开发基于 MCP 或插件架构的 AI 应用,加固供应链安全
  • DevSecOps 流程中,对 AI 代理行为进行合规审计和风险控制

替代项目

Rebuff、Prompt Guard、Lasso Security

同类项目推荐

Awesome-Jailbreak-on-LLMs 开源

一站式掌握LLM越狱攻击最新研究,快速上手安全测试

Awesome-Jailbreak-on-LLMs is a collection of state-of-the-art, novel, exciting jailb···

★ 1731 2026-08-09
evals 开源

配置驱动的 Agent 评测,批量跑完直接看结果

Fast, robust, configurable agent evals

★ 164 2026-11-05
MMStar 开源

更公平地测出大模型真实视觉能力,避免作弊分

[NeurIPS 2024] This repo contains evaluation code for the paper "Are We on the Right···

★ 218 2026-08-09
AdvUnlearn 开源

对抗训练让概念擦除更抗攻击,生成更安全

Official implementation of NeurIPS'24 paper "Defensive Unlearning with Adversarial T···

★ 56 2026-08-09
AlignLLMHumanSurvey 开源

一张图看懂大模型如何对齐人类偏好

Aligning Large Language Models with Human: A Survey

★ 739 2026-09-15
matharena 开源

用最新数学竞赛题测大模型真实推理水平

Evaluation of LLMs on latest math competitions

★ 295 2026-10-23
WindowsAgentArena 开源

在真实 Windows 环境中,一键测试和对比 AI 智能体的任务完成能力。

Windows Agent Arena (WAA) is a scalable OS platform for testing and benchmarking of···

★ 915 2026-08-09
evaluation-guidebook 开源

学透 LLM 评估,避开 benchmark 陷阱,科学选模型。

Sharing both practical insights and theoretical knowledge about LLM evaluation that ···

★ 2165 2026-08-09