HermesAgent Native Offline Installer for Windows: Use Hermes on Windows Without a VPN or WSL

A HermesAgent installation guide for Windows users. No WSL, no VPN, and no extra setup hassle. Follow the steps to install Hermes, configure the API, and connect WeChat on a native Windows machine.

**This is a HermesAgent installation guide for Windows users.** No WSL, no VPN, and no extra setup hassle. Follow the steps below to install Hermes, configure the API, and connect WeChat on a native Windows machine.

**Who is this for**
Anyone who wants to run Hermes directly on a Windows PC with as little friction as possible.

**What you will complete**
Install Hermes, verify the command works, configure the API, launch the TUI, and optionally connect the WeChat gateway.

# Installation Options Overview

---

# Option 1: Online Installation When a Proxy / VPN Is Available

If your Windows computer has a proxy / VPN connection, use this option first. It takes fewer steps and installs faster.

1. Copy the Windows install command into PowerShell and run it.
2. Or run this install command directly:

```powershell
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDcyNmVhODFmODIyOTk5YjIwNDk2ZWVjNWQxOTI0YTVfOTkzMGFkNmRkNTlhZTQ5MTE3NDA4NjY2MWZlZTg5ODJfSUQ6NzYzOTcwODEwOTI3MTA1OTQyMl8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

Wait for the installer to finish and follow the prompts.

---

# Option 2: Use the Offline Package Without a Proxy / VPN

**Offline package download links**
- Baidu Netdisk: [https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq](https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq) (code: f2uq)
- Quark Drive: [https://pan.quark.cn/s/aee345d1864b](https://pan.quark.cn/s/aee345d1864b)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MGE5NTRhYjZmNzhmYzljYTdmMjNhOTg1MzEyYTUyMDVfNzc4NWU0YTFjMTY5NDE3ZWNmZDBhNGRhNDI1Y2QwNjZfSUQ6NzYzOTcwODExMjExNjQ4NTA5M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

1. Download and extract the Hermes offline installation package.
2. Double-click `安装 hermes.cmd`. The package already includes the latest source code and dependencies, so extra configuration is usually unnecessary.

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=OWJmYWFjNDVkZmY0ZGY1ODE4MjE0MDQxM2NlMjViMzNfYjk3NGJlMmM5NjVkNmRhMWEwNTc1NTNiODA5MjRhMzJfSUQ6NzYzOTcwODExMTk4OTIxNDE1M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=YWZhNTQ1MWQ1MzgwMGRmNDNkODA1MDljNmQ0YzQ0MTRfNGI3NmMyMzI2ZTg1YjNhYTIyNDZmNGVlNGE4NjI1ZTZfSUQ6NzYzOTcwODExNDMxNzAyMDA5Ml8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDY1MTdkYjYyODllYWU0ODVhMTkyZDA0ZTRmNjgyMGFfOGQ3ODI1NGVhYTc4MGU2OTBlYTdkOTQxN2Y0ODI0NjVfSUQ6NzYzOTcwODExODc3MTEwODgwOV8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

Installation usually takes 2 to 3 minutes. Press any key to exit when it finishes.

---

# Verify That Installation Succeeded

1. Open PowerShell or CMD.
2. Run `hermes --version`.
3. If the terminal returns a version number, Hermes has been installed successfully.

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=M2FlYzA1Y2FjY2M3NjFkYWVhNGIwY2FiZjkxMmE5YzRfZjZjMjhiZjRjZTcwNDA4OTIwZDJlNjZlOThjOTk3YzNfSUQ6NzYzOTcwODEyMjY0NjM2NzE4OF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

---

# Configure the Hermes API Service

**The most common mistake here is pasting the API key.** In the Windows terminal, do not use `Ctrl + V`. Paste only once with the right mouse button. Repeated right-clicking can paste the key multiple times and break it.

1. Run `hermes model` to enter the model configuration wizard.
2. If you are using a custom provider, choose the corresponding number. In this document, the selected number is 36.