Configuring Models
Configuring Models Hermes uses two kinds of model slots: Main model — what the agent thinks with. Every user message, every tool call loop, every streamed respo
Hermes uses two kinds of model slots: This page covers configuring both from the dashboard. If you prefer config files or the CLI, jump to Alternative methods at the bottom. Open the dashboard and click Models in the sidebar. You get two sections: 1. Model Settings — the top panel, where you assign models to slots. 2. …
What this page covers
- The Models page
- Setting the main model
- Setting auxiliary models
- Common override patterns
- Per-task override
- Reset all to auto
- The "Use as" shortcut
- What gets written to config.yaml
- When does it take effect?
- Troubleshooting
- "No authenticated providers" in the picker
- Main model didn't change in my running chat
- Auxiliary override "didn't take effect"
- I picked a model but Hermes switched providers on me
- Alternative methods
- CLI slash command
- Custom aliases
- hermes model subcommand
- Direct config edit
- REST API
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Using Hermes
CLI Interface
Hermes Agent's CLI is a full terminal user interface (TUI) — not a web UI. It features multiline editing, slash command autocomplete, conversation history, inte
TUI
The TUI is the modern front end for Hermes — a terminal UI backed by the same Python runtime as the Classic CLI. Same agent, same sessions, same slash commands;
Configuration
All settings are stored in the directory for easy access. TIP — Easiest path to a working Run — one OAuth gets you a model provider and all four Tool Gateway to
Sessions
Hermes Agent automatically saves every conversation as a session. Sessions enable conversation resume, cross session search, and full conversation history manag
Profiles: Running Multiple Agents
Profiles: Running Multiple Agents Run multiple independent Hermes agents on the same machine — each with its own config, API keys, memory, sessions, skills, and
Git Worktrees
Hermes Agent is often used on large, long‑lived repositories. When you want to: Run multiple agents in parallel on the same project, or Keep experimental refact