HermesAgent本地安装教程｜一键部署AI助手

Hermes Agent是一款面向本地化部署的智能办公AI助手，支持一键式安装、轻量模型（如gemma4:e4b）快速接入、CLI交互与微信深度协同，无需公网暴露即可实现私有化、可长期运行且具备自我进化潜力的AI工作流——无论你是技术爱好者还是效率追求者，只需几分钟配置，就能拥有一个完全掌控在自己设备上的专属AI办公伙伴。

如果您希望在本地快速搭建一个可长期运行、具备自我进化能力的AI办公助手，则Hermes Agent提供了一键式部署路径。以下是适用于主流操作系统的本地安装步骤：

一、检查系统与环境依赖

安装前需确认基础运行环境满足最低要求，避免后续执行中断。Hermes Agent依赖Python 3.12+、Node.js 18+、Git 2.30+及ripgrep工具，缺失任一组件均可能导致脚本失败。

1、打开终端（macOS/Linux）或WSL2（Windows），执行python3.12 --version验证Python版本；若未安装，请使用对应包管理器安装。

2、运行node -v确认Node.js版本不低于18；低于该版本时需升级，推荐使用nvm管理多版本。

3、执行git --version和rg --version分别检查Git与ripgrep；若提示命令未找到，按系统执行对应安装命令：macOS用brew install ripgrep，Ubuntu用sudo apt install -y ripgrep。

二、执行一键安装脚本

官方提供跨平台兼容的安装脚本，自动检测已有组件、创建虚拟环境、拉取最新代码并完成初始化配置，全程无需手动干预核心流程。

1、复制并粘贴以下命令至终端执行：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。

2、等待脚本输出✅ Hermes Agent installed successfully提示，表示主程序已就位。

3、运行hermes --version验证CLI是否可用；若返回版本号（如v0.9.4），说明安装成功。

三、配置本地模型后端

Hermes Agent默认通过Ollama对接本地大模型，需预先拉取并运行至少一个兼容模型，否则启动时将报错“no model available”。

1、确保Ollama服务正在运行：执行ollama list，若无响应则先启动Ollama应用或服务进程。

2、拉取轻量级Gemma 4 E4B模型：ollama pull gemma4:e4b；该模型可在16GB内存设备上稳定运行。

3、设置Hermes Agent默认模型为gemma4:e4b：编辑~/.hermes/.env文件，在LLM_PROVIDER行后添加OLLAMA_MODEL=gemma4:e4b。

四、启动并验证服务

完成模型配置后，启动Hermes Agent服务并测试其基础响应能力，确认CLI交互通道畅通。

1、在终端中输入hermes start，观察日志输出是否出现? Hermes Agent is running on http://localhost:8000。

2、新开终端窗口，执行hermes chat进入交互模式；输入你好，等待返回结构化响应而非报错信息。

3、若首次响应延迟超过30秒，检查Ollama是否正加载模型——可另开终端运行ollama run gemma4:e4b预热模型。

五、接入微信实现办公协同

Hermes Agent原生支持微信扫码绑定，无需公网IP或Webhook配置，适合个人办公场景下即时消息收发与任务触发。

1、确保手机微信已登录且网络通畅，执行hermes wechat login命令。

2、终端将生成一个二维码，使用微信“扫一扫”功能扫描该码，完成账号授权绑定。

3、绑定成功后，微信中向该账号发送任意文本（如/help），观察终端是否实时打印接收日志并返回帮助信息；若无日志输出，检查是否开启微信隐私设置中的“允许其他应用读取聊天记录”选项。

以上就是《HermesAgent本地安装教程｜一键部署AI助手》的详细内容，更多关于的资料请关注golang学习网公众号！