Hermes Windows Native: deployment tool for Hermes Agent

Windows-native Hermes Agent and WebUI bundle with a shared venv and one-click PowerShell start

What Hermes Windows Native does

The repository bundles hermes-agent, hermes-webui and a hermes-start folder of PowerShell launchers, all sharing one .venv. The README lists the integrated versions as Hermes Agent package 0.17.0 (source v2026.06.19) and Hermes WebUI source v0.51.528. Runtime data is redirected to %USERPROFILE%\.hermes instead of the source tree.

Running hermes-start\hermes-start.ps1 loads environment variables from hermes-env.ps1 and opens separate PowerShell windows for Hermes Agent and Hermes WebUI, so each one's logs stay visible. The WebUI is then available at http://127.0.0.1:8787/ by default. The README focuses on the Windows integration layer, since the upstream projects document their components separately, and is offered in English and Simplified Chinese. The launcher scripts are currently path-bound to F:\hermes-windows.

Key features

Native Windows workflow without Docker or WSL2
Shared .venv for hermes-agent and hermes-webui
Separate PowerShell windows for visible Agent and WebUI logs
One-click startup through hermes-start.ps1
Runtime data redirected to %USERPROFILE%\.hermes
WebUI served at http://127.0.0.1:8787/ by default

When to use it

Running Hermes Agent with a browser WebUI on a Windows PC without containers
Keeping Agent and WebUI logs in separate windows while debugging
Setting up a fixed-layout Hermes install on Windows with a single launcher

Who it is for: Windows users who want Hermes Agent and Hermes WebUI running together with the least platform overhead.

How it fits with Hermes Agent

An integration package around the Hermes Agent and Hermes WebUI source trees that adds Windows launchers and a shared Python environment.

How to install Hermes Windows Native

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/markwang2658/hermes-windows-native.git hermes-windows
cd hermes-windows
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel

Requirements: Windows with PowerShell, git and Python; the launcher scripts are path-bound to F:\hermes-windows by default

Note: The launcher scripts are path-bound to F:\hermes-windows, so using a different root directory means editing the hardcoded paths in hermes-start.

FAQ

What is Hermes Windows Native?

Hermes Windows Native is a Windows-native integrated package for running Hermes Agent and Hermes WebUI with a shared Python environment. It provides PowerShell launchers and one-click startup.

Do I need Docker or WSL2 to run Hermes Windows Native?

No. The README describes a native Windows workflow without Docker and without WSL2.

How do I install Hermes Windows Native?

Clone the repository into a folder named hermes-windows, create the shared virtual environment with python -m venv .venv, then install Hermes Agent with pip install -e and the WebUI requirements. Start everything with hermes-start\hermes-start.ps1.