一、Hermes agent 大模型选择Hermes Agent 通过统一的模型抽象层接入不同厂商的大语言模型服务。实际部署时建议根据数据合规要求、任务类型和成本预算进行选型。1.1 国内场景Kimi K2.6对于数据需境内处理或存在私有化部署需求的场景Kimi K2.6 是社区部署验证较多的选项。该模型支持超长上下文窗口在长链路任务中能够保持相对连贯的状态跟踪降低中途信息丢失的概率。其原生 Function Calling 实现较为成熟在多工具协同编排时异常率较低适合需要频繁调用外部工具的工作流。中文指令理解与本土业务文档解析的精度较高能够适配国内办公自动化场景。并发场景下多 Agent 同时运行的限流与超时风险相对可控。私有化部署方案支持内网数据闭环符合政企安全合规要求。从成本角度看其 Token 利用率与定价在同类模型中处于较低区间适合高频调用的生产环境。1.2 海外场景OpenAI GPT 系列若任务涉及复杂逻辑推理、英文内容处理或多模态输入可考虑接入 OpenAI GPT-3.5/4。该系列在任务拆解与复杂逻辑链处理方面能力较强支持图像理解与图文混合内容处理且第三方工具集成生态较为完善。接入海外模型需确保网络可达并评估数据跨境传输的合规风险。二、前置准备部署前请确认以下环境依赖已就绪Git版本不低于 2.0用于源码拉取与后续版本更新。API 凭证已申请 KimiMoonshot AI或 OpenAI 的 API Key。Windows 环境如使用 Windows需预先配置 WSL2安装脚本执行期间将请求系统管理员权限以完成环境配置。三、安装 hermes agent1.1 Windows 详细安装教程方式一WSL2 安装推荐新手使用检查 Windows 版本WSL2 需要 Windows 10版本 2004 或更高或 Windows 11。选择终端 (管理员) 或 Windows PowerShell (管理员)在 UAC 弹窗点击 “是”。安装 WSL2在 PowerShell 里输入这条命令然后按回车wsl --install注意等待安装完成可能需要几分钟。完成后会提示你重启电脑。重启后设置 Linux 用户名和密码在 WSL2 里安装 Hermes Agent现在你已经在 Ubuntu 里了输入这条命令curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash等几分钟安装完成后输入source ~/.bashrc hermes看到欢迎界面就成功了方式二PowerShell 原生安装打开 PowerShell按 Win 键输入PowerShell点击Windows PowerShell。这次不需要管理员权限运行安装命令复制下面这行粘贴到 PowerShell 里按回车irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex等待安装完成安装过程可能需要 3-5 分钟期间会自动下载 Python、Node.js 等依赖。看到Installation complete就成功了。1.2 macOS 详细安装教程克隆项目到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git将下面代码复制到安装目录mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent进入目录并执行安装脚本cd ~/.hermes/hermes-agent bash scripts/install.sh重载环境变量# Zsh 用户执行source ~/.zshrc # Bash 用户执行二选一# source ~/.bashrc1.3 Linux 详细安装教程克隆项目到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git将下面代码复制到安装目录mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent进入目录并执行安装脚本cd ~/.hermes/hermes-agent bash scripts/install.sh重载环境变量# source ~/.zshrc四、Kimi 大模型接入配置向导安装完成后运行 hermes 命令你会看到一个配置向导界面。输入 1 并按回车进入快速设置模式。1、选择模型提供商在这一步内可以选择你想使用的 AI 模型提供商。**国内用户推荐选择 KimiMoonshot**在国内网络环境下Kimi 凭借稳定的连接速度、出色的中文语义理解能力和高性价比成为绝大多数开发者部署 Hermes Agent 的优选方案。**海外用户选择 OpenRouter、Anthropic **等海外主流模型平台全球网络连通稳定流畅。这类平台模型性能强劲、接口兼容性高能充分满足海外场景下智能代理的各类运行需求2、输入 API 密钥选择提供商后系统会提示你输入 API 密钥以 Kimi 提供商为例展示获取方式登录 Kimi 网站获取 API Key访问 https://platform.moonshot.cn/console 点击登录点击左侧的 API Key 管理创建 API Key复制弹出的密钥字符回到 hermes agent 继续配置3、选择默认模型将复制的 API Key 贴入终端并敲击回车然后选择 Moonshot/Kimi-K2.6 模型并敲击回车确认。4、配置工具接下来会询问你想启用哪些工具。新手建议先启用基础工具web # 网络搜索和网页提取 terminal # 执行命令 file # 读写文件 browser # 浏览器自动化可选5、配置完成全部配置完成后就可以开始对话啦~6、安装后的第一件事装好之后我建议你立刻做一件事设置持久记忆。在对话中输入——hermes 请记住我的主力编程语言是 Python我偏好使用 Docker 部署服务回复请用中文Hermes Agent 会把这些偏好写入持久记忆文件。之后每次对话它都会带着这些上下文让回复更贴合你的习惯。你也可以直接编辑~/.hermes/memory/prompt.md文件手动写入你的偏好信息。记住这个文件有 3575 字符的限制言简意赅就好。五、常见问题及解决办法1、环境准备类问题Windows 用户高发Windows 直接安装失败未用 WSL2错误表现安装脚本报错、命令无法执行、界面无响应核心原因Hermes Agent 仅支持 Linux/macOS/WSL2不支持 Windows 原生 PowerShell/CMD解决方案# 以管理员身份运行PowerShell启用WSL2 wsl --install -d Ubuntu # 安装后设置默认启动WSL wsl --set-default Ubuntu2、网络与资源下载问题国内用户常见官方脚本下载失败GitHub 访问受限错误表现curl: (7) Failed to connect to raw.githubusercontent.com核心原因国内网络无法直接访问 GitHub 资源解决方案 方法 1推荐使用离线安装包cd /mnt/d/Downloads # 进入安装包目录 sudo apt install -y unzipunzip hermes-agent-2026.4.8.zip cd hermes-agent bash install.sh方法 2配置代理后重试 export http_proxyhttp://代理地址:端口 export https_proxyhttp://代理地址:端口 curl -sSL https://get.hermesagent.com | bashPython 依赖安装超时PyPI 访问慢错误表现pip install长时间卡住、ReadTimeoutError解决方案使用国内镜像源加速pip install --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple/ 依赖包名3、命令与环境变量问题hermes: command not found安装后无法识别命令错误表现终端输入hermes提示未找到命令核心原因环境变量未加载或 PATH 未更新解决方案# 重新加载环境变量source ~/.bashrc # 或~/.zshrc根据Shell类型# 或直接重启终端版本不匹配Python/Node.js 版本冲突Python 问题Python 3.9 or older in PATH安装器需要 Python 3.11# 手动创建虚拟环境并指定版本 python3.11 -m venv hermes-venv source hermes-venv/bin/activateNode.js 问题ENOENT/EACCES错误Node.js 安装不完整# 删除残留文件并重新安装rm -rf ~/.nvm ~/.node-gyp curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install 184、依赖冲突与缺失问题Pydantic 版本冲突错误表现TypeError: BaseModel.validate() takes 1 positional argument but 2 were given核心原因Hermes 依赖 Pydantic v1系统安装了 v2语法不兼容解决方案pip uninstall -y pydantic pydantic-core pip install pydantic1.10.13六、结语好消息我们的 Hermes Agent 系统已经全部部署完成目前运行一切正常。最后选了 Kimi 作为核心推理引擎这也是社区里大家用得最多的方案踩坑少生态成熟。实测下来 Kimi 确实给力长上下文能力拉满原生工具调用也特别稳完全能 hold 住 Hermes Agent 的多步任务规划和全流程自主执行。现在代码生成、文档处理、数据分析、自动化运维这些核心功能都调通了已经正式投入使用整体效率和任务成功率比之前提升了一大截。