hermes-agent/website/docs/user-guide/windows-wsl-quickstart.md
2026-05-05 14:14:03 -07:00

1.1 KiB

title description sidebar_label sidebar_position
Windows (WSL2) Quick Start Run Hermes Agent on Windows using WSL2 — supported path for CLI and Tool Gateway Windows (WSL2) 2

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.

:::info 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.