
Hermes‑Agent 是 NousResearch 开源、自带长期记忆、技能工作流、多平台网关的 AI 智能体支持 Windows / Linux / MacOS / Docker / 云服务器部署下面分系统安装、初始化配置、模型接入、网关对接、本地 Ollama、手动源码部署、常见报错全套流程。一、前置须知本质只是智能体框架必须配置大模型 API‑KeyDeepSeek、OpenRouter、通义千问、Ollama 本地模型均可最低硬件内存 ≥2G推荐 4G 以上环境依赖脚本会自动安装 uv、Python3.11、Node22、ffmpeg、ripgrep无需手动预装二、一键安装推荐1Linux /macOS/ WSL2Ubuntu 子系统打开终端执行一键脚本国内镜像源curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash官方原版海外命令curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash安装完成后重启终端输入下面命令检测是否安装成功hermes--version2Windows 原生 PowerShell 安装无需 WSL右键开始菜单打开PowerShell (管理员)执行安装脚本irmhttps://res1.hermesagent.org.cn/install.ps1|iex安装结束关闭旧窗口新开 PowerShell 校验hermes--version安装目录%LOCALAPPDATA%\hermes\hermes‑agent3Docker 容器部署服务器首选先装好 DockerDocker‑Composecurl-fsSLhttps://get.docker.com|shsudousermod-aGdocker$USERnewgrpdocker创建部署文件夹、编写docker‑compose.ymlmkdir~/hermes-agentcd~/hermes-agentnanodocker-compose.ymlversion:3.8services:hermes-agent:image:hermesagent/hermes:latestcontainer_name:hermes-agentrestart:unless-stoppedports:-8080:8080environment:-LLM_PROVIDERopenrouter-LLM_API_KEY你的APIKEYvolumes:-./data:/root/.hermes启动容器dockercompose up-d三、初始化配置核心流程1、启动交互式配置向导hermes setup三种初始化模式Quick Setup登录 Nous 官方门户Blank Slate空白模式最推荐自定义第三方模型Full setup完整逐项配置所有工具、插件2、配置大模型接口执行模型配置命令hermes model选择模型服务商OpenRouter / DeepSeek / 通义千问 / 自定义接口 / Ollama 本地填入 API‑Key、接口地址、模型名称 接入本地 Ollama 模型本机装好 Ollama拉取模型示例 qwen3ollama pull qwen3hermes‑agent 模型列表选择Custom endpoint接口地址填写http://127.0.0.1:11434/v1模型名ollama/qwen33、启动交互式 CLI 对话hermes现在即可开启带长期记忆、工具调用的 AI 智能体对话。四、配置消息网关对接 TG / 飞书 / 微信 / Discord 机器人网关可以让你在聊天软件远程操控 Hermes‑Agent示例 Telegram‑Bot 部署Telegram 找到BotFather发送/newbot设置机器人名称、用户名必须_bot结尾获取机器人 Token/setprivacy→ Disable 关闭隐私允许读取群聊消息终端运行网关配置hermes gateway setup平台选择Telegram粘贴 Bot‑Token设置允许访问的用户 ID启动网关后台服务# 前台运行hermes gateway# 安装系统后台服务Linuxhermes gatewayinstall# 启动服务systemctl start hermes-gateway五、源码手动编译安装开发者模式# 克隆仓库gitclone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcdhermes-agent# 安装uv包管理器curl-LsSfhttps://astral.sh/uv/install.sh|sh# 创建虚拟环境、安装依赖uv venv .venvsource.venv/bin/activate uv pipinstall-e.六、常用基础命令汇总hermes setup# 初始化配置向导hermes model# 切换/配置大模型hermes# 进入交互式终端对话hermes gateway setup# 聊天机器人网关配置hermes update# 一键升级最新版本hermes reset# 重置所有配置、记忆数据七、常见报错 解决方案hermes 命令找不到安装结束后重启终端Windows 检查环境变量是否刷新WSL 网络无法拉取安装脚本使用国内镜像安装脚本WSL2 配置代理调用模型报错 401API‑Key 错误、余额不足、接口地址填写错误Windows 缺少 ffmpeg、ripgrep新版安装脚本会自动下载旧版手动下载工具放到程序目录服务器部署内存溢出关闭其他进程保证 ≥2G 空闲内存八、进阶功能记忆系统自动保存对话记忆、长期偏好跨会话读取Skill 技能重复执行的复杂任务可保存成自定义工作流支持工具调用Shell 命令、文件读写、浏览器自动化、定时任务、API 请求那么我们如何学习AI大模型呢这份精心整理的AI大模型学习资料我整理好了免费分享只希望它能用在正道上帮助真正想提升自己的朋友。让我们一起用技术做点酷事ps:微信扫描即可获取加上后我将逐一发送资料与志同道合者共勉真诚无偿分享适学人群我们的课程体系专为以下三类人群精心设计AI领域起航的应届毕业生提供系统化的学习路径与丰富的实战项目助你从零开始牢牢掌握大模型核心技术为职业生涯奠定坚实基础。跨界转型的零基础人群聚焦于AI应用场景通过低代码工具让你轻松实现“AI行业”的融合创新无需深奥的编程基础也能拥抱AI时代。寻求突破瓶颈的传统开发者如Java/前端等将带你深入Transformer架构与LangChain框架助你成功转型为备受市场青睐的AI全栈工程师实现职业价值的跃升。※大模型全套学习资料展示通过与MoPaaS魔泊云的强强联合我们的课程实现了质的飞跃。我们持续优化课程架构并新增了多项贴合产业需求的前沿技术实践确保你能获得更系统、更实战、更落地的大模型工程化能力从容应对真实业务挑战。资料内容涵盖了从入门到进阶的各类视频教程和实战项目无论你是小白还是有些技术基础的技术人员这份资料都绝对能帮助你提升薪资待遇转行大模型岗位。01 大模型系统化学习路线作为学习AI大模型技术的新手方向至关重要。 正确的学习路线可以为你节省时间少走弯路方向不对努力白费。希望这份最科学最系统的学习成长路线图和学习规划带你从零基础入门到精通微信扫描下方二维码即可~本教程比较珍贵仅限大家自行学习不要传播更严禁商用02 大模型学习书籍文档新手必备的权威大模型学习PDF书单来了全是一系列由领域内的顶尖专家撰写的大模型技术的书籍和学习文档电子版从基础理论到实战应用硬核到不行※真免费真有用错过这次拍大腿03 AI大模型最新行业报告2025最新行业报告针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估以了解哪些行业更适合引入大模型的技术和应用以及在哪些方面可以发挥大模型的优势。04 大模型项目实战配套源码学以致用在项目实战中检验和巩固你所学到的知识同时为你找工作就业和职业发展打下坚实的基础。05 大模型大厂面试真题面试不仅是技术的较量更需要充分的准备。在你已经掌握了大模型技术之后就需要开始准备面试我精心整理了一份大模型面试题库涵盖当前面试中可能遇到的各种技术问题让你在面试中游刃有余。06 全套AI大模型应用开发视频教程包含提示工程、RAG、LangChain、Agent、模型微调与部署、DeepSeek等技术点由于篇幅有限只展示部分资料并且还在持续更新中…ps:微信扫描即可获取加上后我将逐一发送资料与志同道合者共勉真诚无偿分享最后祝大家学习顺利抓住机遇共创美好未来