wikis / Hermes / wiki / concepts / configuration-reference.md view as markdown

Configuration Reference — ~/.hermes/

All settings live under ~/.hermes/:

~/.hermes/
├── config.yaml   # settings (model, terminal, TTS, compression, …)
├── .env          # API keys and secrets
├── auth.json     # OAuth provider credentials (Nous Portal, etc.)
└── …

Managing configuration

hermes config            # view current configuration
hermes config edit       # open config.yaml in your editor
hermes config set K V    # set a value (auto-routes: keys → .env, rest → config.yaml)
hermes config check      # find missing options (run after updates)
hermes config migrate    # interactively add missing options

After updating Hermes, run hermes config check — new versions add options; migrate fills them interactively. Full option tables: raw/docs-user-guide-configuration.md. Related: cli reference · auxiliary models.