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

# Hermes

> Connect Hermes to your downloaded Magnitude models.

## Connect

1. [Install Hermes](https://hermes-agent.nousresearch.com/docs/getting-started/installation/) if needed.
2. Download a compatible model in Magnitude.
3. Open **Connections → Hermes** and click **Connect**.
4. Select a downloaded model on the connected card, then click the command to copy it.
5. Paste it into your terminal from your project folder. On Windows, use PowerShell.

Magnitude adds a custom provider named `magnitude`. The command below starts Hermes with a model from that provider.

## Run Hermes

After connecting in Magnitude, start Hermes with:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
hermes --provider custom:magnitude --model MODEL_ID
```

Replace `MODEL_ID` with the exact model ID, such as `gemma-4-e2b-it-qat:gguf:q4`, rather than its display name. The command shown in **Connections** already includes the correct ID for your selected model, so you can copy it without editing. Keep Magnitude running; it loads the model when the agent requests it.

## Configuration

**Connect** writes `~/.hermes/config.yaml`. Location overrides: `HERMES_HOME`.

### On another computer

1. In Magnitude, turn on **Settings → Network access**.
2. On the other computer, open `http://ADDRESS:10100` in a browser, using the address from **Reachable at**, and sign in with the **API key**.
3. In **Connections**, click **Copy setup prompt** on Hermes and send it to your agent.

### Edit the files yourself

Use the address from **Reachable at** for `ADDRESS` and the **API key** for `API_KEY`.

`~/.hermes/config.yaml`:

```yaml theme={"theme":{"light":"github-light","dark":"github-dark"}}
providers:
  magnitude:
    name: Magnitude
    base_url: http://ADDRESS:10100/inference/v1
    api_key: API_KEY
    transport: chat_completions
model:
  provider: custom:magnitude
  default: MODEL_ID
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.