Hermes Agent Windows: deployment tool for Hermes Agent

Windows-native adaptation of Hermes Agent with a PowerShell installer and browser Web UI

What Hermes Agent Windows does

Hermes Agent Windows adapts the upstream NousResearch/hermes-agent project to run directly on Windows, with no WSL2 needed. A single PowerShell command downloads scripts/install.ps1 and runs it, and a one-time uv pip install adds the Web UI dependencies fastapi and uvicorn. After that, hermes setup creates the initial configuration and hermes starts the command-line chat. The README names version v0.9.0 as current.

Version 0.9.0 added a Web UI at http://127.0.0.1:9119, available once the gateway is running with hermes gateway run and hermes web is started in a second window. Its pages cover live streaming chat, gateway status, session history with full-text search, token usage and cost estimates, real-time logs with level filtering, cron jobs, skill enabling and disabling, a configuration editor and API key management. Other changes from upstream include Git Bash compatibility, a fix for an os.kill WinError 11 problem, and Chinese interface support.

Key features

Native Windows install with no WSL2
One-line PowerShell installer
hermes web command that opens a browser Web UI on port 9119
Web UI pages for chat, sessions, analytics, logs, cron, skills, config and keys
Git Bash compatibility and a Windows os.kill fix
Chinese interface support

When to use it

Running Hermes Agent on a Windows PC without setting up WSL2
Managing a gateway, cron jobs and skills from a browser instead of the terminal
Using Hermes Agent with a Chinese-language interface

Who it is for: Windows users who want to run Hermes Agent natively, including Chinese-speaking users, without a Linux subsystem.

How it fits with Hermes Agent

A Windows adaptation of the upstream NousResearch/hermes-agent project, built on its code and following its MIT license.

How to install Hermes Agent Windows

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

$u = "https://raw.githubusercontent.com/pengchengxia75-arch/hermes-agent-windows/main/scripts/install.ps1"; $p = "$env:TEMP\hermes-install.ps1"; Invoke-WebRequest -Uri $u -OutFile $p; powershell -ExecutionPolicy Bypass -File $p
uv pip install fastapi uvicorn --python "$env:LOCALAPPDATA\hermes\hermes-agent\venv\Scripts\python.exe"

Requirements: Windows with PowerShell, and uv for the one-time Web UI dependency install

Note: It is a community Windows adaptation of NousResearch/hermes-agent whose README names version v0.9.0, not the upstream project itself.

FAQ

What is Hermes Agent Windows?

Hermes Agent Windows is a Windows-native adaptation of NousResearch/hermes-agent. It installs and runs without WSL2 and adds a hermes web command that opens a browser-based management UI.

How do I install Hermes Agent Windows?

Open PowerShell and run the one-line installer from the README, which downloads scripts/install.ps1 and executes it. Then run the uv pip install command once to add fastapi and uvicorn for the Web UI, and start with hermes setup.

Do I need WSL2 to run Hermes Agent Windows?

No. The README states that it installs and runs directly on Windows without WSL2, and it adds Git Bash compatibility.