> ## Documentation Index
> Fetch the complete documentation index at: https://litellmagentplatform-fix-document-harness-auth-token.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Open a Kubernetes-sandboxed Hermes Agent session from your terminal.

<video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/litellmagentplatform-fix-document-harness-auth-token/-SgpcgCh64tbVJRQ/images/hermes-attach.mp4?fit=max&auto=format&n=-SgpcgCh64tbVJRQ&q=85&s=a6e16b92bfe40813aa17b93b18bea99e" data-path="images/hermes-attach.mp4" />

The `lap` CLI talks to a running LAP instance. If you haven't deployed one yet, see [Installation](/installation).

<Note>
  First time? Install the CLI:

  ```bash theme={null}
  git clone https://github.com/BerriAI/litellm-agent-platform.git
  cd litellm-agent-platform/cli && npm install
  ln -sf "$PWD/bin/lap.mjs" ~/.local/bin/lap
  ```
</Note>

## 1. Log in

```bash theme={null}
lap login
```

Paste your LAP URL and `MASTER_KEY` when prompted. Saved to `~/.lap/config.json`.

## 2. Open an agent

```bash theme={null}
lap
```

Pick your Hermes agent from the interactive list. `lap` spins up a Kubernetes-sandboxed pod running [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) in `--tui` mode (the Ink-based interactive UI), attaches your local terminal to its TTY over a WebSocket, and drops you straight in.

The harness routes Hermes through your LiteLLM gateway by mapping `LITELLM_API_BASE` / `LITELLM_API_KEY` → `OPENAI_BASE_URL` / `OPENAI_API_KEY` at boot — so Hermes talks to your gateway as if it were OpenAI direct, including for non-OpenAI providers.

Hermes persists state under `~/.hermes/` (sessions, memories, skills) inside the pod's writable filesystem. State does not survive across fresh `lap` sessions.

Press **Ctrl-D** to detach — the session stays alive for 24h.

***

## Creating an agent

If you're setting up the platform, create a Hermes agent first. In the UI choose **hermes** from the Harness picker and pick a model, or via API:

```bash theme={null}
curl -X POST $LAP_URL/api/v1/managed_agents/agents \
  -H "Authorization: Bearer $MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-hermes","harness_id":"hermes","model":"openai/gpt-4o"}'
```

Hermes accepts any model your LiteLLM gateway can route. Inside the TUI you can also `hermes model` to switch on the fly.