How to Install Hermes Agent on Windows 11 (Native and WSL2)

Should you use WSL2 or the native Windows path?

Choose WSL2 if you want the closest match to the documented Linux experience, and the native path if you need the agent to live inside your normal Windows shell and toolchain.

• WSL2 follows the Linux instructions closely, so fewer steps differ from the documentation.
• WSL2 keeps the agent isolated from your Windows user profile.
• The native path keeps the agent next to your Windows tooling and files.
• Either path works with the same model providers and messaging channels.
• Pick one and stay on it, because mixing environments is the most common source of confusing failures.

How do you verify the install actually works?

Verification is not 'the installer finished'. Start the agent, confirm the gateway is listening, confirm the model provider responds, and only then connect a channel.

Test in that order. If the channel does not answer, you then know whether the fault is in the agent runtime or in the channel credentials, which is the difference between a five-minute fix and an afternoon of guessing.

• Work through the deployment checklistUse the same ordered checks for local and hosted installs.

What breaks on a local Windows install?

The common failures are an environment mismatch, a gateway that is not listening, missing channel permissions, or a model key without quota. None of them are Windows-specific, but all of them are easier to hit when the platform differs from the documentation.

Sleep and restart behaviour is the other difference worth knowing about. A laptop that suspends overnight will stop answering, which is fine for experimentation and unacceptable for a team channel.

• Troubleshoot missing messagesSeparate channel, runtime, and model failures in order.

When is a managed deployment the better answer?

Move to a managed deployment when the agent needs to be available when your laptop is closed, when more than one person depends on it, or when nobody wants to own updates and restarts.

A local install is the right way to evaluate Hermes Agent. It is the wrong way to run a channel other people rely on, because the runtime inherits every limitation of the machine it sits on.

• Deploy Hermes Agent without a serverCompare the local and managed paths end to end.