What problem does it solve?
Hermes needs a reliable way to let external services trigger automated agent runs based on incoming events, without manually starting conversations.
Core Features & Use Cases
- Event-driven webhook subscriptions: Create routes that accept POSTed event payloads from systems like GitHub, GitLab, Stripe, CI/CD, IoT sensors, and monitoring tools.
- Prompt templating from payloads: Render agent prompts using
{dot.notation} fields so the event data becomes the task input.
- Configurable delivery targets: Route the agent’s response to chat or platform adapters (e.g., Telegram, Discord, GitHub comments), including a low-cost
--deliver-only mode for direct notifications.
- Security controls: Use per-subscription HMAC-SHA256 secrets with signature validation, plus persisted subscription state for durable routing.
Quick Start
Run the webhook subscription manager by enabling the webhook platform and then creating a subscription that posts events into Hermes using hermes webhook subscribe alerts --events "alert" --prompt "Alert: {alert.name}\nSeverity: {alert.severity}\nMessage: {alert.message}\n\nPlease investigate and suggest remediation." --deliver telegram --deliver-chat-id "12345".