当前位置：首页 > news >正文

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

news 2026/5/29 20:21:27

推荐用官方一键安装脚本（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 的智能体能力完美结合，让你的自动化工作事半功倍。

查看全文

http://www.rkmt.cn/news/1423126.html