curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 重新加載 shell 配置
source ~/.bashrc   # Bash 用戶
source ~/.zshrc    # Zsh 用戶
# 運(yùn)行設(shè)置向?qū)Вㄅ渲?API Key）
hermes setup
# 啟動(dòng)對話
hermes

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或通過 pip
pip install uv

# 克隆倉庫
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# 創(chuàng)建虛擬環(huán)境
uv venv
source .venv/bin/activate

# 終端執(zhí)行工具后端（必需）
uv pip install -e "./mini-swe-agent"
# 強(qiáng)化學(xué)習(xí)訓(xùn)練后端（可選）
uv pip install -e "./tinker-atropos"

# 某些技能需要 Node.js 支持
npm install

# 拉取官方鏡像
docker pull nousresearch/hermes-agent:latest
# 創(chuàng)建數(shù)據(jù)目錄
mkdir -p ~/.hermes
# 首次配置（交互式）
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  -e OPENAI_API_KEY="your-key" \
  nousresearch/hermes-agent:latest \
  hermes setup
# 啟動(dòng) Gateway 服務(wù)（后臺(tái)運(yùn)行）
docker run -d \
  --name hermes \
  -v ~/.hermes:/opt/data \
  -p 8000:8000 \
  -e OPENAI_API_KEY="your-key" \
  nousresearch/hermes-agent:latest \
  hermes gateway run

# 安裝 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 啟動(dòng) Ollama 服務(wù)
ollama serve
# 下載模型
ollama pull llama3.1
# 配置 Hermes 使用 Ollama
hermes setup
# 選擇 Ollama 作為提供商

~/.hermes/
├── config.yaml           # 主配置文件
├── .env                  # API 密鑰和敏感信息
├── auth.json             # OAuth 憑證（Nous Portal 等）
├── SOUL.md               # 可選：全局人格設(shè)定
├── active_profile        # 當(dāng)前激活的配置文件
├── memories/             # 持久化記憶
│   ├── MEMORY.md         # Agent 的記憶存儲(chǔ)
│   └── USER.md           # 用戶偏好記錄
├── skills/               # Agent 創(chuàng)建的技能
├── cron/                 # 定時(shí)任務(wù)
├── sessions/             # Gateway 會(huì)話
├── state.db              # 狀態(tài)數(shù)據(jù)庫
└── logs/                 # 日志文件
    ├── errors.log        # 錯(cuò)誤日志
    └── gateway.log       # Gateway 日志（密鑰自動(dòng)脫敏）

# 編輯環(huán)境變量文件
nano ~/.hermes/.env

# ==================== 主流 LLM 提供商 ====================
# OpenAI
OPENAI_API_KEY=sk-your-openai-key
# Anthropic (Claude)
ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
# OpenRouter（聚合多模型，推薦）
OPENROUTER_API_KEY=sk-or-your-openrouter-key
# ==================== 其他提供商 ====================
# Kimi / Moonshot AI
KIMI_API_KEY=your-kimi-key
# 本地 Ollama（無需 API Key）
# 確保 Ollama 服務(wù)運(yùn)行在 localhost:11434
# ==================== 自定義端點(diǎn) ====================
# 自定義 OpenAI 兼容端點(diǎn)
OPENAI_BASE_URL=http://localhost:8402/v1
OPENAI_API_KEY=dummy
LLM_MODEL=blockrun/auto

# 設(shè)置 API Key
hermes config set OPENROUTER_API_KEY your_key_here
# 選擇模型
hermes model
# 啟用特定工具
hermes tools

# ~/.hermes/config.yaml
# ==================== 模型配置 ====================
# 默認(rèn)模型（兩種寫法均可）
model: "gpt-4o"
# default: "gpt-4o"
# 上下文壓縮配置
compression:
  enabled: true
  trigger_threshold: 0.50  # 達(dá)到上下文限制 50% 時(shí)觸發(fā)壓縮
# 輔助模型配置
auxiliary:
  vision_model: "gpt-4o-mini"
  quick_model: "gpt-3.5-turbo"
# ==================== 終端配置 ====================
terminal:
  backend: "local"  # local / docker / ssh
# 工作目錄
cwd: "."
# ==================== 記憶配置 ====================
memory:
  enabled: true
  persist: true
  retention_days: 30
# ==================== 顯示配置 ====================
display:
  skin: "default"  # default | ares | mono | slate | poseidon
  compact: false
  streaming: true
# ==================== TTS 配置 ====================
tts:
  enabled: false
  provider: "openai"
  voice: "alloy"

# ~/.hermes/SOUL.md
## 身份
你是一位經(jīng)驗(yàn)豐富的軟件工程師和 AI 助手，名為 Hermes。
## 性格特點(diǎn)
- 專業(yè)但不失親和
- 注重代碼質(zhì)量和最佳實(shí)踐
- 善于用類比解釋復(fù)雜概念
- 主動(dòng)提出改進(jìn)建議
## 溝通風(fēng)格
- 回答簡潔明了，避免冗余
- 代碼示例配有詳細(xì)注釋
- 重要信息使用列表或表格呈現(xiàn)
- 技術(shù)術(shù)語配合通俗解釋
## 工作原則
1. 安全第一：不執(zhí)行危險(xiǎn)操作
2. 驗(yàn)證優(yōu)先：關(guān)鍵操作需確認(rèn)
3. 效率導(dǎo)向：優(yōu)先選擇高效方案
4. 學(xué)習(xí)導(dǎo)向：鼓勵(lì)用戶理解原理
## 特殊指令
- 使用中文回復(fù)
- 代碼塊指定語言類型
- 復(fù)雜任務(wù)分解為步驟

# 配置使用 Docker 后端
hermes config set terminal.backend docker

# ~/.hermes/config.yaml
terminal:
  backend: "docker"
  docker:
    image: "python:3.11-slim"
    timeout: 300

terminal:
  backend: "ssh"
  ssh:
    host: "your-server.com"
    user: "hermes"
    port: 22
    key_path: "~/.ssh/hermes_key"
    timeout: 300

# 創(chuàng)建新配置文件
hermes profile create work --clone
# 切換配置文件
hermes profile use work
# 列出所有配置文件
hermes profile list
# 查看當(dāng)前配置文件
hermes profile show
# 刪除配置文件
hermes profile delete work

# 查看版本
hermes --version
# 查看當(dāng)前配置
hermes config
# 運(yùn)行診斷
hermes doctor

? Python 版本: 3.11.5
? config.yaml 存在
? .env 文件存在
? API Key 已配置
? 終端后端可用
? Gateway 服務(wù)運(yùn)行中

# 啟動(dòng)交互式對話
hermes
# 基礎(chǔ)交互
>>> 你好，請介紹一下你自己
>>> 幫我查看當(dāng)前目錄的文件列表
>>> 寫一個(gè) Python 腳本計(jì)算斐波那契數(shù)列
# 恢復(fù)最近會(huì)話
hermes chat --continue
# 使用指定模型
hermes chat --model gpt-4o

# 交互式切換模型
hermes model
# 直接指定模型啟動(dòng)
hermes chat --model gpt-4o
hermes chat --model claude-3-opus
hermes chat --model ollama/llama3.1

# 查看錯(cuò)誤日志
tail -f ~/.hermes/logs/errors.log
# 查看 Gateway 日志
tail -f ~/.hermes/logs/gateway.log