Run Hermes Agent on Windows.
We do all the heavy lifting.

One PowerShell command. One WPF GUI. Your entire Hermes + Ollama + WSL environment is ready to go inside WSL without you touching a single Linux command.

One-line installer (admin PowerShell)
irm https://jlaiii.github.io/hermes-agent-windows/install.ps1 | iex
View on GitHub Download ZIP

Windows 10/11 + Admin rights + Internet. WSL auto-installed if missing.

What it handles for you.

Checks, installs, starts, monitors, and updates every part of the Hermes stack from a single Windows GUI.

+ One-command setup

Paste the installer. It auto-elevates, downloads files, launches the GUI. No manual WSL or Linux commands.

+ WPF GUI with live logs

Status cards for WSL, Ollama, Hermes, and Gateway. Watch the live log panel while setup runs in the background.

+ WSL managed for you

Installs WSL if missing, warns for reboots, starts or restarts the distro, and creates an admin helper account.

+ Ollama in WSL

Ollama is installed and served inside WSL, not on the Windows host. API key and cloud model picker built in.

+ Hermes Agent lifecycle

Install, update, start, stop, restart, doctor, and clean Hermes Agent without leaving Windows.

+ Gateway + Dashboard

Start the Hermes gateway from the GUI, then open the web dashboard at localhost:9119 with one click.

+ Safe to re-run

Every action checks state first before modifying anything. Wipe and reinstall buttons require explicit confirmation.

+ Windows shortcuts

Install or remove Desktop and Start Menu shortcuts directly from the GUI. Clean, no registry hacks.

What you do not have to do.

All the Linux and WSL chores you skip by using this tool.

No manual WSL installation
No apt-get or package management
No configuring Linux user accounts
No systemctl or service management
No editing config files by hand
No PATH variable wrestling
No env files or secrets setup
No terminal multiplexers or screen/tmux
No firewall rules for WSL ports
No guessing if services are running
No docker or container setup
No deep PowerShell scripting knowledge

How it works.

Four steps from nothing to a running Hermes Agent inside WSL.

1

Paste the one-liner

Open PowerShell, paste the installer, press Enter. It requests Admin rights, downloads the project, and launches the GUI. No setup needed.

2

Check status

The GUI shows color-coded cards for every component. Red means missing, green means ready. Hit Check Status anytime.

3

Run full setup

Click Start Hermes Agent Setup. It installs WSL, creates the admin account, installs Ollama, installs Hermes, and starts the gateway. All while you watch the live log panel.

4

Use it

Launch the Hermes CLI in a Windows terminal through WSL, open the web dashboard, or manage everything from the GUI. Done.

Real-time status cards.

See exactly what is running and what needs attention at a glance.

WSL Status
Running
Ollama Status
Running
Hermes Agent
Installed
Hermes Gateway
Stopped
Admin Check
OK
Updates
Check available

Install.

Pick the method that fits you best. All end up in the same GUI.

Option 1: One-liner (recommended)

irm https://jlaiii.github.io/hermes-agent-windows/install.ps1 | iex

Option 2: Manual run from ZIP

powershell.exe -ExecutionPolicy Bypass -File .\hermes-agent-windows.ps1

Option 3: Double-click batch

Extract the ZIP and double-click hermes-agent-windows.bat. It auto-requests admin rights and handles execution policy.