How-To Series · 1: Get Running

Hermes · Desktop App

The native Hermes desktop app for macOS, Windows, and Linux. Same agent, same config, same sessions as the CLI, with a polished chat UI, streaming tool output, and settings panes.

After this videoYou can run Hermes from a native desktop app on Mac, Windows, or Linux. Same sessions, same skills, same config as the terminal.

The desktop app is a native application built around the same agent you get from the CLI and the gateway. Same config, same API keys, same sessions, same skills, same memory. It is not a separate product. Launch it with hermes desktop and everything you set up in the terminal is already there. The chat surface gives you streaming responses with live tool activity, drag-and-drop file attachments, a right-hand preview rail for web pages and tool outputs, and the same conversation history as every other Hermes surface. The model picker in the composer is sticky UI state that follows you across chats without touching your profile default. Settings is a real UI instead of editing YAML. Manage providers, keys, tools, MCP servers, the gateway, and sessions from panes. First-run onboarding gets you to your first message in seconds. Management panes surface skills, cron, profiles, and messaging setup without dropping to a terminal. Press Cmd+K (or Ctrl+K on Windows/Linux) for the command palette to jump to any action or pane. The app runs on macOS, Windows, and Linux. You can connect to a remote backend over Tailscale or VPN, with OAuth via Nous Portal for public hosts or username/password for trusted networks.

About these resources. Every command in this video comes from the Desktop App user-guide doc.

New words here · Plain English

one sentence each · full glossary
undefinedundefined
undefinedundefined
undefinedundefined
undefinedundefined

Sources · What this video distills

1 docs page · every command below traces to it
Primary guide
Desktop App
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Launch the desktop appfrom source ↗
hermes desktop
Set initial project directoryfrom source ↗
hermes desktop --cwd <path>
Tail desktop logsfrom source ↗
hermes logs gui -f

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this