Skip to content

Commit ce9888b

Browse files
LeonSGP43teknium1
authored andcommitted
docs(config): fix fallback provider config paths
1 parent a628992 commit ce9888b

2 files changed

Lines changed: 8 additions & 6 deletions

File tree

website/docs/reference/cli-commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1093,7 +1093,7 @@ Typical session:
10931093
2. Use ``/`` to reorder fallbacks (first-in-list is tried first).
10941094
3. Press `d` to remove one.
10951095

1096-
All changes persist to `fallback_providers:` under `model:` in `config.yaml`. Interacts with [Credential Pools](/docs/user-guide/features/credential-pools): pools rotate keys *within* a provider, fallbacks switch to a *different* provider entirely.
1096+
All changes persist to the top-level `fallback_providers:` list in `config.yaml`. Interacts with [Credential Pools](/docs/user-guide/features/credential-pools): pools rotate keys *within* a provider, fallbacks switch to a *different* provider entirely.
10971097

10981098
See [Fallback Providers](/docs/user-guide/features/fallback-providers) for behavior details and interaction with `fallback_model` (legacy single-fallback key).
10991099

website/docs/reference/environment-variables.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -514,16 +514,18 @@ Older configs with `compression.summary_model`, `compression.summary_provider`,
514514

515515
For task-specific direct endpoints, Hermes uses the task's configured API key or `OPENAI_API_KEY`. It does not reuse `OPENROUTER_API_KEY` for those custom endpoints.
516516

517-
## Fallback Model (config.yaml only)
517+
## Fallback Providers (config.yaml only)
518518

519-
The primary model fallback is configured exclusively through `config.yaml` — there are no environment variables for it. Add a `fallback_model` section with `provider` and `model` keys to enable automatic failover when your main model encounters errors.
519+
The primary model fallback chain is configured exclusively through `config.yaml` — there are no environment variables for it. Add a top-level `fallback_providers` list with `provider` and `model` keys to enable automatic failover when your main model encounters errors.
520520

521521
```yaml
522-
fallback_model:
523-
provider: openrouter
524-
model: anthropic/claude-sonnet-4
522+
fallback_providers:
523+
- provider: openrouter
524+
model: anthropic/claude-sonnet-4
525525
```
526526

527+
The older top-level `fallback_model` single-provider shape is still read for backward compatibility, but new configuration should use `fallback_providers`.
528+
527529
See [Fallback Providers](/docs/user-guide/features/fallback-providers) for full details.
528530

529531
## Provider Routing (config.yaml only)

0 commit comments

Comments
 (0)