Hermes Agent Windows Fork: deployment tool for Hermes Agent

Windows-native fork of Hermes Agent 0.13.0 with path, process and terminal fixes, no WSL required

What Hermes Agent Windows Fork does

This fork adapts Hermes Agent to run natively on Windows. It addresses encoding, Git Bash path handling, process management and terminal backend compatibility, and improves the TUI, Dashboard Chat and the experience of running multiple profiles. The upstream README is kept as README_hermes.md, and a Chinese version of the fork's own README is included.

Documentation sits under docs/windows_EN: a quick start, a psmux one-click launch guide using start-hermes.ps1, profile and multi-instance setup with the -p flag and HERMES_HOME, sanitized profile config examples, dashboard instructions, Windows notes and troubleshooting. The README lists the everyday commands, including hermes, hermes gateway run, hermes model, hermes tools and hermes doctor. The dashboard front end is built from the web/ folder with npm and opens at http://127.0.0.1:9119.

Key features

Native Windows operation without WSL
Fixes for encoding, Git Bash path conversion and process management
TUI and Dashboard Chat adjusted for Windows
Multiple profiles with their own gateways and dashboards run in parallel
psmux one-click launch through start-hermes.ps1

When to use it

Running Hermes Agent on a Windows PC without setting up WSL
Running several Hermes profiles, gateways and dashboards side by side on Windows
Using the dashboard and TUI chat on a Windows machine

Who it is for: Windows users who want to run Hermes Agent natively instead of through WSL.

How it fits with Hermes Agent

A fork of Hermes Agent itself, based on upstream 0.13.0 and adapted for Windows.

How to install Hermes Agent Windows Fork

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/carterwayneskhizeine/hermes-agent-windows-R.git
cd hermes-agent-windows-R
uv venv venv --python 3.12
.\venv\Scripts\Activate.ps1

Requirements: Windows with uv and Python 3.12; the repository's Windows Quick Start lists the full requirements

Note: It is a fork based on upstream Hermes Agent 0.13.0 and is not the official Nous Research release.

FAQ

What is Hermes Agent Windows Fork?

Hermes Agent Windows Fork is a development fork of Hermes Agent, based on upstream 0.13.0, that makes the agent run natively on Windows. It fixes path handling, encoding, process management and terminal backend issues.

Does Hermes Agent Windows Fork require WSL?

No. The project describes itself as Windows-native and says no WSL is required.

How do I install Hermes Agent Windows Fork?

Clone the repository, create a Python 3.12 virtual environment with uv and activate it, then run uv pip install -e ".[all,dev]". After that, hermes model configures the model and hermes gateway run starts the gateway.