Skip to main content

Hermes Agent 極速安裝指南

Hermes Agent 是一個能夠操作伺服器、執行工具並透過多種介面與您互動的 AI 代理。本教學將引導您使用官方安裝腳本，快速將 Gemma-4-31b-it 模型串接至 Telegram。

📌 前置準備

在開始之前，請確保您已擁有以下資訊：

  1. Google API Key：前往 Google AI Studio 獲取（用於驅動 Gemma 模型）。
  2. Telegram Bot Token：在 Telegram 搜尋 @BotFather，創建機器人並獲取 Token。
  3. 您的 Telegram Chat ID：在 Telegram 搜尋 @userinfobot 獲取您的 ID（這用於權限設定，確保只有您能操控伺服器）。

🛠️ 第一階段：一鍵安裝 Hermes

官方提供了自動化安裝腳本，它會幫您處理所有的依賴項、建立虛擬環境並安裝核心套件。

  1. 執行安裝指令 在您的 Linux 終端機輸入以下指令：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
  1. 啟動環境 安裝完成後，請重新啟動終端機或執行以下指令讓 hermes 指令生效：
source ~/.bashrc

⚙️ 第二階段：使用 hermes setup 部署環境

安裝完畢後，我們使用官方的交互式嚮導來配置大腦（LLM）與介面（Interface）。

  1. 啟動設定嚮導
hermes setup
  1. 交互選項配置指南 請依照下列選項進行填寫，以確保使用 Gemma-4-31b-it 與 Telegram：

Select LLM Provider • 建議選擇 / 輸入內容: google • 說明: 選擇 Google 供應商以使用 Gemma

Enter Google API Key • 建議選擇 / 輸入內容: 您的_API_KEY • 說明: 貼上從 AI Studio 獲取的金鑰

Select Model • 建議選擇 / 輸入內容: gemma-4-31b-it • 說明: 請務必輸入此精確模型名稱

Configure Interfaces • 建議選擇 / 輸入內容: telegram • 說明: 選擇 Telegram 作為對話介面

Enter Bot Token • 建議選擇 / 輸入內容: 您的_BOT_TOKEN • 說明: 貼上從 BotFather 獲取的 Token

Enter Allowed User IDs • 建議選擇 / 輸入內容: 您的_CHAT_ID • 說明: 輸入您的 ID，防止陌生人操控您的 AI

完成後，Hermes 會自動生成 .env 與 config.yaml 配置文件。

🚀 第三階段：啟動與驗證

  1. 啟動 Hermes 執行以下指令讓 AI 代理開始運行：
hermes run
  1. 驗證連線
  • 打開 Telegram 找到您的機器人並發送 /start。
  • 測試指令：你好，請告訴我你目前使用的模型版本。
  • 如果 AI 回應且能正確識別為 gemma-4-31b-it，則配置成功！

🏗️ 第四階段：進階部署 (後台常駐運行)

為了讓 AI 在您關閉終端機後依然運作，建議將其配置為系統服務 (systemd)。

  1. 建立服務檔
sudo nano /etc/systemd/system/hermes.service
  1. 貼入配置內容 (請將 /root/.hermes 修改為您的實際安裝路徑)
[Unit]
Description=Hermes AI Agent Service
After=network.target

[Service]
User=root
Group=root
WorkingDirectory=/root/.hermes
ExecStart=/root/.hermes/venv/bin/hermes run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
  1. 啟動服務
sudo systemctl daemon-reload
sudo systemctl enable hermes
sudo systemctl start hermes

📚 常用管理指令

  • 查看 AI 運行日誌：sudo journalctl -u hermes -f
  • 重新配置環境：hermes setup
  • 更新 Hermes 版本：git pull & sudo systemctl restart hermes
  • 停止服務：sudo systemctl stop hermes

恭喜您！您已經成功部署了一個由 Gemma-4-31b-it 驅動且透過 Telegram 遙控的強大 AI 代理！ 🤖✨

No comments to display

Back to top