Hermes Infrastructure

System-level Hermes agent infrastructure — global wrappers, cost guards, and orchestration tools.

Components

Cost Guard (Global)

• Hook: hooks/model-cost-guard/handler.py — blocks paid models, allows free models from dynamic OpenRouter scan
• State: ~/.hermes/cost-guard-state/ (runtime, not repo)
• Discovery: Daily OpenRouter scan populates current_free_models.json

Safe Delegate Task (Global Wrapper)

• Wrapper: bin/safe_delegate_task — replaces direct delegate_task calls globally
• Features:
  • Dynamic free model pool from OpenRouter scan
  • Quarantine system for rate-limited models
  • Round-robin rotation with persistent state
  • Exhaustion tracking per model
• Install: Symlink to ~/.local/bin/safe_delegate_task

Inner Skill Script

• Path: skills/autonomous-ai-agents/safe-delegate-task/scripts/safe_delegate_task.py
• Used by: delegate_task when skill safe-delegate-task is active
• Sync: Should mirror wrapper logic

Setup

# Install system wrapper
ln -sf ~/hermes-infra/bin/safe_delegate_task ~/.local/bin/safe_delegate_task

# Verify installation
which safe_delegate_task

State Files (runtime, not in repo)

• ~/.hermes/cost-guard-state/current_free_models.json — 27+ free models
• ~/.hermes/cost-guard-state/quarantine.json — temporarily blocked models
• ~/.hermes/cost-guard-state/round_robin.json — rotation index
• ~/.hermes/cost-guard-state/safe_delegate.log — operation log

License

MIT — part of the Hermes agent ecosystem.