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