hookprobe-ctl

hookprobe-ctl — Platform Control CLI

hookprobe-ctl is the command-line interface for managing HookProbe deployments. It provides hardware detection, inference bridge inspection, service status, and benchmarking.

Installation

hookprobe-ctl is included in all HookProbe installations at /opt/hookprobe/bin/hookprobe-ctl.

# Add to PATH (if not already)
export PATH="/opt/hookprobe/bin:$PATH"

Commands

hw-info

Display detected hardware capabilities including NPU, CPU architecture, RAM, and tier recommendation.

hookprobe-ctl hw-info

Output:

==================================================
  HookProbe Hardware Profile
==================================================
  Accelerator:    hailo-8l (13.0 TOPS)
  CPU:            aarch64, 4 cores
  SIMD:           NEON (128-bit)
  RAM:            1907 MB
  Max Model:      512 MB
  Engine:         hailort
  Quantization:   INT8
──────────────────────────────────────────────────
  Tier:           guardian
  Can Run LLM:    Yes
  LLM Model:      smollm-135m-q4
==================================================

JSON output for scripting:

hookprobe-ctl hw-info --json

brain-info

Display inference bridge status and loaded models.

hookprobe-ctl brain-info

Output:

==================================================
  HookProbe Inference Bridge
==================================================
  Tier:           fortress
  Classify:       cpu-sklearn
  LLM:            LlamaEngine
  LLM Available:  Yes
==================================================

version

Display the HookProbe platform version.

hookprobe-ctl version
# HookProbe v5.5.0

status

Display running HookProbe container/service status.

hookprobe-ctl status

Output:

==================================================
  HookProbe Service Status
==================================================
  [OK] hookprobe-dashboard              Up 2 hours (healthy)
  [OK] hookprobe-docs                   Up 2 hours (healthy)
  [OK] hookprobe-proxy                  Up 2 hours (healthy)
  [OK] hookprobe-website                Up 2 hours (healthy)
==================================================

Environment Variables

Variable	Default	Description
`HOOKPROBE_MOCK_NPU`	(empty)	Simulate NPU hardware for testing (e.g., `hailo-8l`)
`HOOKPROBE_MODEL_DIR`	`/opt/hookprobe/models`	Directory for GGUF/ONNX model files
`HOOKPROBE_MODEL_KEY`	(dev key)	HMAC key for model integrity verification

Examples

Check if NPU is available

if hookprobe-ctl hw-info --json | python3 -c "import sys,json; d=json.load(sys.stdin); exit(0 if d['tops'] > 0 else 1)"; then
    echo "NPU detected!"
fi

Automated tier detection in install scripts

TIER=$(hookprobe-ctl hw-info --json | python3 -c "import sys,json; print(json.load(sys.stdin)['tier_recommendation'])")
echo "Installing HookProbe as: $TIER"