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

安装

前置条件

• Python 3.12+
• macOS / Linux
• Git

pip 安装

1pip install hermes-agent

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

1hermes init

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

验证安装

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

配置基础

配置文件

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

1model:
2  default: deepseek-v4-flash        # 默认模型
3  provider: deepseek                # 默认提供商
4  base_url: https://api.deepseek.com
5
6agent:
7  max_turns: 90                     # 单次对话最大轮次
8  gateway_timeout: 1800             # 网关超时（秒）
9  api_max_retries: 3                # API 重试次数

多 Profile 支持

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

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

CLI 基础使用

启动会话

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

常用命令

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

TUI 模式

1hermes tui

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

模型提供商配置

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

1model:
2  default: deepseek-v4-flash
3  provider: deepseek

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

---

参考：Hermes Agent 官方文档