> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prismml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Run Nous Research's Hermes terminal agent on local Bonsai.

[Hermes Agent](https://github.com/NousResearch/hermes-agent) is Nous Research's open-source terminal agent with persistent memory and learned skills. It works with any endpoint that implements `/v1/chat/completions`, so it can run entirely on local Bonsai.

## Step 1: Serve Bonsai

Any OpenAI-compatible Bonsai endpoint works. Pick one:

<CodeGroup>
  ```bash Demo repo server theme={null}
  ./scripts/start_llama_server.sh
  # Base URL: http://localhost:8080/v1
  ```

  ```bash MLX server (Apple Silicon) theme={null}
  ./scripts/start_mlx_server.sh
  # Base URL: http://localhost:8081/v1
  ```
</CodeGroup>

Agent work leans hard on tool calling and multi-step instructions; prefer **27B**, which is trained for native tool calling, or **ternary 8B** if memory is tight (see [which model for agents](/integrations/overview#which-model-for-agents)).

## Step 2: Install and configure Hermes

<Steps>
  <Step title="Install">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    Windows has a native PowerShell installer; see the [Hermes docs](https://hermes-agent.nousresearch.com/docs/).
  </Step>

  <Step title="Run the setup wizard">
    ```bash theme={null}
    hermes setup
    ```

    When asked for an inference provider, choose **Custom OpenAI-compatible endpoint** and enter:

    | Prompt       | Value                                                       |
    | ------------ | ----------------------------------------------------------- |
    | API base URL | `http://localhost:8080/v1` (or your endpoint from step 1)   |
    | API key      | any non-empty string, e.g. `not-needed`                     |
    | Model        | auto-detected via `GET /v1/models`; accept the Bonsai entry |
    | Display name | e.g. `bonsai-local`                                         |

    Settings land in `~/.hermes/config.yaml` (secrets in `~/.hermes/.env`). To change just the model later, run `hermes setup model`, or edit the config directly with `hermes config edit`. ‹TODO: verify wizard prompts against the current Hermes release›
  </Step>

  <Step title="Launch">
    ```bash theme={null}
    hermes
    ```

    Give it a task. Requests appear in your Bonsai server log, confirming the agent is running fully locally.
  </Step>
</Steps>