建立 2026-09-19 更新 2026-09-19

安裝

Hermes Agent 有兩種裝法：下載桌面 App，或在終端機跑一行安裝腳本。兩者用的是同一個核心與同一份 ~/.hermes/ 設定，所以先裝哪個都可以，之後隨時切換。

選擇安裝方式

你的環境	建議做法
macOS（Apple Silicon）、Windows、Linux，想要圖形介面	從官網下載 Hermes Desktop
Linux、macOS、WSL2、Android（Termux）	安裝腳本（下方）
Windows 原生	PowerShell 安裝腳本（下方）
用 Nix 管理系統	官方 Nix Setup（官方標註為 best-effort）

Intel Mac

官方說明 macOS 安裝器只支援 Apple Silicon，x86（Intel）Mac 不在支援範圍。

用腳本安裝

Linux、macOS、WSL2、Termux：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows（PowerShell）：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

唯一的前置需求是系統已有 git；Linux／WSL2 另外需要 curl 與 xz-utils。不需要自己裝 Python、Node.js、ripgrep 或 ffmpeg，安裝器會一併備妥（uv、Python 3.11、Node.js、ripgrep、ffmpeg），並完成下列事項：

下載程式碼、建立虛擬環境
把全域指令 hermes 放進 PATH
引導你設定 LLM 供應商

程式碼與執行檔的位置取決於身分：一般使用者在 ~/.hermes/hermes-agent/ 與 ~/.local/bin/hermes；以 root 安裝則在 /usr/local/lib/hermes-agent/ 與 /usr/local/bin/hermes。

先看過腳本再執行

curl | bash 會直接執行網路上的腳本。想先檢視內容，可以先把 install.sh 下載到本機讀過再跑。

驗證安裝

重新載入 shell 後直接執行 hermes：

source ~/.zshrc    # bash 使用者改成 ~/.bashrc
hermes

看到對話畫面就算成功。接著設定模型與工具：

hermes model              # 選 LLM 供應商與模型
hermes tools              # 開關工具
hermes setup --portal     # 一步設定 Nous Portal

更新與疑難排解

更新用 hermes update。更新後若提示缺少設定，執行 hermes config check，再用 hermes config migrate 補上新選項。

症狀	處理
`hermes: command not found`	重新開一個終端機，或確認 `~/.local/bin` 在 PATH 裡
提示 API key 未設定	執行 `hermes model`，或用 `hermes config set` 寫入金鑰
不確定哪裡壞了	執行 `hermes doctor`，它會指出缺什麼與如何修

安裝

選擇安裝方式

用腳本安裝

驗證安裝

更新與疑難排解

推薦影音

全平台安裝與 Telegram 串接