Hermes

安装

1.1 使用官方脚本安装

安装程序会处理所有组件：uv、Python 3.11、Node.js、ripgrep、ffmpeg 以及一个便携式 Git Bash （MinGit，解压到 %LOCALAPPDATA%\hermes\git 目录——无需管理员权限，与任何系统 Git 安装完全隔离）。Hermes 使用此捆绑的 Git Bash 来运行 shell 命令。

bash

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

┌─────────────────────────────────────────────────────────┐
│             ⚕ Hermes Agent Installer                    │
├─────────────────────────────────────────────────────────┤
│  An open source AI agent by Nous Research.              │
└─────────────────────────────────────────────────────────┘

✓ Detected: linux (ubuntu)
→ Installing managed uv into /home/walleci/.hermes/bin ...
✓ Managed uv installed (uv 0.11.21 (x86_64-unknown-linux-gnu))
→ Checking Python 3.11...
→ Python 3.11 not found, installing via uv...
Installed Python 3.11.15 in 2m 13s
 + cpython-3.11.15-linux-x86_64-gnu (python3.11)
warning: `/home/walleci/.local/bin` is not on your PATH. To use installed Python executables, run `export PATH="/home/walleci/.local/bin:$PATH"` or `uv python update-shell`.
✓ Python installed: Python 3.11.15
→ Checking Git...
✓ Git 2.53.0 found
→ Checking Node.js (for browser tools)...
✓ Node.js v24.16.0 found
→ Checking internet connectivity for package install and web tools...
⚠ Could not reach https://duckduckgo.com/
⚠ Network checks failed. Hermes install may complete, but web search and dependency downloads can fail.
→ Verify internet/DNS and retry if pip install fails.
→ Checking ripgrep (fast file search)...
→ Checking ffmpeg (TTS voice messages)...
→ Installing ripgrep ffmpeg...
The following package was automatically installed and is no longer required:
  grub-pc-bin
Use 'sudo apt autoremove' to remove it.

Installing:
  ffmpeg  ripgrep
Installing dependencies:
  libaacs0       libbs2b0          ...
Summary:
  Upgrading: 0, Installing: 65, Removing: 0, Not Upgrading: 12
  Download size: 60.8 MB
  Space needed: 167 MB / 455 GB available
...
Processing triggers for libc-bin (2.43-2ubuntu2)…
✓ ripgrep installed
✓ ffmpeg installed
→ Installing to /home/walleci/.hermes/hermes-agent...
→ Trying SSH clone...
→ SSH failed, trying HTTPS...
Cloning into '/home/walleci/.hermes/hermes-agent'...
fatal: unable to access 'https://github.com/NousResearch/hermes-agent.git/': Failed to connect to github.com port 443 after 133269 ms: Could not connect to server
✗ Failed to clone repository

1.2.使用源码

bash

$ git clone https://gitee.com/liuyulu/hermes-agent.git
#进入hermes源码
$ ./setup-hermes.sh
⚕ Hermes Agent Setup

→ Checking for uv...
→ Installing uv...
✓ uv installed (uv 0.11.21 (x86_64-unknown-linux-gnu))
→ Checking Python 3.11...
✓ Python 3.11.15 found
→ Setting up virtual environment...
Using CPython 3.11.15
Creating virtual environment at: venv
Activate with: source venv/bin/activate
✓ venv created (Python 3.11)
→ Installing dependencies...
→ Using uv.lock for hash-verified installation...
→ (first run on a fresh venv can take 1-5 minutes; uv prints progress below)
Resolved 219 packages in 0.69ms
      Built hermes-agent @ file:///home/walleci/code/hermes-agent
Prepared 93 packages in 5m 46s
Installed 93 packages in 11ms
 + agent-client-protocol==0.9.0
...
 + youtube-transcript-api==1.2.4
✓ Dependencies installed (hash-verified via uv.lock)
→ Checking ripgrep (optional, for faster search)...
✓ ripgrep found
✓ Created .env from template
→ Setting up hermes command...
✓ Symlinked hermes → ~/.local/bin/hermes
✓ ~/.local/bin already in /home/walleci/.zshrc

Syncing bundled skills to ~/.hermes/skills/ ...
✓ Skills copied

✓ Setup complete!

Next steps:

  1. Reload your shell:
     source /home/walleci/.zshrc

  2. Run the setup wizard to configure API keys:
     hermes setup

  3. Start chatting:
     hermes

Other commands:
  hermes status        # Check configuration
  hermes gateway install # Install gateway service (messaging + cron)
  hermes cron list     # View scheduled jobs
  hermes doctor        # Diagnose issues

Would you like to run the setup wizard now? [Y/n] Y #运行安装向导

$ source ~/.bashrc

bash

# 安装开机自启（登录自动后台运行网关）
hermes gateway install

# 取消开机自启
hermes gateway uninstall

# 手动启动网关
hermes gateway start

端口


8642	Hermes Agent 网关

6060	hermes-studio

56121	api.x.ai 应用回调地址

Web UI


https://github.com/EKKOLearnAI/hermes-studio	8K
https://github.com/nesquena/hermes-webui	14.5K
https://github.com/fathah/hermes-desktop	12.3K
https://github.com/Eynzof/Hermes-CN-Desktop

npm config set registry https://registry.npmmirror.com
npm install -g hermes-web-ui
hermes-web-ui start

http://10.181.21.236:8648/

bash

#创建profile
hermes profile create coder --clone
hermes profile create writer --clone
#配置模型
coder model/
writer model
#配置soul
~/.hermes/profiles/<name>/SOUL.md
#配置skill

Hermes ​

安装 ​

1.1 使用官方脚本安装 ​

Web UI ​

Hermes

安装

1.1 使用官方脚本安装

Web UI