Hermes 智能体完整安装教程：环境配置 + 依赖解决 + 验证测试

推荐用官方一键安装脚本（Linux/macOS/WSL2）；Windows原生用PowerShell命令；也可通过pip或源码安装；安装后必须配置LLM密钥（支持Kimi、Nous Portal、OpenAI、Anthropic等）才能使用。

一、准备工作

系统要求：Linux/macOS/WSL2（推荐），Windows 10+（PowerShell 7+），Android（Termux）
依赖条件：安装脚本会自动处理Python 3.11、Node.js、uv、ripgrep、ffmpeg等，无需手动安装
必备密钥：至少拥有一个LLM服务API密钥（Kimi、Nous Portal、OpenRouter、OpenAI、Anthropic），或安装Ollama实现本地推理

账号准备（可选）

国内用户大模型推荐：

Kimi：国内优选，无需特殊网络，访问速度快，200万字超长上下文，支持文档解析，免费额度充足
智谱 AI / z.ai：性价比高，中文理解和生成能力优秀
通义千问：阿里云生态集成好；功能全面

海外用户大模型推荐：

Nous Portal：官方原生支持，集成度高，体验流畅
OpenRouter：模型全，支持一键切换上百种大模型，灵活度高
OpenAI：能力全面，生态完善，适合各类通用场景
Anthropic：长文处理王者，上下文窗口大，安全性高
Google Gemini：多模态技术领跑，全球可用
本地模型（Ollama）：完全隐私保护，无需联网即可使用

二、主流安装方式（推荐）

1. Linux/macOS/WSL2 一键安装（官方推荐）

复制代码

# 执行一键安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 重载环境变量（根据Shell类型选择）
source ~/.bashrc  # Bash用户
source ~/.zshrc   # Zsh用户（macOS默认）

# 验证安装
hermes --version

安装脚本会自动完成：克隆仓库、创建虚拟环境、安装依赖、添加命令到PATH、复制配置模板。

2. Windows原生安装（Early Beta）

打开PowerShell 7+（管理员模式）：

复制代码

# 执行安装命令
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

# 重启PowerShell后验证
hermes --version

注意：Windows版本仍在测试中，部分功能可能受限。

3. pip安装（适合快速部署）

复制代码

# 安装稳定版
pip install hermes-agent

# 执行可选的后安装配置（安装Node.js等依赖）
hermes postinstall

PyPI版本为正式发布版，更新频率低于git主分支。

三、高级安装方式

1. 源码手动安装（适合开发者）

复制代码

# 克隆仓库
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

2. Nix/NixOS安装（声明式配置）

复制代码

# Nix Flake方式
nix run github:NousResearch/hermes-agent

# NixOS模块配置
# 在configuration.nix中添加：
services.hermes-agent.enable = true;
services.hermes-agent.llmApiKey = "your-key-here";

3. Android（Termux）安装

复制代码

# 安装Termux后执行
pkg update && pkg upgrade -y
pkg install git python nodejs ripgrep ffmpeg build-essential
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
python -m venv venv
source venv/bin/activate
pip install -e ".[all]"

四、配置与启动

1. 交互式配置向导（推荐）

复制代码

hermes setup

按提示选择LLM服务、输入API密钥、配置记忆后端等。

2. 手动配置（高级用户）

复制代码

# 复制配置模板
cp .env.example .env

# 编辑配置文件（设置API密钥等）
vim .env

配置选项：选择模型

Kimi：输入API密钥，国内用户优选，网络稳定，处理能力强
Nous Portal：通过OAuth登录，适合新手
OpenRouter：输入API密钥，模型选择多
本地部署：选择Ollama，完全离线使用

3. 启动Hermes Agent

复制代码

# 启动聊天界面
hermes

# 选择模型（可选）
hermes model

五、常见问题与解决方法

权限问题：安装时避免使用sudo，脚本会在用户目录下安装所有组件
网络问题：无法访问GitHub时，可使用代理或镜像源
依赖缺失：执行hermes postinstall可自动补全依赖
中文支持：默认支持中文，可在聊天中直接使用中文交互
更新与卸载：

复制代码

# 更新
hermes update

# 卸载
rm -rf ~/.hermes ~/.local/bin/hermes

六、验证安装成功

成功启动后，会看到Hermes Agent的欢迎界面，输入问题即可开始交互。例如：

复制代码

What can I do for you today?
> 你好，介绍一下你自己

七、总结

Hermes Agent安装非常简单，一键安装脚本适合大多数用户；开发者可选择源码安装；Windows用户可使用PowerShell命令；安装后必须配置LLM密钥才能使用。安装完成后，建议先通过hermes setup完成基础配置，再开始体验这个强大的自进化AI智能体。如果你是国内用户，Kimi 大模型绝对是 Hermes Agent 的最佳拍档。不用折腾任何网络设置就能直接使用，它对中文的理解地道又精准，长文本处理能力更是业内顶尖，写代码、调用工具、处理复杂任务样样在行，还能和 Hermes Agent 的智能体能力完美结合，让你的自动化工作事半功倍。