# 我在五个平台上装了 Hermes Agent，有的丝滑有的想砸电脑
## 写在前面
最近 Hermes Agent 火得一塌糊涂，群里天天有人问”怎么装啊”、”装不上怎么办”。我这人有个毛病，看到新东西就想折腾。于是上个月我拿手头所有设备挨个装了一遍 Hermes——MacBook、Ubuntu 服务器、Windows 笔记本、WSL2、甚至还在安卓手机的 Termux 里试了一把。
结果？有的平台五分钟搞定，爽得我想给开发者写感谢信；有的平台折腾了俩小时，差点把电脑格式化。今天就把我的真实经历写出来，省得你们踩我踩过的坑。
## 先说最重要的：Python 版本
在聊各平台之前，必须先提一个巨坑——**Python 版本**。Hermes Agent 要求 Python 3.10 到 3.12，3.13 不兼容。你别笑，这事儿我亲眼见群里有人中招。一个哥们儿兴冲冲装完 Python 3.13，跑安装脚本报了一屏红字，愣是看了二十分钟才反应过来版本不对。
我自己倒是没犯这个错，但 Ubuntu 22.04 默认的 Python 版本是 3.10，这个刚好在支持范围内。如果你用的是更新的系统，记得先 `python3 –version` 看一眼。
## macOS：五星好评，闭眼装就完事了
如果你用的是 Mac，那恭喜你，这是最舒服的安装体验。
前提是你得有 Homebrew，这个大多数 Mac 开发者应该都有了。没有的话一行命令装上：
“`bash
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”
“`
然后装 Python 3.12：
“`bash
brew install python@3.12
“`
最后跑一键安装脚本：
“`bash
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
“`
整个过程不到五分钟，没有任何报错。我用的是 M2 MacBook Air，arm64 架构完全原生支持，连 Rosetta 都不需要转译。跑完 `hermes –version` 看到版本号那一刻，我想说——这才叫用户体验。
Apple Silicon 的 Mac 朋友们可以放心冲，这是目前体验最好的平台，没有之一。
## Linux（Ubuntu/Debian）：也挺好，但你得会用终端
我在一台 Ubuntu 22.04 的云服务器上装的，整体也很顺利。
“`bash
sudo apt update && sudo apt install python3 python3-pip python3-venv git curl -y
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
“`
装完跑 `hermes –version` 一切正常。整个过程大概三分钟，比 Mac 还快，毕竟服务器网络好嘛。
如果你是 Fedora 或者 Arch 用户，命令稍有不同，但基本都是 `dnf` 或者 `pacman` 换一下包管理器的事儿。安装脚本本身会自动检测你的发行版然后用对应的镜像源，这个设计挺贴心的。
不过有个小细节要注意：装完之后如果你用的是 bash，记得 `source ~/.bashrc`，不然 `hermes` 命令会找不到。我第一次就在这卡了一下，以为装失败了，白紧张了半分钟。
## Windows PowerShell 直装：能跑，但我不推荐
官方是支持 Windows 直装的，用 PowerShell 执行：
“`powershell
irm https://res1.hermesagent.org.cn/install.ps1 | iex
“`
理论上一行命令搞定。但我实测下来，问题不少。
首先你得确保 Python 和 Git 都装好了，而且加到了 PATH 里。光是这一步就够很多非技术用户喝一壶的。然后 PowerShell 的执行策略默认是禁止运行脚本的，你还得先 `Set-ExecutionPolicy RemoteSigned`，这一套操作下来，新手早就劝退了。
我自己的体验是，PowerShell 装完之后偶尔会有路径解析的问题，特别是 Python 虚拟环境的激活脚本，Windows 的路径分隔符和 Unix 不一样，偶尔会报些莫名其妙的错。
**我的建议：别折腾直装了，直接用下面说的 WSL2。**
## WSL2：Windows 用户的正道
如果你是 Windows 用户又想用 Hermes，WSL2 是唯一正确的选择。
装好 WSL2 之后，在 Ubuntu 终端里跑跟 Linux 一样的命令就行：
“`bash
sudo apt update && sudo apt install python3 python3-pip python3-venv git curl -y
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
“`
体验和原生 Linux 几乎一样，我测了十分钟没出任何幺蛾子。WSL2 本质上就是一个轻量级的 Linux 虚拟机，兼容性非常好。
唯一的缺点是 WSL2 对 GPU 的支持需要额外配置（要装 WSL-specific 的 CUDA 驱动），如果你打算跑本地模型的话得折腾一下。但如果只是调用 API 的话，完全没问题。
我的 Windows 笔记本就是这么用的，WSL2 里装 Hermes，VS Code 装 WSL Remote 插件，开发体验和原生 Linux 差不多。
## Docker：懒人方案，但别指望太多
Hermes 官方提供了 Docker 镜像：
“`bash
docker run -it –rm -v ~/.hermes:/root/.hermes hermesagent/hermes:latest
“`
这个方案的好处是完全不污染宿主机环境，干净利落。如果你只是想快速体验一下，或者你的系统环境实在太乱了搞不定，Docker 是个不错的退路。
但说实话，Docker 方案不适合长期使用。每次启动都要手动挂载配置目录，而且交互体验不如原生安装流畅。我用了一次就换回原生安装了。
## 踩坑总结
折腾了一大圈，我总结一下各平台的安装难度排名：
| 平台 | 难度 | 一句话评价 |
|——|——|———–|
| macOS (Apple Silicon) | ⭐ | 闭眼装，五分钟搞定 |
| Linux (Ubuntu/Debian) | ⭐⭐ | 很顺利，注意 source 一下 bashrc |
| WSL2 | ⭐⭐ | Windows 用户的最佳选择 |
| Docker | ⭐⭐⭐ | 适合体验，不适合日常 |
| Windows PowerShell | ⭐⭐⭐⭐ | 能装但坑多，不推荐 |
最后再啰嗦一句：装完之后跑 `hermes setup` 进配置向导，会让你选模型和配置消息平台。如果你之前从来没用过，跟着向导走就行，挺傻瓜式的。
好了，我的踩坑之旅就分享到这里。如果你在某个平台遇到了我没提到的问题，欢迎在评论区交流——毕竟折腾这种事，集思广益才是王道。