AI

6 分鐘安裝 Hermes Agent:從 $5 VPS 到完全免費本地部署

2026年4月9日
4 分鐘閱讀
6 分鐘安裝 Hermes Agent:從 $5 VPS 到完全免費本地部署

Hermes Agent 是 Nous Research 打造的開源 AI Agent,會自己建立技能、累積記憶,並且能在你放它的任何地方長期運行。很多人卡在第一步:到底該怎麼裝。這篇文章把官方目前支援的安裝方式整理成 6 條路線,從 macOS 與 Windows 的桌面安裝包,到 Linux 一行安裝腳本、Windows 原生安裝、Docker 容器、每月約 5 美元的雲端主機,以及完全免費的本地模型部署,逐項說明適用情境與實際指令。

摘要

本文涵蓋 Hermes Agent 目前官方支援的 6 種安裝路線,包含桌面安裝包、一行安裝腳本、Windows 原生安裝、Docker 容器、雲端 VPS,以及本地模型免費運行。每種方式都會列出實際指令與適用對象,並在最後整理成一張比較表。文中做法以官方安裝文件為準,最後整理於 2026 年 10 月;實際動手前建議同時對照官方文件的最新版本。

docker/compose 在 GitHub 的專案首頁。對應文章「6 分鐘安裝 Hermes Agent」,可查看 README、目錄結構與文件入口,方便跟著正文步驟核對原始碼位置。
▲ docker/compose 在 GitHub 的專案首頁。對應文章「6 分鐘安裝 Hermes Agent」,可查看 README、目錄結構與文件入口,方便跟著正文步驟核對原始碼位置。

選擇適合自己的部署方式

在開始安裝之前,先了解自己的需求能幫助你選擇最適合的方式。以下是快速決策指引:

docker/compose 的 GitHub Releases 分頁,列出正式發行版本與更新說明。閱讀「6 分鐘安裝 Hermes Agent」時若要鎖定穩定版號,可先從這頁核對。
▲ docker/compose 的 GitHub Releases 分頁,列出正式發行版本與更新說明。閱讀「6 分鐘安裝 Hermes Agent」時若要鎖定穩定版號,可先從這頁核對。
  • 想少打字、只想快點看到畫面 → 方式 1 桌面安裝包
  • Linux、macOS 或 Windows 的 WSL2 使用者 → 方式 2 一行安裝腳本
  • 原生 Windows、不想開 WSL → 方式 3 PowerShell 安裝
  • 需要環境隔離,或要跑在伺服器上 → 方式 4 Docker 容器
  • 要 24 小時不關機 → 方式 5 雲端 VPS
  • 重視隱私、想用自己的顯卡 → 方式 6 本地模型部署

方式 1:桌面安裝包(macOS、Windows 最省事)

官方網站提供 macOS 與 Windows 的桌面安裝包,裡面已經打包好 Agent、Python 執行環境與預先編譯好的介面,第一次啟動不需要自己建置。Windows 使用者下載 .appinstaller 後,交給系統的 App Installer 安裝;macOS 使用者下載 DMG,把 Hermes.app 拖進「應用程式」即可。要留意的是 macOS 版只支援 Apple Silicon(M 系列晶片),Intel 版 Mac 不在支援清單內,官方建議改用命令列安裝。

桌面版與命令列版本共用同一份設定與資料,安裝後想改用終端機操作,或反過來在裝了命令列之後補上介面,都不需要重來。

方式 2:一行安裝腳本(Linux、macOS、WSL2)

這是命令列安裝的標準做法。打開終端機執行:

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

腳本會下載原始碼、準備好 Python 與 Node 等相依工具,並建立啟動指令。完成後重新載入 shell,直接輸入 hermes 就能開始對話:

source ~/.bashrc

hermes

如果之後想補裝桌面版介面,再執行 hermes desktop 即可。這條路線的好處是相依套件會自動處理,連瀏覽器工具與電腦操作工具都會一起裝好;若你不需要,可以在安裝時加上 --skip-browser 或 --skip-computer-use 參數略過,安裝腳本會記住你的選擇,之後更新不會又把它們裝回來。

docker/compose 的 GitHub Issues 分頁,可見使用者回報的問題與討論。想評估維護狀態與常見踩坑,這頁通常比只看星數更有參考價值。
▲ docker/compose 的 GitHub Issues 分頁,可見使用者回報的問題與討論。想評估維護狀態與常見踩坑,這頁通常比只看星數更有參考價值。

方式 3:Windows 原生安裝(PowerShell)

不想透過 WSL,直接在 Windows 上跑也可以。用 PowerShell 執行:

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

官方建議使用 Windows 11 22H2 以上版本。安裝完成後同樣重新載入終端機,輸入 hermes 啟動。這條路線與方式 2 的差異只在平台,安裝後的行為一致,設定檔與資料目錄也都沿用同一套規則。

方式 4:Docker 容器(隔離、適合伺服器)

若你希望 Hermes 與主機環境完全隔離,或要把 Agent 跑在伺服器上,官方有提供 Docker 映像檔,直接拉下來就能用:

docker pull nousresearch/hermes-agent

Docker 版本的資料目錄預設掛載在 /opt/data,映像檔內建 hermes 執行入口。要特別留意的是,Docker 安裝不支援 hermes update 指令,更新時是換一個新的映像檔,而不是在容器內升級。

反過來說,Hermes 也把 Docker 當成一種「終端後端」。如果你的 Hermes 裝在主機上,卻希望它執行的指令跑在容器裡,可以在設定檔把 terminal.backend 設為 docker,再用 docker_volumes 決定哪些資料夾要跟主機共享,用 docker_forward_env 決定要轉發哪些憑證進去。

方式 5:雲端 VPS(每月約 5 美元,24 小時運行)

官方文件把 Hermes 形容成「你把它放在哪,它就住哪」,一台每月約 5 美元的 VPS 就很夠用。做法是租一台 Linux 主機,用 SSH 連進去之後,直接跑方式 2 的那行安裝腳本:

# 更新系統
sudo apt update && sudo apt upgrade -y

# 安裝 Hermes Agent
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

裝好之後,Hermes 可以透過 Telegram、Discord、Slack 等通訊軟體遠端操作,不一定要自己 SSH 進去。選主機時建議抓 2 核心 CPU、2GB 以上記憶體,並挑離你較近的機房以降低延遲。雲端 VPS 的優點是 24 小時運行、不用管硬體維護、也能綁定固定 IP;缺點是要付月費,且需要基本的 Linux 操作能力。

方式 6:本地模型與免費部署

如果你完全不想付 API 費用,也不想把資料傳到雲端,可以讓 Hermes 連到自己機器上跑的開源模型。做法是先安裝 Ollama 這類本地推論環境:

curl -fsSL https://ollama.com/install.sh | sh

ollama pull llama3

接著在 Hermes 裡把模型提供者指向本地端點。Hermes 的模型設定統一放在 ~/.hermes/config.yaml,用 hermes model 或 hermes config set 都能改。這種方式的優點是零 API 成本、資料不離開自己的機器、也能離線運行;缺點是需要足夠的顯示卡記憶體,推論速度會受硬體限制。若手邊沒有夠力的機器,也可以考慮用二手顯示卡自組一台,但要把電費與維護成本一併算進去。另外,Android 裝置(aarch64)可以透過 Termux 的套件庫安裝,等於把手機也變成一台可攜的 Agent 主機。

各方式優缺點比較表

方式 適用平台 啟動時間 費用 技術難度 適合對象
桌面安裝包 macOS、Windows 5 分鐘 $0 ★☆☆☆☆ 初次體驗者
一行安裝腳本 Linux、macOS、WSL2 2 分鐘 $0 ★★☆☆☆ 開發者
Windows 原生 Windows 2 分鐘 $0 ★★☆☆☆ 原生 Windows 使用者
Docker 容器 有 Docker 的環境 10 分鐘 $0 ★★★☆☆ 需要隔離或上伺服器
雲端 VPS Linux 主機 15 分鐘 約 $5 起 ★★☆☆☆ 全天候運行需求
本地模型 自有桌機或伺服器 30 分鐘以上 $0(需硬體) ★★★☆☆ 重視隱私者

安裝後的基本設定:模型、工具與終端後端

安裝只是第一步,裝完之後的設定都集中在 ~/.hermes/ 目錄裡。設定分成兩種:非機密的設定寫在 config.yaml,金鑰與權杖這類機密則放進 .env,兩者同時存在時以 config.yaml 為準。

最省事的起手式,是官方入口 Nous Portal 的一站式設定,一行指令就能同時搞定模型與工具:

hermes setup --portal

這會幫你登入、把模型提供者設為 Nous,並開啟內建的工具通道(網頁搜尋、圖片生成、語音、雲端瀏覽器)。想逐項調整的話,官方也提供對應指令:

hermes model          # 選擇模型提供者與模型
hermes tools          # 設定啟用哪些工具
hermes gateway setup  # 設定通訊平台(Telegram、Discord 等)
hermes config set     # 修改單一設定值
hermes config get     # 檢視單一設定值
hermes setup          # 一次跑完整設定精靈

例如要把預設模型換成 Claude 系列,或把終端後端改成 Docker,分別是:

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker

這裡有一個常見誤解要澄清:Hermes 的設定並不是靠 MODEL_PROVIDER、DEFAULT_MODEL 這類環境變數,而是 config.yaml 加上 .env。金鑰放 .env,其餘設定放 config.yaml。另外,凡是全大寫加底線的名稱(例如 OPENROUTER_API_KEY)會被視為環境變數存進 .env,帶點號的設定(例如 terminal.backend)則寫進 config.yaml,指令會自動判斷該存哪個檔案。終端後端除了 local 與 docker,還支援 SSH、Daytona、Modal、Singularity、Vercel Sandbox 等,適合把執行環境放到遠端或無伺服器平台。

驗證安裝成功的步驟

裝完之後,可以用官方內建的檢查工具確認狀態:

hermes doctor          # 檢查缺少什麼、怎麼修
hermes config check    # 檢查設定是否有缺漏或過期

hermes doctor 會直接告訴你哪個相依套件或金鑰沒設好。如果訊息是「API key not set」,就執行 hermes model 重新設定提供者。日誌檔放在 ~/.hermes/logs/,內容會自動遮蔽機密。Docker 版本則可以用 docker ps 確認容器在跑,再進容器執行 hermes 測試。

常見錯誤排除(FAQ)

Q1:可以用 pip 安裝嗎?

不行。官方明確把 pip 安裝(例如 pip install hermes-agent)、uv 與 brew 安裝列為不支援的方式。這些做法可能當下能跑,但之後會壞、也不在修復範圍內,建議改用安裝腳本或桌面安裝包。

Q2:啟動時說沒有 API Key?

執行 hermes model 設定模型提供者,或直接 hermes config set OPENROUTER_API_KEY 你的金鑰,金鑰會存進 .env。若使用 Nous Portal,跑一次 hermes setup --portal 就好。

Q3:更新後設定好像跑掉?

先跑 hermes config check 找出缺漏與過期的選項,再用 hermes config migrate 補齊。

Q4:Docker 跑完,檔案變成 root 所有?

在 config.yaml 把 terminal.docker_run_as_host_user 設為 true,容器就會用你的使用者身分寫入共享目錄,之後不用再手動 chown。

Q5:安裝時說缺少 libatomic?

在精簡的 Linux 映像檔上,安裝腳本會自動幫你裝對應的系統套件(apt 環境是 libatomic1)。若是非互動安裝而沒裝成功,手動補上該套件再重跑即可。

Q6:要怎麼更新到最新版?

看你的安裝方式。原始碼安裝用 hermes update;桌面版用內建更新;Docker 版本則換一個新的映像檔。Nix 與 Termux 安裝由各自的套件管理員負責更新。

替代方案有限公司觀點:哪種方式最划算?

經過實際測試與客戶環境的觀察,替代方案有限公司團隊認為「一行安裝腳本加上雲端 VPS」是性價比最高的組合。原因很直接:腳本安裝自動處理了相依套件,省掉最容易出錯的一段;而每月約 5 美元的 VPS 讓 Hermes 24 小時在線,電力成本趨近於零,也不受本地硬體限制。若你有更嚴格的隱私需求,可以在同一套架構下把模型提供者換成本地 Ollama,資料完全自己掌控。

需要環境隔離或有既有容器平台的團隊,可以改用 Docker 安裝,或把終端後端設為 docker、SSH 等遠端後端,讓 Agent 的控制與執行分離。純粹從成本角度來看,二手設備長期確實更省,但要加上時間成本、維護成本與電力成本一起算。至於 Kubernetes,官方目前並未把它列為支援的安裝方式,企業若有長期服務需求,建議以 Docker 或雲端主機搭配標準部署流程處理,會比自行拼裝一套非官方架構來得穩妥。

最後一個實務提醒:這些設定沒有標準答案,最好的方式是先用預設值跑一週,觀察日誌再針對性調整。替代方案有限公司的技術團隊在實測多個客戶環境後發現,光是調整記憶體與並行相關的設定,就能讓一台 2GB RAM 的小機器從每週崩一次,變成穩定運行三個月無故障。

結論

Hermes Agent 的安裝選項比想像中單純:官方主要提供安裝腳本、桌面安裝包與 Docker 三條主線,其餘平台各有對應做法。桌面安裝包適合想快速看到成果的人,一行腳本適合多數開發者,Docker 適合需要隔離或上伺服器的場景,雲端 VPS 提供成本與便利性的平衡,本地模型則保障最高隱私。搞懂這幾條路線的差異,你就能挑到真正適合自己的那條。

安裝完成後別急著關掉終端機,先跑一次 hermes doctor 確認環境,再設定好模型與工具,後面的使用才會順。本文的比較表與逐步說明應該能幫你做出決定,若在安裝過程中卡住,FAQ 章節涵蓋了最常見的幾種情境。

延伸閱讀

立即開始你的 Hermes Agent 部署之旅,選擇最適合你的方式,享受 AI Agent 帶來的效率提升與自動化能力。

Related

延伸閱讀