Flux RouterDocumentation

Hermes

Wire Hermes to FluxRouter with a custom model block in config.yaml.

Hermes talks to FluxRouter over the OpenAI endpoint at https://api.fluxrouter.ai/v1, and your Flux key is the only credential it needs.

Manual config

Set the model block in ~/.hermes/config.yaml to a custom provider pointed at FluxRouter:

yaml
model:
  provider: custom
  base_url: https://api.fluxrouter.ai/v1
  name: flux-auto
  api_key_env: FLUX_API_KEY

Then export your Flux key:

bash
export FLUX_API_KEY="sk-YOUR-FLUX-KEY"

Test it

Start Hermes and send a short prompt:

bash
hermes

If the response comes back, your traffic is flowing through FluxRouter. Check your dashboard to confirm the request landed.

Notes

Keep name set to flux-auto and FluxRouter picks the lane for each request. To pin a tier instead, set name to flux-fast, flux-standard, or flux-reasoning. Hermes reads the key from the env var named in api_key_env, so make sure FLUX_API_KEY is exported in the shell you launch Hermes from.