在 Linux 上安裝 Hermes Agent

📅 2026年7月23日適用版本 >=2026.5 ✅ 最後驗證 2026年7月4日 ✍️ HermesAgent.download Contributors

Linux 上裝 Hermes Agent 只需要一行指令。但如果你少了前置套件,它會失敗得很莫名其妙——中途噴一段解壓縮錯誤然後停住,訊息不會告訴你缺的是 xz-utils。

所以先花三十秒把前置裝好。

前置套件(Debian / Ubuntu)

sudo apt update && sudo apt install -y curl xz-utils

curl 用來下載安裝腳本,xz-utils 用來解壓縮它下載的東西¹。

如果你要用桌面版,再加一個:

sudo apt install -y build-essential

確認 Git 存在

安裝腳本會自己裝其他相依套件,但 Git 需要你先有¹:

git --version

預期輸出:類似 git version 2.43.0 的版本字串。顯示 command not found 就 sudo apt install -y git。

執行官方安裝指令

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

安裝腳本會自動處理 uv、Python 3.11、Node.js v22、ripgrep、ffmpeg¹。

不放心直接執行 curl | bash? 這是官方提供的方式、官方網域,但你也可以先看過:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
less install.sh
bash install.sh

重新載入 shell

安裝腳本把 ~/.local/bin 加進 PATH,但當前這個 shell 還不知道:

source ~/.bashrc

用 zsh 就換成 ~/.zshrc。或者直接開新的終端機工作階段。

成功判準:

hermes doctor

官方的環境診斷指令,會逐項檢查¹。有紅色項目就照它的提示修。

📝 這一段缺實際輸出:hermes doctor 在 Linux 上跑起來長什麼樣,我們手上沒有實機畫面。幫我們補上。

VPS 長駐:用 service user 部署

如果你要讓 agent 在伺服器上長期跑,不建議用 root 或你自己的帳號。官方文件的做法是:先以管理者身分安裝 Playwright 的系統相依套件,再切換到專用的 service user 執行安裝腳本¹。

伺服器上通常不需要瀏覽器功能,可以加參數跳過:

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

📝 待驗證:--skip-browser 的確切參數傳遞方式(是否需要 -s --)我們尚未實測。跑過的人請修正這一段。

設定模型供應商

hermes model

互動式選單,選供應商並填 API key¹。詳見模型供應商與 API key 設定。

開始使用

hermes

常見問題

安裝跑到一半停住,說解壓縮失敗?

多半是缺 xz-utils。sudo apt install -y xz-utils 之後重跑安裝指令。

打 hermes 說 command not found?

shell 沒重新載入。見 command not found 怎麼解。

其他發行版(Fedora / Arch)呢?

官方文件的前置套件說明是以 Debian / Ubuntu 為例。其他發行版換成對應的套件管理器指令即可(如 dnf install curl xz / pacman -S curl xz)。

📝 待驗證:非 Debian 系發行版的實際安裝經驗歡迎補充。

裝在哪?

預設 ~/.hermes/hermes-agent/,設定檔在 ~/.hermes/。

下一步

設定模型 → 模型供應商與 API key 設定
遇到 Python 版本問題 → Python 版本太舊怎麼解

Nous Research, Installation — https://hermes-agent.nousresearch.com/docs/getting-started/installation(2026-07-23 存取) ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶