---
title: 'Hermes Helper'
description: 'Use a setup code to connect a Leadtime self-hosted agent to a Hermes Agent runtime.'
search:
  tags: ['agents', 'hermes-helfer']
---
The Hermes helper connects a self-hosted Leadtime agent to a Hermes Agent runtime. It is a provisioning helper, not a separate agent type.

## What the helper configures

- **Agent API token:** created or reused so Hermes can call Leadtime as the agent.
- **Agent sessions:** enabled so Leadtime can start work by sending signed webhooks.
- **Webhook URL:** stored on the agent and pointed at the Hermes connector listener.
- **Signing secret:** returned once to Hermes so incoming webhooks can be verified.

## Setup flow

- **Generate a setup code**from the Hermes helper section in the agent settings.
- **Run the setup command near Hermes**or give it to an agent that can edit the Hermes installation.
- **Let Hermes claim the code.**Leadtime stores the webhook settings and Hermes stores the returned token, signing secret, API URL, and mode.

## After setup

Assign or mention the agent on a task. Leadtime creates an agent session, sends the signed webhook to Hermes, and Hermes starts the configured runtime. Session status and logs are reported back to Leadtime through the public agent-session API.