目录
一、项目简介
二、环境要求
三、安装方式详解(此方法仅是wsl)
3.1安装WSL以及Ubuntu
3.2更改加速源以及更新软件包索引
3.3安装所需基础环境
四、Hermes的安装和配置
五、常用命令查询
一、项目简介
Hermes-Agent是美国开源 AI 研究实验室 Nous Research 开发的开源自主 AI 代理(MIT 许可证),其核心设计理念是"一个与你共同成长的 Agent"。该项目的核心创新在于内置的自我学习循环——能够从经验中创建技能、在使用中改进技能、主动持久化知识,并在跨会话中构建对用户的深度理解。
核心特性一览
| 原生函数调用 | 模型能准确判断何时调用外部工具,按特定格式生成函数名和参数,支持在对话中多次编排调用,也可以同时发起多个并行请求,提升执行效率。 |
| 自我进化能力 | 完成复杂任务后自动创建技能,持续学习改进 |
| 终端访问 | 支持本地、Docker、SSH 三种终端后端,安全执行命令 |
| 开源生态与可定制性 | 基于开发权重(如Apache2.0)发布,支持GGUF、GPTQ等量化格式,可私有化部署甚至消费级硬件运行。与Ollama、LangChain、vLLM等框架深度集成,便于微调和二次开发。 |
| 角色扮演与任务规划融合 | 兼具拟人化、友好对话风格和理性任务规划能力,Agent能在保持自然交互的同时,高效利用工具完成复杂任务,实现“对话式工具执行” |
二、环境要求
| 要求 | 详情 |
|---|---|
| python版本 | Python3.9+ |
| 操作系统 | macOS/Linux/Windows(WSL或原生预览版) |
| 内存要求 | 8GB+ |
| 磁盘空间 | 2GB+ |
| 必须工具 | curl、wsl、bash、git |
三、安装方式详解(此方法仅是wsl)
3.1安装WSL以及Ubuntu
- 以管理员身份打开 PowerShell 或命令提示符
执行以下命令,自动启用所需功能并安装Ubuntu(默认发行版)
wsl --install等待完成后,命令行会自动出现设置用户名和密码
设置完成后打开一个新终端切换到目标项目目录
3.2更改加速源以及更新软件包索引
换成加速的源头
1.sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list 2.sudo sed -i 's|http://security.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list这一步会要求输入密码,输入密码时同样不显示,输入完直接回车就好。
更新软件包索引
sudo apt update3.3安装所需基础环境
git:代码管理工具(下载、上传代码必备)
curl:网络请求工具(下载文件、访问接口必备)
nodejs:JavaScript运行环境(前端/Node项目必备)
npm:Node的包管理器(装JS库必备)
sudo apt install -y git curl nodejs npm给npm更换加速源
npm config set registry https://registry.npmmirror.com四、Hermes的安装和配置
4.1Hermes Agent安装(一键安装)
https://hermes-agent.nousresearch.com/
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装脚本自动完成的工作
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 检测/安装uv | uv 是 Astral 开发的超快 Python 包管理器 |
| 2 | 检测/安装Python | 确保使用兼容的 Python 版本 |
| 3 | 检测/安装Node.js | 部分技能依赖 Node.js |
| 4 | 检测/安装ripgrep | 用于高效文本搜索 |
| 5 | 检测/安装ffmpeg | 音视频处理支持 |
| 6 | 创建虚拟环境 | 在~/.hermes-venv创建隔离环境 |
| 7 | 克隆仓库 | 拉取最新代码到本地 |
| 8 | 安装依赖 | 使用 uv.lock 进行哈希验证安装 |
| 9 | 安装子模块 | 包括 mini-swe-agent、tinker-atropos 等 |
| 10 | 配置PATH | 将 hermes 命令添加到 PATH |
安装后激活
# 重新加载 shell 配置 source ~/.bashrc # Bash 用户 source ~/.zshrc # Zsh 用户 # 运行设置向导(配置 API Key) hermes setup # 启动对话 hermes4.2Hermes Agent安装(手动安装)
1.打开浏览器访问源码
https://github.com/NousResearch/hermes-agent
2.直接点击下载源码压缩包到独立文件夹、改名为hermes agent
3.打开终端进入此文件夹路径下运行
#执行wsl命令 wsl #切换到目标路径 cd /mnt/d/Hermes/hermes-agent # 给脚本执行权限 chmod +x setup-hermes.sh # 运行安装脚本 ./setup-hermes.sh4.注册Nous Portal账号
5.选择Quick Setup(推荐新手直接选择)
选择相应的模型
直接选择第一个
新手直接选择Skip跳过配置消息平台
配置后执行hermes打开测试一下是否能聊天
五、常用命令查询
基础命令
| 命令 | 操作 |
|---|---|
| hermes setup | 交互式安装配置向导 |
| hermes model | 切换模型/提供商 |
| hermes config | 查看当前配置 |
| hermes config edit | 编辑配置文件 |
| hermes config set <key> <value> | 设置配置项 |
| hermes tools | 配置工具集 |
| hermes | 启动交互会话(默认模式) |
技能管理命令
| 命令 | 操作 |
|---|---|
| hermes skills browse | 浏览技能商城 |
| hermes skills install ID | 安装一个技能 |
| hermes skills list | 列出所有已经安装技能 |
| hermes skills update | 更新已过期的技能 |
| /skills 技能名 | 在会话中加载某个技能 |
| /reload-skills | 重新扫描技能目录 |
网关管理命令
| 命令 | 操作 |
|---|---|
| hermes gateway setup | 配置消息平台 |
| hermes gateway status | 查看状态 |
| hermes gateway start | 启动网关 |
| hermes gateway stop | 停止网关 |
诊断命令
| 命令 | 操作 |
|---|---|
| hermes doctor | 运行诊断检查 |
| hermes --version | 查看版本 |
| hermes --help | 查看帮助 |
官方资源:
———————————————————————————————————————————
- 官方文档:https://hermes-agent.nousresearch.com
- GitHub 仓库:https://github.com/NousResearch/hermes-agent
- 快速入门:https://hermes-agent.nousresearch.com/docs/getting-started/quickstart/
———————————————————————————————————————————