這篇記錄把 Nous Research 的 Hermes Agent 裝進 GitHub Codespaces 的完整過程:用官方安裝腳本安裝、跑設定精靈、接上 LINE 官方帳號當對話介面,模型走 NVIDIA NIM 的 Nemotron。全程在瀏覽器裡完成,不用準備自己的機器。
打開官方 GitHub 專案:
在 repo 頁點右上角 Code,選 Codespaces 分頁建立新的 Codespace (圖中是已經建好的那台)。注意下方那行提示:這個 repo 的 Codespace 用量算在自己帳號,免費額度用完會開始計費。
Codespace 開啟後的第一個畫面是 VS Code 的信任詢問,因為接下來要在終端機執行安裝指令,選「信任資料並繼續」。
環境就緒:左邊是 hermes-agent 原始碼,下方終端機停在 /workspaces/hermes-agent,接著就可以安裝。
跑起來後會先檢查 git、curl 等前置工具,再下載最新穩定版 (截圖時是 v0.22.5) 開始安裝。
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
安裝完成的畫面:相依套件裝好、設定檔建在 /home/codespace/.hermes、hermes 指令已加入 PATH。接著自動進入設定精靈,第一步是 Nous Portal 登入 (在瀏覽器開連結、輸入裝置碼核准)。Nous Portal 是官方的訂閱制模型來源,一個訂閱含 300 多個模型與工具閘道;本文後段改用 NVIDIA NIM,不用 Nous Portal 也可以跑。
hermes setup
設定精靈問的第一件事是終端機後端 (terminal backend):Agent 要在哪裡執行指令。在 Codespace 裡直接選 Keep current (local) 就好,其他是 Docker、Modal、SSH 遠端主機等進階選項。
接著問要不要現在連接訊息平台,選 Set up messaging now (之後想補設定,下 hermes setup gateway 也可以)。
平台清單有近 30 種 (Telegram、Discord、Slack、WhatsApp、WeChat 等),這次勾 LINE。
在 LINE Developers Console 進到這個頻道的 Messaging API 分頁,需要的第一把鑰匙是下方的 Channel access token (long-lived),複製起來等一下要用 (截圖已馬賽克處理)。
第二把鑰匙在 Basic settings 分頁的 Channel secret。這組 token 加 secret,等一下都要填進 Hermes 的設定裡。
cloudflared 下載並以 dpkg 安裝完成 (版本 2026.10.6)。裝它的目的:Codespace 本身沒有公開網址,LINE 的 Webhook 需要一個外網連得到的 URL,要靠 Cloudflare Tunnel 打通。
wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -O cloudflared.deb
執行 tunnel 後會拿到一個 trycloudflare.com 的臨時網址 (紅框處),這就是等一下要填進 LINE 後台的 Webhook 來源。注意:這種免帳號的快速隧道每次重啟網址都會變,Codespace 或 tunnel 重開後,LINE 後台的 Webhook URL 要跟著換。
sudo dpkg -i cloudflared.deb
cloudflared tunnel --url http://localhost:8646
回 LINE Developers Console 的 Messaging API 分頁,把 Webhook URL 填成剛拿到的隧道網址加上 /line/webhook,並把 Use webhook 打開。
設定精靈還會問要不要把匿名使用統計回傳給 Nous (Help improve Hermes?),這裡選 No thanks;之後想改,下 hermes setup telemetry 即可。
Setup Complete:所有設定集中在 ~/.hermes (config.yaml 管設定、.env 管金鑰)。畫面也列了日後調整用的指令,例如 hermes setup gateway 重設訊息平台、hermes doctor 做健康檢查。
下 hermes gateway 啟動訊息閘道。上方兩串警告要看:一是還沒設使用者白名單,未設定時閘道預設拒絕陌生人傳訊;二是 Nous Portal 未登入的提示,因為模型改走 NVIDIA NIM,這個可以忽略。下一步就把 LINE 的三個值寫進 .env 補上白名單 (原文緊接著就是這三行)。
LINE_CHANNEL_ACCESS_TOKEN=你的長期存取權杖
LINE_CHANNEL_SECRET=你的頻道密鑰
LINE_ALLOWED_USERS=你的LINE使用者ID(U 開頭,逗號分隔)
.env 寫好、gateway 重新啟動後,回 LINE 後台按 Webhook 的 Verify,跳出 Success 就代表 LINE 已經能把訊息送進 Codespace 裡的 Hermes。
再下 hermes 進入對話介面 (v0.22.5,內建 20 個工具、54 個技能)。第一次進來會提示還沒設定推論供應商,跟著往下設定。
供應商清單很長 (Nous Portal、Anthropic、OpenAI、OpenRouter 等),這次選 NVIDIA NIM:用 build.nvidia.com 的 API 跑 Nemotron 等模型。
貼上 NVIDIA_API_KEY 後會存檔,接著確認 Base URL,預設的 https://integrate.api.nvidia.com/v1 直接用就好。
選預設模型:清單是 NIM 上可用的模型,這裡選 nvidia/nemotron-3.5-super-v1-120b-a12b。
推理強度 (reasoning effort) 選 medium。
設定完成:畫面確認供應商設好、預設模型是 nemotron-3.5-super-v1-120b-a12b、推理強度 medium,可以開始對話了。
先在終端機介面問它能做什麼,Nemotron 用繁體中文條列回覆,能力包含寫程式與操作程式庫、瀏覽器自動化、委派子代理、排程、多媒體等。
最後是 LINE 端實測:在 Deep Learning 101 官方帳號問同一句,Hermes 透過剛設好的 Webhook 與隧道正常回覆,整條鏈路打通。提醒一句:Codespace 閒置會自動關機,gateway 與 tunnel 都要重開,網址變了記得回 LINE 後台更新 Webhook URL。
























