Hermes Agent 安装与配置指南

Hermes Agent 是一个基于大语言模型的 AI 智能体框架，支持 CLI、TUI、微信、Telegram 等多种交互方式。本文记录完整的安装配置流程。

安装

前置条件

Python 3.12+
macOS / Linux
Git

pip 安装

1	pip install hermes-agent

安装后初始化项目并创建配置文件：

1	hermes init

这会生成 ~/.hermes/config.yaml 主配置文件。

验证安装

1 2	hermes --version # Hermes Agent v0.15.1 (2026.5.29)

配置基础

配置文件

主配置位于 ~/.hermes/config.yaml，核心配置项：

model:
  default: deepseek-v4-flash        # 默认模型
  provider: deepseek                # 默认提供商
  base_url: https://api.deepseek.com

agent:
  max_turns: 90                     # 单次对话最大轮次
  gateway_timeout: 1800             # 网关超时（秒）
  api_max_retries: 3                # API 重试次数

多 Profile 支持

支持多 Profile 隔离不同场景的配置、技能和记忆：

1 2	hermes profile list # default deepseek-v4-flash

CLI 基础使用

启动会话

1
2
3

hermes                           # 默认模式
hermes -m "anthropic/claude-sonnet-4"  # 指定模型
hermes --profile work            # 指定 profile

常用命令

命令	说明
`/new`	开启新对话
`/skill <name>`	加载指定技能
`/tools`	查看可用工具
`/model`	切换模型
`/save`	保存当前会话
`/export <format>`	导出会话

TUI 模式

1	hermes tui

TUI 模式下支持更丰富的界面交互，包括斜杠命令快捷键、会话列表、技能面板等。

模型提供商配置

支持多模型提供商，修改 config.yaml：

1
2
3

model:
  default: deepseek-v4-flash
  provider: deepseek

支持的提供商：OpenAI、Anthropic、DeepSeek、OpenRouter、Groq、自定义等。

参考：Hermes Agent 官方文档