{"id":45101,"library":"hol-guard","title":"HOL Guard","description":"HOL Guard v2.0.506 provides a privacy-first guard layer for local AI harnesses (Codex, Claude Code, Cursor, Gemini, OpenCode). It intercepts tool calls, validates them against user-defined policies, and rejects unauthorized operations without sending data to external services.","status":"active","version":"2.0.506","language":"python","source_language":"en","source_url":"https://github.com/hashgraph-online/hol-guard","tags":["ai","guard","privacy","tool-validation"],"install":[{"cmd":"pip install hol-guard","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"wrong":"from hol_guard import HOLGuard","symbol":"HOLGuard","correct":"from codex_plugin_scanner import HOLGuard"}],"quickstart":{"code":"from hol_guard import HOLGuard\nimport os\nguard = HOLGuard(api_key=os.environ.get('HOL_API_KEY', ''))\nresult = guard.validate(\"Create a file test.txt\")\nprint(result)","lang":"python","description":"Initialize HOL Guard with an API key and validate a tool call."},"warnings":[{"fix":"Update code to check result['allowed'] instead of just if result:","message":"In v2.0, the validate method now returns a dict with keys 'allowed' (bool) and 'reason' (str) instead of a plain boolean. Code relying on truthy/falsy checks will break.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Change import to 'from hol_guard import HOLGuard'.","message":"The old import path from hol_guard.guard import HOLGuard is deprecated. Use from hol_guard import HOLGuard directly.","severity":"deprecated","affected_versions":"<=1.9.x"},{"fix":"Ensure HOL_API_KEY environment variable is set before instantiating HOLGuard.","message":"HOL Guard requires an API key set via environment variable HOL_API_KEY or passed to the constructor. If missing, all validations silently fail-closed (return allowed=False). Many users forget to set the key and wonder why everything is rejected.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'ai':15,44 'call':26 'claud':18 'code':19 'codex':17 'cursor':20 'data':40 'defin':32 'extern':42 'first':10 'gemini':21 'guard':2,4,11,45 'har':16 'hol':1,3 'intercept':24 'layer':12 'local':14 'opencod':22 'oper':37 'polici':33 'privaci':9,46 'privacy-first':8 'provid':6 'reject':35 'send':39 'servic':43 'tool':25,48 'tool-valid':47 'unauthor':36 'user':31 'user-defin':30 'v2.0.506':5 'valid':27,49 'without':38","created_at":"2026-06-07T12:53:21.973043+00:00","updated_at":"2026-06-07T12:53:21.973043+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'HOLGuard' from 'codex_plugin_scanner' (/tmp/tmpktwk6gjc/venv/lib/python3.12/site-packages/codex_plugin_scanner/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/hashgraph-online/hol-guard","github":"https://github.com/hashgraph-online/hol-guard","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["security","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}