Karp 的技术博客

banner.png

什么是 Hermes Agent?

Hermes Agent 是由 Nous Research 开发的开源 AI 智能体框架(MIT 许可证)。它不是简单的聊天机器人或 IDE 插件,而是一个真正自主的 Agent——可以在终端、桌面应用、Telegram/微信等 20+ 消息平台运行,具备持久记忆、技能自学习和任务委派能力。

它的核心特性:

  • 🧠 自进化——会从使用中学习,自动创建和改进技能
  • 💬 20+ 消息平台——Telegram、Discord、微信、钉钉、飞书等
  • 🔧 60+ 内置工具——文件操作、网页浏览、代码执行、浏览器自动化
  • 💾 跨会话记忆——记住你的偏好和历史
  • 🤖 多模型支持——DeepSeek、Claude、OpenAI、本地模型自由切换
  • 📦 子 Agent 委派——并行处理复杂任务

安装前提

唯一的硬性要求是 git,其余依赖(Python 3.11、Node.js、ripgrep、ffmpeg)安装器会自动处理。

操作系统额外前提检查命令
macOS无需额外git --version
Linuxcurl + xz-utilssudo apt install curl xz-utils build-essential
WindowsGit for Windowsgit --version
AndroidTermuxpkg install git
💡 桌面版额外需要g++(macOS 自带 Xcode Command Line Tools;Linux: sudo apt install build-essential

方式一:桌面版安装(推荐新手)

桌面版包含图形界面 + 命令行一体,安装后两者都能用。

macOS / Windows

  1. 访问 Hermes Agent 官网,点击 Download 按钮下载对应平台的安装包
  2. macOS:打开 .dmg 拖入 Applications;Windows:运行 .exe 安装器

Hermes Agent 官网首页 — 下载入口和安装命令

Hermes Agent 官网首页,提供一键安装脚本、macOS/Windows 下载按钮

  1. 首次启动会自动打开终端设置向导,或运行:
hermes setup --portal    # 用 Nous Portal 一键配置(推荐)
hermes                   # 开始聊天!

安装器自动完成的内容

不论哪个平台,桌面安装器都会自动帮你设置好:

  • ✅ uv(快速 Python 包管理器)
  • ✅ Python 3.11(安装到用户目录,不需要 sudo)
  • ✅ Node.js v22(浏览器自动化和 WhatsApp 网桥用)
  • ✅ ripgrep(快速文件搜索)
  • ✅ ffmpeg(音频格式转换,TTS 用)
  • hermes 命令加入 PATH

方式二:命令行安装(纯 CLI)

如果你只需要终端中使用,或者要在服务器/VPS 上部署,用安装脚本更轻量。

Linux / macOS / WSL2 / Android (Termux)

一行命令搞定:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装器会自动检测缺失的依赖并下载,无需手动安装 Python、Node.js 等。

Windows (PowerShell)

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

官方安装文档

Hermes 官方安装文档 — 可见安装命令和步骤说明

官方文档安装页面,包含 curl 命令、PowerShell 命令、安装器说明

完成后重载 shell:

source ~/.bashrc    # 或 source ~/.zshrc

文件结构

安装后,文件和配置的位置如下:

类型普通用户安装root 安装
代码目录~/.hermes/hermes-agent//usr/local/lib/hermes-agent/
可执行文件~/.local/bin/hermes (符号链接)/usr/local/bin/hermes
数据目录~/.hermes//root/.hermes/$HERMES_HOME

配置模型提供方

安装后,最关键的一步是选择 LLM 模型。

最快路径:Nous Portal(推荐)

hermes setup --portal

一次订阅覆盖 300+ 个模型 + Tool Gateway(网页搜索、图片生成、TTS、云浏览器),无需分别配置 API Key。

手动配置独立 Provider

hermes model

这个交互式命令会带你选择 Provider:

Provider认证方式
Anthropic (Claude)API Key 或 OAuth
OpenAIOPENAI_API_KEY
DeepSeekDEEPSEEK_API_KEY
OpenRouterOpenRouter API Key(聚合多模型)
Google GeminiGOOGLE_API_KEY
xAI (Grok)XAI_API_KEY
本地模型自定义 endpoint + ollama/LM Studio
💡 个人推荐:日常用 DeepSeek(便宜够用),写代码切 Claude,头脑风暴切 GPT-4o。Hermes 的 /model 命令可以随时切换,还可以通过自定义 Skill 实现自动根据任务类型切换模型

验证安装

运行以下命令确认一切正常:

# 1. 查看版本
hermes --version

# 2. 运行健康检查
hermes doctor

# 3. 开始聊天
hermes

看到 Hermes 的响应,安装就成功了!


进阶:几个值得立刻尝试的功能

GitHub 仓库

Hermes Agent GitHub 仓库 — 218k Stars 的开源项目

Hermes Agent GitHub 仓库,218k Stars,MIT 协议开源

消息平台接入

把 Hermes 接上你日常用的聊天软件:

hermes gateway setup     # 交互式配置平台
hermes gateway run       # 启动网关

支持 Telegram、Discord、Slack、WhatsApp、Signal、微信、钉钉、飞书、企业微信等 20+ 平台。

加载 Skills(技能)

Skills 是 Hermes 自学的"秘籍",加载后 Agent 行为会优化:

hermes -s model-router   # 自动根据任务类型切换模型

定时任务

hermes cron create "每天早9点" --prompt "给我一份今日AI行业简报"

子 Agent 并行工作

在聊天中直接委派多个任务:

"帮我同时调研 WebAssembly、RISC-V 和量子计算的最新进展"

Hermes 会自动创建 3 个子 Agent 并行工作,汇总结果。


常见问题

Q: 安装后 hermes 命令找不到?

# 重新加载 shell
source ~/.bashrc
# 或手动添加 PATH
export PATH="$HOME/.local/bin:$PATH"

Q: 桌面版和命令行版有什么区别?

桌面版 = 图形界面 + 命令行。纯 CLI 安装只有命令行。无论是哪种方式安装,hermes 命令功能完全一致。

Q: 能同时配置多个模型吗?

可以!一个配置文件里同时配好多个 Provider,在聊天的任何时候用 /model 切换:

/model deepseek/deepseek-chat        # 切到 DeepSeek
/model anthropic/claude-sonnet-4     # 切到 Claude
/model openai/gpt-4o                 # 切到 OpenAI

Q: 如何更新?

hermes update

Q: 能装在 Android 手机上吗?

可以!通过 Termux 安装 CLI 版本:

pkg update && pkg install git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

或者把 Hermes 运行在服务器上,手机通过 Telegram/微信与其对话。


总结

安装方式适合场景包含桌面端?
桌面安装器macOS / Windows 新手
CLI 脚本Linux 服务器、开发者、VPS
TermuxAndroid 手机
Nix FlakeNixOS 用户可选

不管选哪种方式,从安装到第一次对话,全程不超过 2 分钟


资源链接

版权属于:karp
作品采用:本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。
更新于: 2026年07月20日 14:18
1

目录

来自 《Hermes Agent 安装指南:命令行 + 桌面版完整教程》