Hermes Agent 安装指南

📑 目录

什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的开源 AI 助手框架。它可以：

  • 🤖 作为你的个人 AI 助手运行在本地服务器上
  • 💬 集成多种通讯平台（Telegram、Discord、微信等）
  • 🔧 执行代码、管理文件、浏览网页
  • 📅 支持定时任务和自动化工作流

环境要求

组件最低版本推荐版本
Python3.10+3.11+
Node.js18+20+
内存2GB4GB+
磁盘5GB10GB+

安装步骤

1. 克隆仓库

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

2. 创建虚拟环境

python3 -m venv venv
source venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 配置环境变量

创建 .env 文件：

# 模型配置
MODEL_PROVIDER=anthropic
MODEL_NAME=claude-sonnet-4
ANTHROPIC_API_KEY=your_api_key_here

# 可选：通讯平台
TELEGRAM_BOT_TOKEN=your_bot_token
DISCORD_BOT_TOKEN=your_discord_token

5. 启动 Agent

# 交互模式
python run_agent.py

# 或者作为服务运行
python run_agent.py --gateway telegram

常见问题

Q: 安装时遇到依赖冲突怎么办？

尝试更新 pip 并重新安装：

pip install --upgrade pip
pip install -r requirements.txt --force-reinstall

Q: 如何配置国内镜像源？

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Q: Agent 启动后无法连接模型？

检查以下几点：

  1. API Key 是否正确
  2. 网络连接是否正常
  3. 模型服务商是否可用

下一步

安装完成后，你可以：

  • 📝 配置你的第一个 AI 助手
  • 🔌 连接通讯平台
  • ⚙️ 自定义工具和功能

更多文档请参考 Hermes Agent 官方文档

测试图片

下面是一张测试图片，点击可以放大查看：

Hermes Agent 架构图

图片说明：这是一张随机生成的测试图片，用于测试灯箱功能

最后更新：2026 年 4 月 13 日