H繁中版
文件入門指南installation
<!-- Source: https://hermesbible.com/docs/getting-started/installation -->

Section: Getting Started · URL: https://hermesbible.com/docs/getting-started/installation

在兩分鐘內讓 Hermes Agent 開始運作！

快速安裝

使用 Hermes Desktop 安裝程式（macOS 或 Windows，建議方式）

要輕鬆安裝命令列和桌面應用程式，請從我們的網站下載 Hermes Desktop 安裝程式並執行。

不使用 Hermes Desktop：

若要只安裝命令列版本而不使用 Hermes Desktop，請執行：

Linux / macOS / WSL2 / Android (Termux)

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

Windows (原生)

在 PowerShell 中執行：

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

如果在純命令列安裝後想要安裝並執行 Hermes Desktop，只需執行

hermes desktop

安裝程式做了什麼

安裝程式會自動處理所有事項 — 所有依賴套件（Python、Node.js、ripgrep、ffmpeg）、程式碼倉庫的複製、虛擬環境、全域 hermes 指令設定以及 LLM 供應商配置。完成後即可開始對話。

安裝目錄結構

安裝程式將檔案放置的位置取決於您是以一般使用者還是 root 身分安裝：

安裝方式程式碼位置hermes 執行檔資料目錄
pip installPython site-packages~/.local/bin/hermes (console_scripts)~/.hermes/
單一使用者 (git 安裝程式)~/.hermes/hermes-agent/~/.local/bin/hermes (符號連結)~/.hermes/
Root 模式 (sudo curl … | sudo bash)/usr/local/lib/hermes-agent//usr/local/bin/hermes/root/.hermes/（或 $HERMES_HOME）

Root 模式的 FHS 目錄結構（/usr/local/lib/…、/usr/local/bin/hermes）與 Linux 上其他全域開發工具的安裝位置一致。適用於需要讓同一套系統安裝服務所有使用者的共享機器部署場景。各使用者的設定（授權、技能、會話）仍然存放在各自的 ~/.hermes/ 或指定的 HERMES_HOME 下。

安裝完成後

重新載入您的 shell 然後開始聊天：

source ~/.bashrc   # 或：source ~/.zshrc
hermes             # 開始聊天！

若要之後重新設定個別選項，請使用專用指令：

hermes model          # 選擇您的 LLM 供應商和模型
hermes tools          # 設定要啟用的工具
hermes gateway setup  # 設定訊息平台
hermes config set     # 設定個別配置值
hermes setup          # 或執行完整的設定精靈一次配置所有項目

秘訣 — 最快速的方式：Nous Portal

單一訂閱即可使用 300+ 模型以及 Tool Gateway（網頁搜尋、圖片生成、TTS、雲端瀏覽器）。免去為每個工具分別管理金鑰的麻煩：

hermes setup --portal

此指令會自動登入、將 Nous 設為您的供應商，並一次性啟用 Tool Gateway。

系統需求

安裝程式： 在非 Windows 平台上，唯一的前置需求是 Git。安裝程式會自動處理其餘所有事項：

  • uv（快速的 Python 套件管理器）
  • Python 3.11（透過 uv 安裝，無需 sudo）
  • Node.js v22（用於瀏覽器自動化和 WhatsApp 橋接）
  • ripgrep（快速檔案搜尋）
  • ffmpeg（TTS 的音訊格式轉換）

說明

您不需要手動安裝 Python、Node.js、ripgrep 或 ffmpeg。安裝程式會偵測缺少的元件並自動安裝。只需確保 git 可用即可（git --version）。

秘訣 — Nix 使用者

如果您使用 Nix（在 NixOS、macOS 或 Linux 上），有專屬的安裝方式，包含 Nix flake、聲明式 NixOS 模組以及可選的容器模式。請參閱 Nix & NixOS 安裝指南。

手動 / 開發者安裝

如果您想要複製程式碼倉庫並從原始碼安裝 — 用於貢獻、從特定分支執行，或需要完整控制虛擬環境 — 請參閱貢獻指南中的開發環境設定章節。

無 sudo / 系統服務使用者安裝

支援以專用的無權限使用者身分執行 Hermes（例如 hermes systemd 服務帳號，或任何沒有 sudo 權限的使用者）。安裝路徑中唯一真正需要 root 權限的是 Playwright 的 --with-deps 步驟，該步驟透過 apt 安裝 Chromium 所需的共享函式庫（libnss3、libxkbcommon 等）。安裝程式會偵測 sudo 是否可用，若不可用則會優雅降級 — 它會將 Chromium 執行檔安裝到服務使用者自己的 Playwright 快取中，並輸出管理員需要另行執行的確切指令。

建議的分工方式（Debian/Ubuntu）：

  1. 一次性以有 sudo 權限的管理員身分，安裝 Chromium 所需的系統函式庫：

    sudo npx playwright install-deps chromium

    （可在任何位置執行 — npx 會即時下載 Playwright。）

  2. 以無權限的服務使用者身分，執行一般安裝程式。它會偵測到 sudo 不可用，略過 --with-deps，並將 Chromium 安裝到使用者的本地 Playwright 快取中：

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

    如果想要完全略過 Playwright 步驟 — 例如因為在無頭環境中執行且不需要瀏覽器自動化 — 可加上 --skip-browser：

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

  3. 讓服務使用者的 shell 能使用 hermes。 安裝程式會將啟動器寫入 ~/.local/bin/hermes。系統服務帳號通常使用精簡的 PATH，不包含 ~/.local/bin。可以將其加入使用者環境變數，或将啟動器建立符號連結到系統目錄：

    # 選項 A — 加入服務使用者的環境設定
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# 選項 B — 系統級符號連結（以管理員身分執行）
sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes

  4. 驗證： hermes doctor 應該能正常執行。若出現 ModuleNotFoundError: No module named 'dotenv'，表示您使用系統 Python 執行了倉庫原始碼的 hermes 檔案（~/.hermes/hermes-agent/hermes），而非虛擬環境啟動器（~/.hermes/hermes-agent/venv/bin/hermes）— 請修正步驟 3。

相同的模式也適用於 Arch（安裝程式使用 pacman 並採用相同的 sudo 偵測邏輯）、Fedora/RHEL 和 openSUSE — 這些發行版不支援 --with-deps，因此管理員需另行安裝系統函式庫。相關的 dnf/zypper 指令會由安裝程式顯示。

疑難排解

問題解決方案
hermes: command not found重新載入您的 shell（source ~/.bashrc）或檢查 PATH
API key not set執行 hermes model 設定您的供應商，或執行 hermes config set OPENROUTER_API_KEY your_key
更新後設定消失執行 hermes config check 然後執行 hermes config migrate

若需要更多診斷資訊，請執行 hermes doctor — 它會明確告知缺少什麼以及如何修復。

安裝方式自動偵測

Hermes 會自動偵測安裝方式（透過 pip、git 安裝程式、Homebrew 或 NixOS），hermes update 會顯示對應安裝方式的更新指令。不需要設定任何環境變數 — 偵測是基於安裝目錄結構（Python site-packages、~/.hermes/hermes-agent/、Homebrew 前綴或 Nix store 路徑）。hermes doctor 也會在環境摘要中顯示偵測到的安裝方式。

快速開始

web search provider pluginlearning path