Windows 跑 Hermes Agent：别硬刚，按这套流程走就顺了

我拿一台 2018 年的 ThinkPad E480（16GB 内存）折腾 Hermes Agent，遇到的坑比想象多。

很多人卡在“安装依赖”那一步，然后开始怀疑人生。

这篇给你一条能落地的路：

想省心：走 WSL2（推荐）
就想原生 Windows：也给你一套 不容易炸的装法

你照着做，能把 Hermes Agent 跑起来。不卡在“怎么又报错了”。

你先确认 3 件事（少走半天弯路）

1）你的机器大概能跑到什么程度

16GB 内存：能跑，建议选轻一点的模型。
没独显 / 只有核显：也能跑，就是速度别期望太高。
机械硬盘：强烈建议换 SSD。拉模型、解压缓存会把你折磨哭。

现实一点的目标：让它“能稳定跑 + 能完成任务”，不是追求秒回。

2）你打算用什么模型后端

Hermes Agent 本身是“代理”，它需要一个模型在后面回答。

常见组合：

Ollama（省事，适合本地跑）✅
OpenAI / 兼容接口（你有 API Key 就更省电脑）✅
LM Studio / vLLM（也行，看你习惯）

这篇用 Ollama 举例，因为它对 Windows 用户更友好。

3）你有没有“能正常访问 GitHub / HuggingFace”的网络

不少人不是装不成，是 下载卡死。

Git clone 慢
pip 安装慢
模型拉不下来

你如果网络不稳定，建议直接用 WSL2 + 配好镜像源，体验会好很多。

两条路线怎么选？

路线 A：WSL2（更稳）
- 你想少碰 Windows 的奇怪问题
- 你不想跟编译依赖、路径、编码死磕
路线 B：原生 Windows（也能跑）
- 你就想双击跑
- 你已经熟 conda/venv，也不怕报错

我更建议路线 A。WSL2 对这类 AI 项目真的是“降噪神器”。🙂

路线 A：WSL2 跑 Hermes Agent（推荐）

A1. 开 WSL2 + 装 Ubuntu

Windows 11 基本一句命令搞定：

wsl --install

装好后进 Ubuntu。

验证一下：

wsl -l -v

看到 VERSION 是 2 就对了。

A2. 在 WSL 里准备 Python 环境

sudo apt update
sudo apt install -y python3 python3-venv python3-pip git
python3 --version

建议 Python 3.10~3.12 之间（项目要求更严格就按项目来）。

A3. 拉 Hermes Agent 代码（以你实际仓库为准）

这里我不假设你用哪个具体仓库。你把项目 GitHub 地址替换进去就行。

git clone <你的 Hermes Agent 仓库地址>
cd <仓库目录>

如果仓库有 requirements.txt：

python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt

如果是 pyproject.toml（常见 Poetry/uv/pip-tools 风格）：

pip install -U pip
pip install .

A4. 装 Ollama（Windows 装也行）

你可以选择：

Ollama 装在 Windows：WSL 访问 Windows 的 Ollama 服务
Ollama 直接装在 WSL：更“纯 Linux”，少跨系统

新手建议：Ollama 装 Windows（安装体验更轻松）。

安装后在 Windows 里跑：

ollama --version

拉个 Hermes 系列模型（模型名以 Ollama 实际支持为准）：

ollama pull <hermes_相关模型名>

A5. 让 WSL 访问到 Windows 的 Ollama

Ollama 默认服务一般是 http://localhost:11434。

WSL 里访问 localhost 多数情况下是通的。

在 WSL 测一下：

curl http://localhost:11434/api/tags

能返回模型列表就说明通了。

A6. 配 Hermes Agent 的环境变量（常见做法）

不同项目的配置方式不一样。

你重点找这几类东西：

模型服务地址（Ollama base url）
模型名（model）
API key（如果走 OpenAI）

常见写法是 .env：

cp .env.example .env
nano .env

举个“你能理解的例子”（字段名按你项目实际来）：

LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=<hermes_相关模型名>

A7. 跑起来

项目一般会给你入口命令：

python main.py
python -m xxx
uv run xxx
poetry run xxx

你按项目 README 来。

如果你只是想快速验证：

让它做个简单任务：总结一段文字、生成一个待办列表
不要一上来就让它“全自动写代码 + 查资料 + 操作浏览器”

先确保链路通：Agent → 模型 → 返回结果。

路线 B：原生 Windows 跑 Hermes Agent（不想用 WSL 就看这段）

Windows 原生最大的问题就三个：

依赖里有编译步骤（你缺 C++ 工具链就会爆）
路径/权限/中文目录搞事情
Python 环境混乱（系统里装了 3 个 Python）

B1. 统一你的 Python（建议用 Miniconda）

去装 Miniconda，然后：

conda create -n hermes python=3.11 -y
conda activate hermes
python --version

B2. 把项目放在“干净路径”

别放：

桌面
下载
OneDrive 同步目录
路径里有中文/空格/超长

B3. 安装依赖

cd D:\projects\hermes-agent
pip install -U pip
pip install -r requirements.txt

如果你看到类似报错：

Microsoft Visual C++ 14.x is required
failed building wheel

去装：Visual Studio Build Tools（勾选 C++ build tools）。

这一步是 Windows 原生最常见的劝退点。😤

B4. 配 Ollama

装好 Ollama 后：

ollama pull <hermes_相关模型名>

然后按项目方式写 .env 或配置文件。

我踩过的坑（你能躲掉就别体验了）

1）内存不够，卡到像死机

16GB 也会不够用，尤其你：

开着浏览器十几个标签
VS Code + Docker + 微信
再跑个 7B/13B 模型

建议：

任务时关掉重应用
模型选小一点
Agent 的工具链别一次开太多

你想要的结果是：它稳定跑完一个任务，不是把系统拖死。

2）模型拉不下来，不要盯着进度条发呆

换网络
换时间段
用能断点的方式（工具本身支持最好）

实在不行，改用 API 接口跑一阵，先把流程跑通。

3）路径太长/权限问题

Windows 对某些工具的路径长度很敏感。

表现：

安装依赖报奇怪的 file not found
缓存写入失败

解决：

项目目录放短路径
尽量别放系统盘权限严格的地方

4）终端编码导致输出乱码

你看到中文全是方块，多半是终端编码。

能用 Windows Terminal 就别用老 CMD。

WSL 里基本少见这问题。

5）“跑起来了，但 Agent 不干活”

常见原因：

模型名写错（Ollama 里实际模型名不一样）
base url 写错
Agent 工具权限没开（比如需要浏览器、文件读写）

排查顺序建议这么来：

直接 curl 模型服务，看通不通
用最简单的 prompt 测一条返回
再上工具调用

一套很实用的验证清单 ✅

你按这个过一遍，基本就能定位问题在哪：

[ ] python --version 是项目要求的版本
[ ] 能 pip install 完成且无红色报错
[ ] Ollama 服务开着：curl http://localhost:11434/api/tags 有返回
[ ] .env 里模型名和 Ollama 里一致
[ ] 用一个“只聊天不调用工具”的最小任务能跑通
[ ] 再测试工具：读文件、写文件、联网（如果项目允许）

你想让我把步骤对齐到“你用的那个 Hermes Agent 项目”也行

你把下面信息丢给我，我可以把命令和配置项写到“复制就能用”的程度：

你用的 Hermes Agent 仓库链接（或 README 截图）
你准备走 Ollama 还是 OpenAI 接口
你的 Windows 版本 + 是否有独显
你卡住的报错截图

别硬扛。报错这东西，懂的人看两眼就知道该从哪下手。

Windows 本地跑 Hermes Agent：老 ThinkPad 也能跑顺，坑我替你踩完了