Windows (Native) Guide
Hermes runs natively on Windows 10 and Windows 11 — no WSL, no Cygwin, no Docker. This page is the deep dive: what works natively, what's WSL only, what the ins
Hermes runs natively on Windows 10 and Windows 11 — no WSL, no Cygwin, no Docker. This page is the deep dive: what works natively, what's WSL-only, what the installer actually does, and the Windows-specific knobs you might need to touch. If you just want to install, the one-liner on the landing page or Installation page is all you need. …
What this page covers
- Quick install
- Desktop installer (alternative)
- Dependency bootstrap (depensure)
- What the installer actually does
- Feature matrix
- How Hermes runs shell commands on Windows
- UTF-8 console on Windows
- The editor (Ctrl-X Ctrl-E, /edit)
- Ctrl+Enter for newline in the CLI
- Running the gateway at Windows login
- Install
- Manage
- Why not a Windows Service?
- Data layout
- Browser tool
- Running Hermes on Windows — practical notes
- PATH after install
- Environment variables
- Windows-specific env vars
- Uninstall
- Process management internals
- Common pitfalls
- Where to go next
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
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
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