把 Hermes 跑起來
Hermes Agent v0.8.0 在 Linux、macOS 或 WSL2 上大約 60 秒就能裝好。一條 curl 指令，安裝器會幫你搞定 uv、Python 3.11、Node.js、ripgrep 和 ffmpeg。
checklist 系統需求
事前只需要 git——Python 3.11、Node.js v22、uv、ripgrep、ffmpeg 都由 script 安裝
Linux、macOS、Windows 上的 WSL2，或透過 Termux 的 Android。原生 Windows 不支援。
記憶體至少 2 GB；要跑本地模型的話會需要更多
agent、venv、Node modules 與內建 skill 加起來大約需要 1 GB
可選：Docker、SSH、Daytona、Singularity、Modal，用來沙箱化指令執行
呼叫雲端模型 API 時需要網路連線。透過 OpenAI 相容 endpoint 跑的本地模型可以離線使用。
官方文件上的那條一行指令。Linux、macOS 或 WSL2 使用者推薦走這條。 安裝文件 arrow_forward
WSL2（Windows）
原生 Windows 不支援。先跑 'wsl --install'，然後在 WSL2 shell 裡執行這條指令。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
事前只需要 git——安裝器會負責裝 uv、Python 3.11、Node.js v22、ripgrep 和 ffmpeg。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified 驗證安裝
跑一下官方文件裡列出的這幾條驗證指令。
hermes version 印出目前安裝的版本（應該是 0.8.0 或更新）。
hermes doctor 跑一次診斷——檢查 Python、uv、依賴、設定檔與連線。
hermes status 印出目前的設定：模型 provider、啟用的工具以及已連上的 gateway。
settings 第一次設定
裝完之後，重載 shell，然後跑文件上列出的三條設定指令。
選一個模型 provider
跑 'hermes model' 挑一個 provider。README 列出 Nous Portal、OpenRouter、z.ai/GLM、Kimi/Moonshot、MiniMax、OpenAI 以及自訂 endpoint。Anthropic 和 Mistral 也以依賴方式一起打包進來。
啟用你想用的工具
跑 'hermes tools' 設定哪些內建工具要啟用（共 47 個）。之後隨時可以加或減。
跑完整的設定精靈
跑 'hermes setup' 走完整流程，包含 API key 和聊天 gateway 連線（Telegram、Discord、Slack、WhatsApp、Signal、Email）。
發一則測試訊息
試試 'hermes chat -q "Hello! What tools do you have available?"'——官方 quickstart 裡就是這麼寫的。
.env — 設定都放在 ~/.hermes/ 下——主要設定是 config.yaml，API key 在 .env，另外還有 session、logs、memories、skills、cron job 的子目錄。完整的環境變數參考見 hermes-agent.nousresearch.com/docs/reference/environment-variables。
cloud VPS／伺服器部署
Hermes 可以跑在任何 2 GB 記憶體、約 1 GB 磁碟的 Linux VPS 上。同一條安裝命令在 SSH 下直接執行。
SSH 登入伺服器
Ubuntu、Debian、CentOS、Arch 等常見發行版皆可。
ssh user@your-server-ip 執行安裝指令碼
指令碼會自動辨識發行版、透過 uv 安裝 Python 3.11 並設好所有依賴。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 啟用沙箱後端
在共享基礎設施上，建議設定沙箱後端（Docker、SSH、Daytona、Singularity 或 Modal），讓 Hermes 的 shell 命令在隔離環境中執行。詳細設定請見 README。
設定 API key 並啟動
選擇模型供應商後啟動 Hermes。程序跑在前景，建議用 tmux 或 screen 維持工作階段。
hermes model && hermes Tip — 若需要常駐守護程序，建議在 tmux/screen 中執行 Hermes，或撰寫 systemd unit 檔案。官方文件中有 daemon 設定範例。
system_update_alt 升級 Hermes
README 有寫內建升級器：'hermes update'。目前沒有發布到 PyPI，也沒有官方 Docker image，所以其他升級方式都要走 git。 升級指南 arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # 目前還沒有官方 Docker image 每個版本的詳細變更請看 github.com/NousResearch/hermes-agent/releases。
delete_forever 解除安裝 Hermes
Hermes 裝在 ~/.hermes/hermes-agent/，並在 ~/.local/bin/hermes 建立 binary 軟連結。兩條指令就能全部清掉。 解除安裝說明 arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # 沒有官方 Docker image 要清 清除使用者資料（可選）
這會刪掉你的 session、記憶、skill、cron job 與 API key。需要的話先備份。
rm -rf ~/.hermes # 請在 WSL shell 裡跑——原生 Windows 不支援