获课：shanxueit.com/13660/

Hermes本地部署，没你想的那么复杂

第一次接触Hermes的人，最容易被“本地部署”三个字吓住——以为要配环境、装依赖、改配置文件，折腾半天还跑不起来。但实际跑通之后你会发现，这件事比想象中简单得多。

Hermes是Nous Research开发的开源AI智能体框架，和普通聊天AI最大的区别在于：它能真正干活——读本地文件、执行终端命令、操作浏览器、整理桌面，而不是只会回答问题。而且它有个很特别的设计：双轨记忆系统，跨会话记住你是谁、偏好什么，不会每次打开都像第一次认识你。

下面是我从零部署的经验，分享一条最顺的路径。

一、选对安装方式，省掉一半麻烦

Hermes支持多种安装方式，新手最推荐的有两条路。

如果你是Windows用户，最省事的是用PowerShell一键安装，不需要WSL也能跑。打开PowerShell（建议7以上版本），执行这条命令：

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

脚本会自动帮你搞定Python 3.11、Node.js 22、uv包管理器、ripgrep搜索工具、ffmpeg多媒体工具这些依赖。安装完成后重启终端让环境变量生效，然后验证一下：

hermes --version

如果看到版本号，说明安装成功了。

如果你用Linux或macOS，用curl一键脚本更简单：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

然后刷新环境变量，source ~/.bashrc或source ~/.zshrc，同样用hermes --version验证。

安装过程里如果遇到安全软件拦截，属于正常现象，确认来源后放行即可。整个安装包只有几十MB，非常轻量。

二、配好模型，让AI“有脑子”

安装只是第一步，Hermes本身是个空壳，需要接入大模型才能干活。

国内用户最优解是Kimi。工具调用准确率96%，支持256K上下文窗口，而且国内直连不用代理。具体步骤：

1. 登录Kimi开放平台，进「API Key管理」创建一个新Key，复制保存（只显示一次）

2. 终端里运行hermes setup进入交互式配置向导

3. 服务商选「Moonshot (Kimi, China)」，粘贴API Key，模型选moonshot/k2.6

4. 新手建议勾选web、terminal、file这三个基础工具

如果不想走交互式向导，也可以直接用命令配置：

hermes config set model moonshot/k2.6
hermes config set MOONSHOT_API_KEY sk-你的API密钥

如果想用阿里云百炼，配置方式类似——设置model.provider为custom，填入对应Base URL和API Key。如果想完全离线，可以搭配Ollama跑本地开源模型。

三、跑起来，验证一下

配置完成后，终端输入hermes启动，看到欢迎信息就成功了。

建议先做个简单测试：“统计当前目录下有多少个Python文件”或“帮我检查当前目录的结构”。如果能看到Hermes调用工具、返回结果，说明整套系统已经跑通了。

四、新手最容易踩的三个坑

从自己和其他人的经验看，新手最容易卡在这三件事上：

一是环境变量没生效。安装完直接运行hermes提示找不到命令——重启终端就解决了。

二是模型配置参数不对。用Kimi时，模型名必须写成moonshot/k2.6，环境变量是MOONSHOT_API_KEY，大写不要写错。

三是路径带中文或空格。解压或安装路径尽量用纯英文，否则可能遇到奇怪的读写报错。

写在最后

Hermes本地部署的核心思路就是三步：一键安装→配置模型→启动验证。整个过程不需要敲复杂的代码，也不需要折腾环境变量。从零到跑通，正常情况半小时到一小时就够了。

跑起来之后，你会发现它跟普通AI聊天完全是两回事——能直接操作你电脑上的文件、执行命令、自动干活。本地部署的价值就在这儿：数据在自己手里，能力在本地跑，真正属于自己的数字员工。