hermes-for-win: deployment tool for Hermes Agent

One-click PowerShell installer that sets up Hermes Agent and a web UI on Windows through WSL2

What hermes-for-win does

hermes-for-win is a third-party Windows installer for Hermes Agent and a web UI. Instead of setting up WSL, the environment and background processes by hand, you run install-hermes.ps1, which downloads, configures and starts the services. The web UI is then reachable in a browser at http://localhost:8787. The README states that it is not an official release from the hermes-webui team and that issues belong in this repository.

The project is a small set of management scripts: check-status.ps1 reports on WSL, processes and the scheduled task, start-services.ps1 and stop-services.ps1 control the services, update-hermes.ps1 checks for and applies the latest GitHub version, and setup-autostart.ps1 creates a Windows scheduled task so the services start at login. The services run in the background without a window. WSL2 with Ubuntu is required because the Hermes Agent itself runs inside it, and the README lists at least 4GB of free memory and 5GB of disk space.

Key features

install-hermes.ps1 downloads, configures and starts Hermes Agent and the web UI
Auto-start at Windows login through a scheduled task
Silent background operation with no console window
update-hermes.ps1 to check for and apply the latest version
check-status.ps1 for WSL, process and scheduled task status
Start and stop scripts for the Hermes services

When to use it

Getting Hermes Agent running on a Windows PC without manual WSL configuration
Keeping the web UI available after every reboot
Updating an existing Windows install with one script

Who it is for: Windows 10 and 11 users who want to run Hermes Agent and its web UI without configuring WSL2 by hand.

How it fits with Hermes Agent

Built to install and manage Hermes Agent on Windows, running the agent inside WSL2 and managing it with PowerShell scripts.

How to install hermes-for-win

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/EdwardWason/hermes-for-win.git
cd hermes-for-win
cd scripts
.\install-hermes.ps1

Requirements: Windows 10 (2004+) or Windows 11, WSL2 enabled with Ubuntu installed, at least 4GB of available memory and 5GB of disk space.

Note: It is a third-party installer rather than an official release, and it requires WSL2 with Ubuntu.

FAQ

What is hermes-for-win?

hermes-for-win is a third-party PowerShell installer for Hermes Agent and a web UI on Windows. It sets up the services under WSL2, starts them in the background and can launch them at login.

What do I need to run hermes-for-win?

You need Windows 10 (2004 or later) or Windows 11 with WSL2 enabled and Ubuntu installed. The README also lists at least 4GB of available memory and 5GB of free disk space.

How do I install hermes-for-win?

Download and extract the release package, or clone the repository, then enter the scripts directory and run .\install-hermes.ps1 in PowerShell. When it finishes, open http://localhost:8787 in a browser.