Skip to main content

Settings

Use the desktop app. Open Settings with Cmd/Ctrl+, (or the sidebar). You do not need to edit files by hand.

Where to click​

You wantOpen
Default modelSettings → Model
Sign in / API keysSettings → Providers
Telegram, Discord, Slack, …Settings → Gateway
License keySettings → License
MCP serversSettings → MCP (also under Tools)
Tool API keysSettings → Tools & Keys
GitHub / Vercel / Cloudflare / CodemagicSettings → Connectors
Approvals / YOLOSettings → Safety
Voice & wake wordSettings → Voice
MemorySettings → Memory & Context
Appearance, theme, scaleSettings → Appearance
Project foldersSettings → Workspace
Local AirLLMSettings → Providers → Local AirLLM
Keyboard shortcutsSettings → Keyboard Shortcuts

Secrets (API keys, bot tokens) are stored locally. Config and chats live under ~/.hermes/ on your machine.

Import / export​

The settings window can export and import a config snapshot, and reset to defaults. Export does not include API keys unless the flow says otherwise — treat any exported file as sensitive.

Data folder​

~/.hermes/ holds config, keys, sessions, skills, and logs. Installers do not wipe it on upgrade. Settings → About → Danger zone can remove it if you choose Uninstall everything.