Skip to main content

Windows (WSL2) Quick Start

Hermes Agent is developed and tested on Linux and macOS. On Windows, the supported setup is WSL2 (Windows Subsystem for Linux), not legacy native Windows shells.

Full guide in Chinese

The detailed checklist (WSL2, uv, repo clone, gateway tips) is maintained in 简体中文. Use the language menu (top right) and select 简体中文, then open this same page again.

Minimum path​

  1. Install WSL2 and a recent Ubuntu (or another supported distro).
  2. Open your WSL terminal and follow Installation inside that environment.
  3. Run hermes model / hermes tools from WSL so paths, process isolation, and the Tool Gateway match upstream expectations.

For Tool Gateway and image tooling behavior, see Tool Gateway and Image Generation.