Skip to navigation
Coding Agents

Hermes Agent

Hermes Agent is an open-source agent from Nous Research. It runs in the terminal, keeps memory between sessions and can answer on messaging apps. Connect it to Flow AI as a custom OpenAI-compatible endpoint.

Interactive setup

hermes model

Choose Custom endpoint, then enter:

  • Base URL: https://ai.hyperflow.fun/v1
  • API key: your Flow AI key
  • Model: a model id such as openai/gpt-6-luna

Manual setup

1

Store the key

Add your key to ~/.hermes/.env:

HYPERFLOW_API_KEY=sk-...
2

Set the model

Edit ~/.hermes/config.yaml:

config.yaml
model:
  provider: custom
  default: openai/gpt-6-luna
  base_url: https://ai.hyperflow.fun/v1
  key_env: HYPERFLOW_API_KEY
3

Start Hermes

hermes          # classic CLI
hermes --tui    # modern TUI

Switching models

To keep Flow AI as a named provider and switch models during a session, add it under providers:

config.yaml
providers:
  flow:
    api: https://ai.hyperflow.fun/v1
    key_env: HYPERFLOW_API_KEY
    transport: chat_completions

Then switch with /model custom:flow:<model id>, for example /model custom:flow:deepseek/deepseek-flash.

Troubleshooting

  • No API key: check ~/.hermes/.env has HYPERFLOW_API_KEY, or run hermes model again.
  • 401: the key is wrong, deleted or turned off; check it on API keys.
  • 402: your balance is too low.
  • Context errors: Hermes needs a model with at least 64K tokens of context. Pick a larger model.