Hermes 的簡單用法(安裝、配置)
發(fā)布時間：2026-07-14 10:21:13 作者：青春的苦澀 
我要評論
我要評論Hermes AI全流程,從零到高效使用只需5分鐘,本文詳細講解安裝、4種UI界面選擇及模型完整配置,解鎖本地Ollama離線推理或云端OpenRouter聚合模型,感興趣的可以了解一下
Hermes 完整全流程手冊
一、前置依賴
- Node.js 18+（配套npm，用于全局安裝Hermes CLI）
- ≥ Python3.10（你本地Python3.13 + Miniconda）
- Ollama（可選，本地離線模型使用）
二、Hermes CLI 本體安裝 & 校驗
1. 全局安裝
# 卸載舊版本 pip uninstall -y hermes-agent # 全局全新安裝最新版 pip install hermes-agent
2. 驗證安裝成功
hermes --version
提示命令不存在：將npm全局路徑加入系統(tǒng)Path，重啟終端
三、4種Hermes UI界面：安裝、啟動、使用
方式1：終端TUI（無需額外安裝，開箱即用）
- 基礎啟動
hermes --tui # 接續(xù)上次會話 hermes --tui --continue # 開發(fā)調(diào)試模式 hermes --tui --dev
- 默認永久開啟TUI
# PowerShell臨時生效 $env:HERMES_TUI=1 hermes # 永久：系統(tǒng)用戶變量新增 HERMES_TUI=1
- 適用：服務器無圖形界面、代碼快速調(diào)試
方式2：內(nèi)置Web Dashboard（自帶，零額外安裝）
# 默認端口9119，自動彈出瀏覽器 http://127.0.0.1:9119 hermes dashboard # 自定義端口 hermes dashboard --port 9120 # 不自動開瀏覽器 hermes dashboard --no-open # 局域網(wǎng)其他設備訪問 hermes dashboard --host 0.0.0.0 --port 9119
適用：輕度網(wǎng)頁可視化、查看會話/日志/模型配置
方式3：增強第三方WebUI（hermes-web-ui，功能完整版）
- 安裝
npm install -g hermes-web-ui
- 啟動
hermes-web-ui start # 訪問 http://localhost:8648
- 源碼/Docker備用部署
# 源碼 git clone https://github.com/nesquena/hermes-webui.git cd hermes-webui .\start.bat # Docker docker pull ghcr.io/nesquena/hermes-webui docker compose up -d
適用：多項目管理、數(shù)據(jù)統(tǒng)計、團隊局域網(wǎng)協(xié)作
方式4：Hermes Desktop 獨立桌面GUI（Electron客戶端）
- Ollama一鍵拉起
ollama launch hermes-desktop --model llama3:8b
- Windows exe安裝包：雙擊桌面圖標直接打開
適用：高頻日常使用，獨立窗口、文件拖拽、系統(tǒng)通知
UI選型速查表
| UI類型 | 額外安裝 | 最簡啟動命令 | 載體 | 適用場景 |
|---|---|---|---|---|
| 終端TUI | 無需 | hermes --tui | 終端 | 開發(fā)、服務器 |
| 內(nèi)置Dashboard | 無需 | hermes dashboard | 瀏覽器9119 | 臨時網(wǎng)頁查看 |
| 增強WebUI | npm全局 | hermes-web-ui start | 瀏覽器8648 | 多項目/團隊 |
| Desktop桌面 | exe安裝包 | 雙擊圖標 | 獨立軟件窗口 | 長期日常使用 |
四、Hermes 模型完整配置（核心新增章節(jié)）
4.1 配置文件基礎（Windows路徑）
所有配置統(tǒng)一存放在用戶目錄 .hermes 文件夾：
config.yaml：持久化配置（默認模型、提供商、參數(shù)，不存密鑰）.env：存放API Key、密鑰、服務地址（敏感信息）- 一鍵打開編輯：
hermes config edit # 查看當前全部配置 hermes config show # 配置健康自檢（排查密鑰/模型連通報錯） hermes doctor
4.2 四種模型配置操作方式（優(yōu)先級：單次CLI > 會話臨時 > 全局持久 > 配置文件）
方式1：交互式向?qū)Вㄐ率滞扑]，全自動）
hermes model
流程：選擇提供商 → 填入API密鑰 → 選擇默認模型，一鍵寫入配置+env文件
方式2：CLI命令快速設置（無需手動改文件）
# 設置全局默認模型+密鑰示例 # OpenRouter聚合平臺（200+模型，推薦） hermes config set OPENROUTER_API_KEY sk-or-v1-xxx hermes config set model 模型名稱 # 本地Ollama離線模型（無需密鑰） hermes config set model ollama/qwen2.5:7b hermes config set OPENAI_BASE_URL http://localhost:11434/v1 # DeepSeek國內(nèi)大模型 hermes config set DEEPSEEK_API_KEY sk-xxx hermes config set model deepseek/deepseek-chat
方式3：會話內(nèi)動態(tài)切換（TUI/Web界面通用）
進入hermes聊天會話后，斜杠命令切換模型
# 僅當前會話生效，退出重置 /model ollama/llama3.2 # --global 永久保存為全局默認 /model openrouter/gemini-2.5-pro --global
方式4：手動編輯 config.yaml 完整模板
# ~/.hermes/config.yaml
model:
provider: ollama # openrouter / openai / anthropic / deepseek
default: qwen2.5:7b
base_url: http://localhost:11434/v1 # ollama本地地址，云端可刪除
temperature: 0.7 # 創(chuàng)造力參數(shù)
max_tokens: 8000
# 多提供商統(tǒng)一配置
provider:
default: openrouter
models:
ollama: llama3.2
openrouter: anthropic/claude-3.5-sonnet
deepseek: deepseek-chat
# 輕量輔助模型（識圖、摘要、壓縮對話）
auxiliary:
vision:
provider: openrouter
model: gpt-4o-mini
密鑰單獨寫入 .env：
# ~/.hermes/.env OPENROUTER_API_KEY=sk-or-v1-xxxx DEEPSEEK_API_KEY=sk-xxxx ANTHROPIC_API_KEY=sk-ant-xxxx # Ollama無需密鑰
4.3 主流模型提供商一鍵配置模板
1）本地 Ollama（離線免費，隱私優(yōu)先）
- 先啟動ollama后臺：
ollama serve - Hermes配置
hermes config set model ollama/qwen2.5:7b hermes config set OPENAI_BASE_URL http://127.0.0.1:11434/v1
無需API Key，完全本地推理
2）OpenRouter（聚合全平臺模型，推薦）
- 官網(wǎng)獲取sk-or-v1密鑰
- 配置
hermes config set OPENROUTER_API_KEY sk-or-v1-xxx hermes config set model openrouter/anthropic/claude-3.5-sonnet
3）DeepSeek（國內(nèi)友好、性價比高）
hermes config set DEEPSEEK_API_KEY sk-xxx hermes config set model deepseek/deepseek-chat
4）OpenAI / Claude 直連
# OpenAI hermes config set OPENAI_API_KEY sk-xxx hermes config set model gpt-4o # Claude hermes config set ANTHROPIC_API_KEY sk-ant-xxx hermes config set model claude-3.5-sonnet
4.4 啟動UI時指定模型（單次生效，不修改全局配置）
# TUI啟動，臨時使用本地ollama hermes --tui --provider ollama --model llama3.2 # Web Dashboard啟動，臨時切換OpenRouter hermes dashboard --model openrouter/gemini-2.5-pro
4.5 模型配置常見故障排查
- 模型調(diào)用失?。簣?zhí)行
hermes doctor自動檢測密鑰、連通性、上下文長度 - 切換模型重啟失效：單次CLI參數(shù)優(yōu)先級高于配置文件，檢查啟動命令是否帶
--model - Ollama連接超時：確認
ollama serve后臺運行，base_url地址正確 - API 401報錯：
.env內(nèi)密鑰復制錯誤，重新執(zhí)行hermes config set覆蓋
五、完整最簡使用流程
- 安裝Hermes：
npm install -g @hermesai/cli - 配置模型（二選一）
- 本地離線：
hermes model→ 選擇ollama，拉取qwen2.5 - 云端聚合：
hermes config set OPENROUTER_API_KEY xxx
- 本地離線：
- 打開UI（按需選擇）
- 終端調(diào)試：
hermes --tui - 瀏覽器簡易面板：
hermes dashboard
- 終端調(diào)試：
- 會話內(nèi)切換模型：
/model 模型名 --global永久保存
到此這篇關于Hermes 的簡單用法(安裝、配置)的文章就介紹到這了,更多相關Hermes 用法內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！
相關文章
macOS系統(tǒng)下安裝與配置Hermes Agent的完整指南(收藏這一篇就夠了)
Hermes Agent 支持 macOS，但安裝過程有幾個點需要注意,本文是 macOS 專屬安裝指南，覆蓋從零配置到運行的全流程，以 MiniMax 為例演示 AI 提供商配置,有需要的小伙伴可以2026-05-11
