1

apt install curl git xz-utils ripgrep ffmpeg build-essential python3-dev libffi-dev

1
2
3

root@vm110-hermes:~# useradd hermes
root@vm110-hermes:~# id hermes
uid=1001(hermes) gid=1001(hermes) groups=1001(hermes)

1

hermes    ALL=(ALL:ALL) NOPASSWD:ALL

1
2

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

1
2
3
4
5

How would you like to set up Hermes?
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (●) Quick setup — provider, model & messaging (recommended)
 → (○) Full setup — configure everything

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

Select provider:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (○) OpenRouter (100+ models, pay-per-use)
   (○) Vercel AI Gateway (200+ models, $5 free credit, no markup)
   (○) Anthropic (Claude models — API key or Claude Code)
   (○) OpenAI Codex
   (○) Xiaomi MiMo (MiMo-V2.5 and V2 models — pro, omni, flash)
   (○) NVIDIA NIM (Nemotron models — build.nvidia.com or local NIM)
   (○) Qwen OAuth (reuses local Qwen CLI login)
   (○) GitHub Copilot (uses GITHUB_TOKEN or gh auth token)
   (○) GitHub Copilot ACP (spawns `copilot --acp --stdio`)
   (○) Hugging Face Inference Providers (20+ open models)
   (○) Google AI Studio (Gemini models — native Gemini API)
   (○) Google Gemini via OAuth + Code Assist (free tier supported; no API key needed)
   (○) DeepSeek (DeepSeek-V3, R1, coder — direct API)
   (○) xAI (Grok models — direct API)
   (○) Z.AI / GLM (Zhipu AI direct API)
   (○) Kimi Coding Plan (api.kimi.com) & Moonshot API
   (○) Kimi / Moonshot China (Moonshot CN direct API)
 → (○) StepFun Step Plan (agent/coding models via Step Plan API)
   (○) MiniMax (global direct API)
   (○) MiniMax China (domestic direct API)
   (○) Alibaba Cloud / DashScope Coding (Qwen + multi-provider)
   (○) Ollama Cloud (cloud-hosted open models — ollama.com)
   (○) Arcee AI (Trinity models — direct API)
   (○) Kilo Code (Kilo Gateway API)
   (○) OpenCode Zen (35+ curated models, pay-as-you-go)
   (○) OpenCode Go (open models, $10/month subscription)
   (○) AWS Bedrock (Claude, Nova, Llama, DeepSeek — IAM or API key)
   (○) Azure Foundry (OpenAI-style or Anthropic-style endpoint — your Azure AI deployment)
   (○) Custom endpoint (enter URL manually)
   (○) Configure auxiliary models...
   (○) Leave unchanged

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

Select TTS provider:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (○) Edge TTS (free, cloud-based, no setup needed)
   (○) ElevenLabs (premium quality, needs API key)
   (○) OpenAI TTS (good quality, needs API key)
   (○) xAI TTS (Grok voices, needs API key)
   (○) MiniMax TTS (high quality with voice cloning, needs API key)
   (○) Mistral Voxtral TTS (multilingual, native Opus, needs API key)
 → (○) Google Gemini TTS (30 prebuilt voices, prompt-controllable, needs API key)
   (○) NeuTTS (local on-device, free, ~300MB model download)
   (○) KittenTTS (local on-device, free, lightweight ~25-80MB ONNX)
   (●) Keep current (Edge TTS)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

### 1. 首選建議：Google Gemini TTS
既然你已經擁有 **Google AI Pro** 訂閱，選擇 **Google Gemini TTS** 是最邏輯的決定：
* **整合優勢**：你可以直接使用現有的 API Key，不需要額外去其他平台註冊或刷卡。
* **提示詞控制**：Gemini TTS 的特色在於可以用提示詞（Prompt）來微調語氣，這對 AI Agent 的互動體驗加分不少。
* **穩定性**：對於身處台灣的網路環境，Google 的邊緣節點反應速度通常非常理想。

### 2. 本地化考量：KittenTTS 或 NeuTTS
如果你希望減少對雲端 API 的依賴，或是在開發過程中不想產生額外的 Token 費用：
* **KittenTTS**：非常輕量（80MB 以內），適合放在你的 Debian VM 裡跑，不會佔用太多記憶體。
* **NeuTTS**：音質會比 KittenTTS 好一些，但需要額外下載模型。

### 3. 高品質商業方案：ElevenLabs
如果你追求的是「像真人一樣」的語氣與情感起伏：
* **ElevenLabs** 是目前公認的業界標竿，但缺點是價格較貴且有字數限制。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

Select terminal backend:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (○) Local - run directly on this machine (default)
   (○) Docker - isolated container with configurable resources
   (○) Modal - serverless cloud sandbox
 → (○) SSH - run on a remote machine
   (○) Daytona - persistent cloud development environment
   (○) Singularity/Apptainer - HPC-friendly container
   (●) Keep current (local)

1
2
3
4
5
6
7

 Agent Settings
     Guide: https://hermes-agent.nousresearch.com/docs/user-guide/configuration

  Maximum tool-calling iterations per conversation.
  Higher = more complex tasks, but costs more tokens.
  Press Enter to keep 60. Use 90 for most tasks or 150+ for open exploration.
Max iterations [60]: 

1
2
3
4
5
6
7

  Tool Progress Display
  Controls how much tool activity is shown (CLI and messaging).
    off     — Silent, just the final response
    new     — Show tool name only when it changes (less noise)
    all     — Show every tool call with a short preview
    verbose — Full args, results, and debug logs
Tool progress mode [all]: 

1
2
3
4

◆ Context Compression
  Automatically summarizes old messages when context gets too long.
  Higher threshold = compress later (use more context). Lower = compress sooner.
Compression threshold (0.5-0.95) [0.5]: 

1
2
3
4
5
6
7
8

Session reset mode:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

 → (●) Inactivity + daily reset (recommended - reset whichever comes first)
   (○) Inactivity only (reset after N minutes of no messages)
   (○) Daily only (reset at a fixed hour each day)
   (○) Never auto-reset (context lives until /reset or context compression)
   (○) Keep current settings

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

Select platforms to configure:
  ↑↓ navigate  SPACE toggle  ENTER confirm  ESC cancel

   [✓] Telegram
   [✓] Discord
   [ ] Slack
   [ ] Signal
   [✓] Email
   [ ] SMS (Twilio)
   [ ] Matrix
   [ ] Mattermost
   [ ] WhatsApp
   [ ] DingTalk
   [ ] Feishu / Lark
   [ ] WeCom (Enterprise WeChat)
 → [ ] WeCom Callback (Self-Built App)
   [ ] Weixin (WeChat)
   [ ] BlueBubbles (iMessage)
   [ ] QQ Bot
   [ ] Webhooks (GitHub, GitLab, etc.)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

◆ Messaging Platforms
  Connect to messaging platforms to chat with Hermes from anywhere.
  Toggle with Space, confirm with Enter.


◆ Telegram
  Create a bot via @BotFather on Telegram
Telegram bot token: 
✓ Telegram token saved

  🔒 Security: Restrict who can use your bot
     To find your Telegram user ID:
     1. Message @userinfobot on Telegram
     2. It will reply with your numeric ID (e.g., 123456789)

Allowed user IDs (comma-separated, leave empty for open access): 
✓ Telegram allowlist configured - only listed users can use the bot

  📬 Home Channel: where Hermes delivers cron job results,
     cross-platform messages, and notifications.
     For Telegram DMs, this is your user ID (same as above).
Use your user ID () as the home channel? [Y/n]: Y
✓ Telegram home channel set to 

◆ Discord
  Create a bot at https://discord.com/developers/applications
Discord bot token: 
✓ Discord token saved

  🔒 Security: Restrict who can use your bot
     To find your Discord user ID:
     1. Enable Developer Mode in Discord settings
     2. Right-click your name → Copy ID

     You can also use Discord usernames (resolved on gateway start).

Allowed user IDs or usernames (comma-separated, leave empty for open access): 
✓ Discord allowlist configured

  📬 Home Channel: where Hermes delivers cron job results,
     cross-platform messages, and notifications.
     To get a channel ID: right-click a channel → Copy Channel ID
     (requires Developer Mode in Discord settings)
     You can also set this later by typing /set-home in a Discord channel.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

┌─────────────────────────────────────────────────────────┐
│              ✓ Setup Complete!                          │
└─────────────────────────────────────────────────────────┘

📁 All your files are in ~/.hermes/:

   Settings:  /home/hermes/.hermes/config.yaml
   API Keys:  /home/hermes/.hermes/.env
   Data:      /home/hermes/.hermes/cron/, sessions/, logs/

────────────────────────────────────────────────────────────

📝 To edit your configuration:

   hermes setup          Re-run the full wizard
   hermes setup model    Change model/provider
   hermes setup terminal Change terminal backend
   hermes setup gateway  Configure messaging
   hermes setup tools    Configure tool providers

   hermes config         View current settings
   hermes config edit    Open config in your editor
   hermes config set <key> <value>
                          Set a specific value

   Or edit the files directly:
   nano /home/hermes/.hermes/config.yaml
   nano /home/hermes/.hermes/.env

────────────────────────────────────────────────────────────

🚀 Ready to go!

   hermes              Start chatting
   hermes gateway      Start messaging gateway
   hermes doctor       Check for issues

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

██╗  ██╗███████╗██████╗ ███╗   ███╗███████╗███████╗       █████╗  ██████╗ ███████╗███╗   ██╗████████╗
██║  ██║██╔════╝██╔══██╗████╗ ████║██╔════╝██╔════╝      ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
███████║█████╗  ██████╔╝██╔████╔██║█████╗  ███████╗█████╗███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║
██╔══██║██╔══╝  ██╔══██╗██║╚██╔╝██║██╔══╝  ╚════██║╚════╝██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║
██║  ██║███████╗██║  ██║██║ ╚═╝ ██║███████╗███████║      ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║
╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝      ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝

╭───────────────────────────────────────────────── Hermes Agent v0.11.0 (2026.4.23) · upstream cec0af02 ──────────────────────────────────────────────────╮
│                                   Available Tools                                                                                                       │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⡀⠀⣀⣀⠀⢀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   browser: browser_back, browser_click, ...                                                                             │
│  ⠀⠀⠀⠀⠀⠀⢀⣠⣴⣾⣿⣿⣇⠸⣿⣿⠇⣸⣿⣿⣷⣦⣄⡀⠀⠀⠀⠀⠀⠀   browser-cdp: browser_cdp, browser_dialog                                                                              │
│  ⠀⢀⣠⣴⣶⠿⠋⣩⡿⣿⡿⠻⣿⡇⢠⡄⢸⣿⠟⢿⣿⢿⣍⠙⠿⣶⣦⣄⡀⠀   clarify: clarify                                                                                                      │
│  ⠀⠀⠉⠉⠁⠶⠟⠋⠀⠉⠀⢀⣈⣁⡈⢁⣈⣁⡀⠀⠉⠀⠙⠻⠶⠈⠉⠉⠀⠀   code_execution: execute_code                                                                                          │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣴⣿⡿⠛⢁⡈⠛⢿⣿⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   cronjob: cronjob                                                                                                      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠿⣿⣦⣤⣈⠁⢠⣴⣿⠿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   delegation: delegate_task                                                                                             │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠻⢿⣿⣦⡉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   file: patch, read_file, search_files, write_file                                                                      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⢷⣦⣈⠛⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   homeassistant: ha_call_service, ha_get_state, ...                                                                     │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣴⠦⠈⠙⠿⣦⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   (and 13 more toolsets...)                                                                                             │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣤⡈⠁⢤⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀                                                                                                                         │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠷⠄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   Available Skills                                                                                                      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⠑⢶⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   autonomous-ai-agents: claude-code, codex, hermes-agent, opencode                                                      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⠁⢰⡆⠈⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   creative: architecture-diagram, ascii-art, ascii-video, b...                                                          │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠳⠈⣡⠞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   data-science: jupyter-live-kernel                                                                                     │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀   devops: webhook-subscriptions                                                                                         │
│                                   email: himalaya                                                                                                       │
│  claude-opus-4.6 · Nous Research  gaming: minecraft-modpack-server, pokemon-player                                                                      │
│           /home/hermes            general: dogfood                                                                                                      │
│  Session: 20260426_122841_3977f3  github: codebase-inspection, github-auth, github-code-r...                                                            │
│                                   mcp: native-mcp                                                                                                       │
│                                   media: gif-search, heartmula, songsee, spotify, youtub...                                                             │
│                                   mlops: audiocraft-audio-generation, axolotl, dspy, eva...                                                             │
│                                   note-taking: obsidian                                                                                                 │
│                                   productivity: google-workspace, linear, maps, nano-pdf, notio...                                                      │
│                                   red-teaming: godmode                                                                                                  │
│                                   research: arxiv, blogwatcher, llm-wiki, polymarket, resea...                                                          │
│                                   smart-home: openhue                                                                                                   │
│                                   social-media: xurl                                                                                                    │
│                                   software-development: plan, requesting-code-review, subagent-driven-d...                                              │
│                                                                                                                                                         │
│                                   22 tools · 70 skills · /help for commands                                                                             │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Welcome to Hermes Agent! Type your message or /help for commands.
✦ Tip: The API server supports both Chat Completions and Responses API with server-side state.

  ⚠ tirith security scanner enabled but not available — command scanning will use pattern matching only
 ⚕ claude-opus-4.6 │ ctx -- │ [░░░░░░░░░░] -- │ 1m │ ⏲ 0s 
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
❯                                                                                                                                                          
                                                                                                                                                           
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────