5分钟内完成hermes agent本地部署:先装git,再执行curl安装脚本,重载shell配置,运行hermes setup配置kimi等模型,最后用hermes run生成markdown周报。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在本地跑起一个能自动学习、调用工具、记住上下文的AI智能体,但卡在第一步——连安装都失败,终端报错“command not found”或“git: not found”,根本没机会输入hermes setup。这节课不讲原理,只带你从空白系统出发,5分钟内完成下载、安装、配置、执行首个任务的完整闭环。
确认并安装唯一前置依赖:Git
所有安装方式都依赖 Git 拉取代码,缺它整个流程立刻中断。别跳过这步,哪怕你认为“系统肯定有”。
打开终端,执行:git --version
如果返回类似 git version 2.43.0,说明已就绪,直接进入下一步;若提示 command not found 或 bash: git: command not found,必须先装 Git。
Ubuntu/Debian 执行:sudo apt update && sudo apt install git -y
macOS 执行:xcode-select --install(弹窗点“安装”即可)
Windows 用户注意:【必须用 WSL2 环境】,原生 PowerShell 或 CMD 无法运行 Hermes Agent,装完 Git 后仍需启用 WSL2 并在 Ubuntu 终端中操作。
一键安装 Hermes Agent(推荐新手)
这是最稳最快的路径,脚本会自动处理 Python 3.11、Node.js v22、uv、ffmpeg 等全部依赖,无需手动 pip 或 conda。
Linux/macOS/WSL2 终端中粘贴执行:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
安装过程约 90 秒,终端会滚动输出依赖安装日志。完成后,根据你的 shell 类型重载环境变量:
Bash 用户执行:source ~/.bashrc
Zsh 用户(macOS 默认)执行:source ~/.zshrc
验证是否成功:hermes --version → 应输出类似 hermes v0.13.0 (v2026.5.7)
再运行一次诊断:hermes doctor → 若显示 All checks passed,说明运行时环境已就绪。
启动交互式配置向导
这一步决定你的 Agent 能不能真正“开口说话”。跳过它,后续所有 run 命令都会因缺少模型连接而报错。
在终端中输入:hermes setup
使用方向键选择 Quick setup — provider, model & messaging (recommended),按回车。
在提供商列表里,国内用户直接选 Kimi(无需代理,中文强,支持200万字上下文);国外用户选 OpenRouter 或 Nous Portal。
粘贴你从 Kimi 开放平台获取的 API Key(格式为 sk-xxx),Base URL 留空即用默认值;接着选择模型,Kimi 推荐 kimi-plus,OpenRouter 可选 anthropic/claude-3.5-sonnet。
当提示 “Connect to a messaging platform?” 时,选 Skip for now —— 首次任务不需要微信或飞书接入,纯 CLI 模式足够验证核心能力。
执行首个任务:让 Agent 写一段 Markdown 格式的周报
现在 Agent 已绑好模型、记好密钥,可以真正干活了。我们不写复杂逻辑,就让它生成一份带标题、日期、三项工作要点的周报,验证基础推理与格式输出能力。
在终端中输入:
hermes run "生成一份本周工作总结,用 Markdown 格式:标题为「第24周工作简报」,包含「已完成」「进行中」「待启动」三个二级标题,每个标题下写一条不超过15字的要点"
等待 3~8 秒,终端将直接输出结构清晰的 Markdown 文本,例如:
## 第24周工作简报
### 已完成
- 完成用户登录模块重构
### 进行中
- 接入支付网关联调
### 待启动
- 设计新版本API文档











