用户界面层

TUI · Desktop · Dashboard · CLI

⬇️

网关与平台适配器

Telegram · Discord · 微信 · API Server

⬇️

Agent 核心引擎

对话循环 · 工具执行 · System Prompt · 上下文管理

⬇️

工具系统

Terminal · File · Browser · MCP · 插件

⬇️

Provider 抽象层

OpenAI · Anthropic · Google · xAI · 本地模型

📋 快速开始

# 1. 安装 Hermes Agent（推荐 uv）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 2. 初始化配置
hermes setup

# 3. 配置模型提供商
hermes config set provider openai
hermes config set model gpt-4

# 4. 启动 CLI
hermes chat

📄 config.yaml 关键配置

# ~/.hermes/config.yaml

provider:
  default: openai
  model: gpt-4
  # 多提供商配置
  providers:
    - name: openai
      models: [gpt-4, gpt-3.5-turbo]
    - name: anthropic
      models: [claude-3-opus]

agent:
  max_turns: 50          # 最大对话轮数
  budget:
    max_tokens: 100000   # 每轮最大 token 数
    max_cost: 10.0       # 每轮最大成本（美元）
  
tools:
  enabled: [terminal, file, web_search]
  disabled: [send_message]
  # 工具超时设置
  timeout: 300  # 5 分钟超时

memory:
  enabled: true
  max_entries: 100       # 最大记忆条目数

⚡ 性能优化建议

# 1. 启用 Prompt Caching（Anthropic 模型）
hermes config set provider anthropic
hermes config set model claude-3-opus

# 2. 调整上下文窗口大小
hermes config set agent.context_window 128000

# 3. 启用并行工具执行
hermes config set tools.parallel true

# 4. 配置缓存策略
hermes config set cache.enabled true
hermes config set cache.max_size 1000  # MB

🔧 故障排除

# 1. 检查配置
hermes config show

# 2. 清理缓存
hermes clean --cache
hermes clean --sessions

# 3. 查看日志
hermes logs --verbose

# 4. 诊断连接问题
hermes diagnose --provider openai

# 5. 测试工具可用性
hermes tools --test

🚀 Docker 部署

# 1. 构建镜像
docker build -t hermes-agent .

# 2. 运行容器
docker run -d \
  --name hermes \
  -v ~/.hermes:/root/.hermes \
  -e OPENAI_API_KEY=your-key \
  -p 8080:8080 \
  hermes-agent

# 3. 配置持久化存储
docker volume create hermes-data
docker run -d \
  --name hermes \
  -v hermes-data:/root/.hermes \
  hermes-agent