Hermes Agent for Windows — One-Click Installer

Hermes for Windows

One-click installer that sets up WSL2, Ubuntu-22.04, Ollama, and Hermes Agent — plus desktop shortcuts and .bat launchers.

Download Latest View on GitHub

Or run it from PowerShell (Admin) in one line:

irm https://raw.githubusercontent.com/jlaiii/hermes-agent-windows/main/Install-Hermes-Windows.ps1 | iex

What This Project Is For

Hermes Agent is an open-source AI agent by Nous Research. It officially supports Linux, macOS, and WSL2 — not native Windows.

This installer is built for Windows users who want Hermes Agent to just work without manually setting up WSL, Ubuntu, Ollama, and Linux dependencies. Run one script, and it handles the entire setup automatically — including the mandatory reboot and resume.

You end up with real Windows desktop shortcuts and .bat launchers, so you never have to touch WSL commands manually.

What It Does

One-Click Install

Run a single PowerShell script and walk away. Handles every dependency automatically.

WSL2 + Ubuntu-22.04

Checks, installs, configures WSL2, and pulls Ubuntu-22.04 if missing. Reboots and resumes automatically.

Ollama Included

Installs Ollama inside WSL and pulls a lightweight model so local AI works out of the box.

Hermes Agent

Installs the official NousResearch Hermes Agent in WSL with the one-line installer.

Desktop Shortcuts

Creates Start Menu and Desktop shortcuts for CLI, Gateway, Ollama Server, and Setup.

Portable Launchers

Generates Windows .bat files so you can start services from Windows without touching WSL directly.

Quick Start

Download the latest release or copy the one-liner above.

Run Run-Setup.bat (or the PowerShell script) as Administrator.

Reboot when prompted (only if WSL was not already installed). Setup resumes automatically after login.

Use the new Desktop shortcuts: Hermes CLI, Hermes Gateway, Ollama Server, and Hermes Setup.

Launchers Created

Hermes CLI — Interactive chat inside WSL
Hermes Gateway — Messaging gateway server (Telegram, Discord, etc.)
Hermes ACP Server — ACP server for editor integrations
Ollama Server — Local LLM inference backend
Hermes Setup — First-time configuration wizard

System Requirements

Windows 10 version 20H2 or later / Windows 11
Administrator privileges (WSL requires it)
At least ~4 GB free disk space
Internet connection during install

Troubleshooting

WSL requires a reboot

This is normal on first-time installs. The script registers itself in RunOnce and resumes after login.

Hermes command not found in WSL

Open a new WSL terminal so the PATH update from the installer takes effect, or run source ~/.bashrc.

Uninstall

Run Uninstall-Hermes-Windows.ps1 from the repo. Use -KeepWSL if you want to keep Ubuntu.