Hermes Profile Config

Hermes Profile Config Management

Audit, update, and fix Hermes Agent profile configurations across the ~/.hermes/profiles/ directory.

Key Paths

~/.hermes/profiles/<name>/config.yaml    # Per-profile config
~/.hermes/config.yaml                     # Global config
~/.hermes/.env                            # API keys (XIAOMI_API_KEY, etc.)

Model Naming Convention

Correct format — model name and provider are separate fields:

model:
  default: mimo-v2.5-pro
  provider: xiaomi
providers:
  xiaomi:
    base_url: https://token-plan-sgp.xiaomimimo.com/v1

Incorrect format — provider prefix baked into model string:

model: xiaomi/mimo-v2.5-pro   # ← Wrong: no explicit provider, relies on implicit resolution

Always split into model.default + model.provider + providers.<name>.base_url.

Audit Pattern

Quick audit of all profiles' model and provider status:

for dir in ~/.hermes/profiles/*/; do
  name=$(basename "$dir")
  model=$(grep "^model:" "$dir/config.yaml" 2>/dev/null | head -1 | awk '{print $2}')
  echo "$name: $model"
done

Check which profiles have providers: set:

for dir in ~/.hermes/profiles/*/; do
  name=$(basename "$dir")
  echo "=== $name ==="
  grep -A8 "^providers:" "$dir/config.yaml" 2>/dev/null | head -9
done

Bulk Update Pattern

When updating many profiles at once, use execute_code with Python to batch-patch all config.yaml files. This is more reliable than individual patch calls for multi-file changes.

import os

profiles_dir = os.path.expanduser("~/.hermes/profiles")

for name in sorted(os.listdir(profiles_dir)):
    config_path = os.path.join(profiles_dir, name, "config.yaml")
    if not os.path.isfile(config_path):
        continue
    with open(config_path, "r") as f:
        content = f.read()
    # ... apply transformations ...
    with open(config_path, "w") as f:
        f.write(content)

Common Fixes

Add provider block to profiles missing it

Replace flat model string with structured model + providers:

# Before
model: xiaomi/mimo-v2.5-pro

# After
model:
  default: mimo-v2.5-pro
  provider: xiaomi
providers:
  xiaomi:
    base_url: https://token-plan-sgp.xiaomimimo.com/v1

Fix Discord bot not responding

Check these settings in the profile's config.yaml under the discord: section:

Most common cause of silent Discord bot: require_mention: true — the bot is working fine but ignoring messages that don't @mention it.

Switch a profile to OpenRouter / owl-alpha

model:
  default: owl-alpha
  provider: openrouter
providers:
  openrouter:
    base_url: https://openrouter.ai/api/v1

Ensure OPENROUTER_API_KEY is set in ~/.hermes/.env.

Provider Base URLs

After Making Changes

Always restart the gateway for config changes to take effect:

hermes gateway restart

Or in-session: /restart (gateway session) or /new (CLI session).