核心结论推荐使用官方一键安装脚本最快2分钟完成适配Linux/macOS/WSL2/Android(Termux)不支持原生Windows系统开发者可选手动安装。安装后执行hermes setup配置模型与API即可开始使用。一、前置知识与环境准备1.1 核心特性与部署前提在开始部署前建议先了解 Hermes Agent 的核心特性这将帮助您更好地理解后续的配置逻辑与系统能力智能自我进化基于 FTS5 全文检索技术实现跨会话持久记忆能够自动学习用户行为并生成程序化技能随着使用时长增加系统会越来越贴合您的个人习惯与工作流程全生态兼容支持 Telegram、Discord、Slack、微信等主流消息平台作为交互入口同时兼容 Kimi、Nous Portal、OpenAI、Anthropic 等国内外主流大模型提供商极致轻量化提供单行命令一键安装方案最低仅需 2 核 2G 服务器配置即可稳定运行推荐使用 4 核 8G 配置以获得更流畅的交互体验完全开源采用宽松的 MIT 开源许可证允许无限制地修改、分发和二次开发拥有活跃的全球开发者社区提供技术支持与生态贡献1.2 硬件与系统要求准备类别核心要求系统要求Linux/macOS/WSL2硬件最低要求CPUx86_64/ARM64 内存256MB 存储100MB 网络稳定联网必须前置依赖Git2.01.3 前置依赖安装Hermes Agent的安装脚本会自动处理Python 3.11、Node.js v22等核心依赖无需手动安装仅需确保系统已安装git用于拉取源码部分部署方式需用到1.3.1 LinuxUbuntu/Debian# 更新系统包 sudo apt update sudo apt upgrade -y # 安装git sudo apt install git -y # 验证git安装 git --version1.3.2 macOSmacOS通常自带git若未安装通过Homebrew安装# 安装Homebrew若未安装 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 安装git brew install git # 验证git安装 git --version1.3.3 WSL2Windows应用商店安装 WSL2推荐 Ubuntu 22.04打开 WSL2 终端执行 Linux git 安装命令1.4 国内网络加速必做国内服务器/本地环境访问GitHub 、pip/npm镜像速度较慢提前配置加速可避免安装失败配置完成后可正常执行后续步骤1.4.1 Git镜像加速全局配置git config --global url.https://mirror.ghproxy.com/https://github.com.insteadOf https://github.com1.4.2 pip镜像加速pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ pip config set install.trusted-host mirrors.aliyun.com1.4.3 设置npm镜像npm config set registry https://mirrors.cloud.tencent.com/npm/ --global二、全平台三种安装方式推荐新手选择第一种Hermes Agent 一共有三种部署方法大家可以根据自己的情况来选如果你是新手直接用单行命令安装就行复制粘贴一条命令就能搞定最简单最快如果你要部署到生产环境建议用Docker 部署环境隔离做得好不会和其他服务冲突如果你是开发者想要自己改代码加功能那就选择源码部署自由度最高2.1 Linux / macOS / WSL2最稳定新手优选国内镜像源优先使用速度最快curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash国际官方源海外用户使用curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装后必执行刷新环境变量# bash 用户 source ~/.bashrc # zsh 用户 source ~/.zshrc永久生效直接关闭当前终端重新打开新终端即可2.2 Docker部署环境隔离推荐生产环境Docker部署可实现环境隔离避免与系统其他软件冲突适合长期运行和生产环境步骤如下# LinuxUbuntu安装Docker sudo apt install docker.io -y # 启动Docker服务 sudo systemctl start docker sudo systemctl enable docker # 验证Docker安装 docker --version # 拉取官方最新镜像v0.8.0 docker pull nousresearch/hermes-agent:latest # 验证镜像拉取成功 docker images | grep hermes-agent # 创建本地配置目录用于持久化配置 mkdir -p ~/.hermes/docker-config # 启动容器后台运行映射配置目录 docker run -d \ --name hermes-agent \ -v ~/.hermes/docker-config:/root/.hermes \ -p 8080:8080 \ nousresearch/hermes-agent:latest # 查看容器运行状态 docker ps | grep hermes-agent2.3 源码手动安装适合开发者# 克隆仓库 git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 创建并激活虚拟环境 python3.11 -m venv venv source venv/bin/activate # Linux/macOS venv\Scripts\activate # Windows # 安装依赖 pip install --upgrade pip pip install -e .[all] # 创建软链接可选方便全局调用 mkdir -p ~/.local/bin ln -sf $(pwd)/venv/bin/hermes ~/.local/bin/hermes三、核心配置重要提示安装完成后必须完成基础配置否则 Hermes Agent 将无法正常运行。基础配置主要包括模型参数设置和工具权限开启两部分以下配置方法适用于所有部署方式本文以单行命令安装为例进行演示。3.1.交互式配置向导推荐hermes setup按提示选择LLM服务、输入API密钥、配置记忆后端等。3.2 模型配置关键步骤Hermes Agent支持多种模型提供商可根据自身需求选择推荐国内用户使用Kimi国内优选处理长文能力强免费额度充足国外用户可选择Anthropic、OpenAI也可使用Ollama部署本地模型完全离线。3.2.1 配置Kimi推荐1# 设置模型为Kimi hermes config set model Kimi/Moonshot China # 配置Kimi API Key自行注册获取 hermes config set KIMI_API_KEY sk-your-key-here3.2.2 配置Anthropic Claude推荐2# 设置模型提供商为Anthropic hermes config set model.provider anthropic # 配置Anthropic API Key需自行注册获取 hermes config set model.api_key sk-ant-xxxxx3.2.3 本地推理配置推荐3# 安装Ollama先安装Ollama客户端 ollama pull nous-hermes2 hermes model --local ollama:nous-hermes23.2.4 开启工具权限接下来会询问你想启用哪些工具。新手建议先启用基础工具web # 网络搜索和网页提取 terminal # 执行命令 file # 读写文件 browser # 浏览器自动化可选四、启动验证4.1 启动Hermes Agent*# 前台启动适合测试关闭终端则停止** *hermes start *# 后台启动推荐长期运行** *nohup hermes start *# 查看后台运行状态*4.2 成功启动What can I do for you today? 你好介绍一下你自己五、常见问题与解决方法5.1安装失败切换国内镜像源或检查网络连接权限不足Linux/macOS不要加sudoWindows用管理员PowerShell依赖缺失手动安装git、curl等基础工具Linuxsudo apt install git curl5.2 命令未找到执行source ~/.bashrc或source ~/.zshrc刷新环境变量Windows重启PowerShell或手动添加%LOCALAPPDATA%\hermes\bin到系统PATH5.3 模型连接失败核对API密钥是否正确是否有足够额度本地Ollama确保服务已启动ollama serve模型已正确拉取5.4 网络超时根因国内网络访问GitHub受限未配置镜像加速。解决方案重新配置1.4节的网络加速或更换国内镜像源重新执行安装命令。5.5 更新Hermes Agenthermes update # 一键更新 # 或手动更新 cd ~/.hermes/hermes-agent git pull git submodule update --init --recursive uv pip install -e .六、快速上手指南启动聊天hermes 查看帮助在聊天界面输入/help 运行技能输入/skill list查看所有技能/skill run skill-name运行技能 保存会话输入/save session-name保存当前会话 退出输入/exit或按CtrlC七、结语最后想特别说明Hermes Agent 最大的亮点就是它会 越用越懂你。坚持使用一段时间后它会慢慢熟悉你的操作习惯和常用技能给你带来越来越顺手的体验。不过有个关键步骤别忘装完一定要先跑hermes setup填好密钥把基础配置搞定不然可没法用哦特别给国内小伙伴划重点Kimi 大模型绝对是最佳拍档中文理解能力强长文档、论文、整个代码库拖进去都能轻松拿捏。写代码、调工具、处理各种复杂任务样样在行和 Hermes 强强联手直接让你的工作效率原地起飞