Hermes Agent 安装记录

初始安装

root@izwz9~]# curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

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

⚕ Hermes Agent 安装器 · 中国大陆镜像

由 Hermes Agent 中文社区提供加速

社区官网：https://hermesagent.org.cn

镜像脚本版本：2026.05.18-b83f7c1

最后更新：2026-05-18 09:07:41 CST

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

第 1 步 / 7：识别系统环境

✓ 已识别系统：linux (centos)

第 2 步 / 7：准备 Python 运行环境

→ 正在检查可用的系统 Python（>= 3.11）...

⚠ 未找到可用的系统 Python

→ 正在检查 uv 包管理器...

→ 正在安装 uv（优先镜像，失败后回退上游）...

→ 正在下载 uv 安装脚本：https://res1.hermesagent.org.cn/third-party/uv/install.sh

% Total % Received % Xferd Average Speed Time Time Time Current

Dload Upload Total Spent Left Speed

100 71233 100 71233 0 0 44977 0 0:00:01 0:00:01 --:--:-- 44970

installing to /root/.local/bin

uvx

everything's installed!

To add $HOME/.local/bin to your PATH, either restart your shell or run:

source $HOME/.local/bin/env (sh, bash, zsh)

source $HOME/.local/bin/env.fish (fish)

✓ uv 安装完成（uv 0.11.14 (x86_64-unknown-linux-gnu)）

→ 正在通过 uv 安装 Python 3.11...

Installed Python 3.11.15 in 5m 18s

cpython-3.11.15-linux-x86_64-gnu (python3.11)

warning: `/root/.local/bin` is not on your PATH. To use installed Python executables, run `export PATH="/root/.local/bin:$PATH"` or `uv python update-shell`.

✓ Python 安装完成：Python 3.11.15

第 3 步 / 7：检查基础工具

⚠ 未找到 ripgrep，将回退为 grep 搜索

→ 如需手动安装 ripgrep：

→ 请使用系统包管理器，或访问项目主页手动安装

⚠ 未找到 ffmpeg，语音 / 媒体功能会受限

→ 如需手动安装 ffmpeg：

→ 请使用系统包管理器，或访问项目主页手动安装

第 4 步 / 7：获取 Hermes 代码

→ 正在准备 Hermes 源码...

→ 正在尝试通过 CNB.cool / Git 镜像克隆：https://cnb.cool/hermesagent-cn/hermes-agent-cn-mirror.git

Cloning into '/root/.hermes/hermes-agent'...

remote: Enumerating objects: 96745, done.

remote: Counting objects: 100% (2913/2913), done.

remote: Compressing objects: 100% (1232/1232), done.

remote: Total 96745 (delta 1940), reused 2282 (delta 1657), pack-reused 93832 (from 1)

Receiving objects: 100% (96745/96745), 195.20 MiB | 1.16 MiB/s, done.

Resolving deltas: 100% (74070/74070), done.

✓ 源码已就绪（Git 镜像）

✓ 已修补 Hermes 配置向导：镜像安装时跳过自动启动聊天

第 5 步 / 7：创建独立运行环境

→ 正在创建虚拟环境...

✓ 虚拟环境已就绪（Python 3.11.15）

第 6 步 / 7：安装 Hermes 核心依赖

→ 正在安装 Python 依赖...

→ 正在尝试 pip 镜像：https://pypi.tuna.tsinghua.edu.cn/simple

→ 为提高安装速度与成功率，默认只安装 Hermes 核心依赖。

→ 浏览器、RL 训练等体积较大 / 不常用扩展默认跳过；如有需要可稍后手动补装。

→ 正在尝试 pip 镜像：https://pypi.tuna.tsinghua.edu.cn/simple

→ pip 仍在处理中（已等待 15 秒），请耐心稍候...

→ pip 仍在处理中（已等待 30 秒），请耐心稍候...

✓ Python 依赖安装完成

第 7 步 / 7：写入命令与配置文件

→ 默认跳过可选的 Node.js 组件

→ 正在设置 hermes 命令...

✓ 已创建命令链接 hermes → ~/.local/bin/hermes

✓ 已在 /root/.bashrc 中加入 ~/.local/bin

✓ 已在 /root/.bash_profile 中加入 ~/.local/bin

✓ 已在 /root/.profile 中加入 ~/.local/bin

✓ hermes 命令已就绪

→ 正在设置配置文件...

✓ 已创建 ~/.hermes/.env

✓ 已根据模板创建 ~/.hermes/config.yaml

✓ 已创建 ~/.hermes/SOUL.md

Syncing bundled skills into ~/.hermes/skills/ ...

audiocraft-audio-generation
segment-anything-model
weights-and-biases
evaluating-llms-harness
llama-cpp
serving-llms-vllm
obliteratus
dspy
huggingface-hub
plan
hermes-s6-container-supervision
spike
writing-plans
test-driven-development
subagent-driven-development
hermes-agent-skill-authoring
python-debugpy
debugging-hermes-tui-commands
requesting-code-review
systematic-debugging
node-inspect-debugger
obsidian
openhue
yuanbao
himalaya
heartmula
spotify
gif-search
songsee
youtube-content
ocr-and-documents
linear
teams-meeting-pipeline
google-workspace
airtable
notion
powerpoint
maps
nano-pdf
claude-code
opencode
codex
hermes-agent
kanban-codex-lane
native-mcp
godmode
kanban-orchestrator
kanban-worker
webhook-subscriptions
minecraft-modpack-server
pokemon-player
pixel-art
popular-web-designs
baoyu-infographic
ascii-video
pretext
sketch
baoyu-article-illustrator
p5js
claude-design
architecture-diagram
ascii-art
design-md
excalidraw
manim-video
ideation
touchdesigner-mcp
comfyui
humanizer
baoyu-comic
songwriting-and-ai-music
xurl
apple-reminders
imessage
apple-notes
macos-computer-use
findmy
dogfood
llm-wiki
blogwatcher
polymarket
research-paper-writing
arxiv
jupyter-live-kernel
github-code-review
codebase-inspection
github-auth
github-repo-management
github-issues
github-pr-workflow

Done: 90 new, 0 updated, 0 unchanged. 90 total bundled.

✓ 已同步技能到 ~/.hermes/skills/

✓ Hermes Agent 核心安装已经完成，接下来进入配置 Hermes Agent 环节。

→ Hermes Agent 中文社区：https://hermesagent.org.cn

→ 下一步的教程（胎教级别）：https://hermesagent.org.cn/docs/getting-started/setup-wizard

→ 正在启动配置向导...

┌─────────────────────────────────────────────────────────┐

│ ⚕ Hermes Agent Setup Wizard │

├─────────────────────────────────────────────────────────┤

│ Let's configure your Hermes Agent installation. │

│ Press Ctrl+C at any time to exit. │

└─────────────────────────────────────────────────────────┘

已跳过（保留当前设置）

◆ Inference Provider

Choose how to connect to your main chat model.

Guide: https://hermes-agent.nousresearch.com/docs/integrations/providers

^[[A^[[B

Warning: No inference provider configured. Run 'hermes model' to choose a provider and model, or set an API key (OPENROUTER_API_KEY, OPENAI_API_KEY, etc.) in ~/.hermes/.env. Falling back to auto provider detection.

Current model: anthropic/claude-opus-4.6

Active provider: none

Select provider:

→ 1. Nous Portal (Nous Research subscription)

OpenRouter (100+ models, pay-per-use)
NovitaAI (AI-native cloud: Model API, Agent Sandbox, GPU Cloud)
LM Studio (local desktop app with built-in model server)
Anthropic (Claude models --- API key or Claude Code)
OpenAI Codex
OpenAI API (api.openai.com, API key)
Qwen Cloud / DashScope Coding (Qwen + multi-provider)
xAI Grok OAuth (SuperGrok / Premium+)
Xiaomi MiMo (MiMo-V2.5 and V2 models --- pro, omni, flash)
Tencent TokenHub (Hy3 Preview --- direct API via tokenhub.tencentmaas.com)
NVIDIA NIM (Nemotron models --- build.nvidia.com or local NIM)
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 via OAuth browser login (Coding Plan, minimax.io)
MiniMax China (domestic direct API)
Ollama Cloud (cloud-hosted open models --- ollama.com)
Arcee AI (Trinity models --- direct API)
GMI Cloud (multi-model 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)
Qwen OAuth (reuses local Qwen CLI login)
Alibaba Cloud Coding Plan --- dedicated coding tier
custom (direct API)
Custom endpoint (enter URL manually)
Configure auxiliary models...
Leave unchanged

◆ Terminal Backend

Choose where Hermes runs shell commands and code.

This affects tool execution, file access, and isolation.

Guide: https://hermes-agent.nousresearch.com/docs/developer-guide/environments

已跳过（保留当前设置）

Keeping current backend: local

✓ Applied recommended defaults:

Max iterations: 90

Tool progress: all

Compression threshold: 0.50

Session reset: inactivity (1440 min) + daily (4:00)

Run `hermes setup agent` later to customize.

已跳过（保留当前设置）

◆ Messaging Platforms

Connect to messaging platforms to chat with Hermes from anywhere.

Toggle with Space, confirm with Enter.

No platforms selected. Run 'hermes setup gateway' later to configure.

✓ Setup complete! You're ready to go.

Configure all settings: hermes setup

◆ Tool Availability Summary

4/10 tool categories available:

✗ Vision (image analysis) (missing run 'hermes setup' to configure)

✗ Mixture of Agents (missing OPENROUTER_API_KEY)

✗ Web Search & Extract (missing EXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, TAVILY_API_KEY, or SEARXNG_URL)

✗ Browser Automation (missing npm install -g agent-browser)

✗ Image Generation (missing FAL_KEY or OPENAI_API_KEY)

✓ Text-to-Speech (Edge TTS)

✗ Skills Hub (GitHub) (missing GITHUB_TOKEN)

✓ Terminal/Commands

✓ Task Planning (todo)

✓ Skills (view, create, edit)

⚠ Some tools are disabled. Run 'hermes setup tools' to configure them,

⚠ or edit ~/.hermes/.env directly to add the missing API keys.

┌─────────────────────────────────────────────────────────┐

│ ✓ Setup Complete! │

└─────────────────────────────────────────────────────────┘

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

Settings: /root/.hermes/config.yaml

API Keys: /root/.hermes/.env

Data: /root/.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 /root/.hermes/config.yaml

nano /root/.hermes/.env

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

🚀 Ready to go!

hermes Start chatting

hermes gateway Start messaging gateway

hermes doctor Check for issues

┌─────────────────────────────────────────────────────────┐

│ ✓ 安装完成！ │

└─────────────────────────────────────────────────────────┘

📁 你的文件（都在 ~/.hermes/ 下）：

配置： ~/.hermes/config.yaml

密钥： ~/.hermes/.env

数据： ~/.hermes/cron/, sessions/, logs/

代码： ~/.hermes/hermes-agent/

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

🚀 常用命令：

hermes 开始聊天

hermes setup 配置 API Key 和设置

hermes config 查看 / 编辑配置

hermes gateway install 安装网关服务

⚡ 中国大陆镜像版默认跳过 Browser / Chromium 工具链。

如果你后续需要浏览器功能，请使用指令：cd ~/.hermes/hermes-agent && npm install 进行安装

装完后使用指令检查 hermes doctor

及 hermes tools list

⚡ WhatsApp 桥接未自动安装（上游依赖仍绑定 GitHub git 源）。

⚡ 当前默认只安装 Hermes 核心 Python 依赖。

如需完整扩展依赖，可稍后在仓库目录中执行：

./venv/bin/python -m pip install -e '. $all$ '

⚡ 请重新加载 shell 后再使用 'hermes' 命令：

source ~/.bashrc

继续

$root@izwz972p6q5ntdz \~$ # source ~/.bashrc

$root@izwz99kdyo2p6q5ntdz \~$ # hermes

Browser engine (Chromium, for web browsing tools) is not installed. Install now? $Y/n$

✓ Detected: linux (centos)

→ Checking Node.js (for browser tools)...

→ Node.js not found --- installing Node.js 22 LTS...

→ Downloading node-v22.22.3-linux-x64.tar.xz...

→ Extracting to ~/.hermes/node/...