DocsHermes

Hermes

Connect Hermes to GoesAI using the Anthropic Messages provider.

Config Path

Hermes config directory is usually ~/.hermes/. Non-sensitive config goes in config.yaml; keys can also use ~/.hermes/.env.

Config File

Configure GoesAI provider directly in ~/.hermes/config.yaml. The Anthropic Base URL should not include /v1.

yaml

model:
  default: claude-sonnet-4-6
  provider: goesai-claude

providers:
  goesai-claude:
    api_mode: anthropic_messages
    base_url: https://api.goesai.com
    api_key: sk-YOUR_KEY
    default_model: claude-sonnet-4-6
    models:
      - claude-sonnet-4-6

Environment Variables

If you prefer not to put keys in YAML, use environment variables or ~/.hermes/.env with the corresponding env field in config.

bash

export ANTHROPIC_API_KEY="sk-YOUR_KEY"
hermes config edit

Troubleshooting

Model names follow the GoesAI console and pricing page. For 401/403 errors, check that the Key is complete, group is active, and Base URL does not have /v1.

Back to Docs