Kali Linux 2026 里安装 Hermes Agent（NousResearch/hermes-agent） 的完整步骤，含国内加速、依赖处理、初始化与常见坑。
1. 准备环境（Kali 2026）
Kali 基于 Debian，先更新并安装基础工具：
bash
运行
sudo apt update
sudo apt upgrade -y
sudo apt install -y git curl wget检查依赖
Hermes 会自动装 Python 3.11、Node.js 22、ripgrep、ffmpeg 等，你只需保证 git 可用：
bash
运行
git --version2. 一键安装（国内推荐加速镜像）
官方脚本（国外，可能慢 / 超时）：
bash
运行
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash国内加速（推荐，速度快、成功率高）：
bash
运行
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash- 脚本会自动：
- 安装 Python 3.11（用 uv，不冲突系统 Python）
- 安装 Node.js 22
- 克隆代码、创建虚拟环境
- 注册全局
hermes命令
- 全程等待，约 3--5 分钟。
3. 生效环境变量并验证
bash
运行
source ~/.bashrc
hermes --version输出版本号（如 v0.13.0）即成功。
4. 初始化配置（必做）
bash
运行
hermes init交互式向导：
- 选择模型提供商（推荐 OpenRouter 或 DeepSeek）
- 输入对应 API Key
- 选默认模型
- 确认权限→完成
配置文件路径：~/.hermes/config.yaml、~/.hermes/.env
5. 启动 Hermes
bash
运行
hermes start看到 Hermes Agent is running 即正常运行。
6. 常用命令
bash
运行
hermes init # 重新配置
hermes start # 启动服务
hermes stop # 停止服务
hermes restart # 重启
hermes gateway setup # 配置微信/QQ 通道7. 常见问题（Kali 特有）
问题 1：curl: (7) Failed to connect
- 换国内加速脚本（见上文）
- 或配置代理：
export ALL_PROXY=socks5://127.0.0.1:端口
问题 2：Node.js 安装失败
bash
运行
sudo apt install -y ca-certificates
sudo update-ca-certificates问题 3：端口 8080 被占
bash
运行
sudo lsof -i:8080
# 杀掉占用进程或改 Hermes 端口：
hermes config set server.port 8081问题 4：权限 / 路径错误
bash
运行
chmod -R 755 ~/.hermes8. 手动安装（备选，适合排错）
bash
运行
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# 后续按提示装依赖、建虚拟环境、链接命令----------------------------------------完整安装过程代码-----------------------------------------------------------
┌──(root㉿Kali2026)-\~
└─# git --version
git version 2.53.0
┌──(root㉿Kali2026)-\~
└─# curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
┌─────────────────────────────────────────────────────────┐
│ ⚕ Hermes Agent Installer │
├─────────────────────────────────────────────────────────┤
│ An open source AI agent by Nous Research. │
└─────────────────────────────────────────────────────────┘
✓ Detected: linux (kali)
→ Root install on Linux --- using FHS layout
→ Code: /usr/local/lib/hermes-agent
→ Command: /usr/local/bin/hermes
→ Data: /root/.hermes (unchanged)
→ Checking for uv package manager...
→ Installing uv (fast Python package manager)...
✓ uv installed (uv 0.11.16 (x86_64-unknown-linux-gnu))
→ Checking Python 3.11...
→ Python 3.11 not found, installing via uv...
Installed Python 3.11.15 in 11.63s
- 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 installed: Python 3.11.15
→ Checking Git...
✓ Git 2.53.0 found
→ Checking Node.js (for browser tools)...
✓ Node.js v22.22.2 found
→ Checking internet connectivity for package install and web tools...
✓ Internet connectivity looks good
→ Checking ripgrep (fast file search)...
→ Checking ffmpeg (TTS voice messages)...
⚠ ripgrep not installed (file search will use grep fallback)
→ To install ripgrep manually:
→ Use your package manager or visit the project homepage
⚠ ffmpeg not installed (TTS voice messages will be limited)
→ To install ffmpeg manually:
→ Use your package manager or visit the project homepage
→ Installing to /usr/local/lib/hermes-agent...
→ Trying SSH clone...
→ SSH failed, trying HTTPS...
Cloning into '/usr/local/lib/hermes-agent'...
remote: Enumerating objects: 91210, done.
remote: Counting objects: 100% (78/78), done.
remote: Compressing objects: 100% (53/53), done.
remote: Total 91210 (delta 38), reused 25 (delta 25), pack-reused 91132 (from 2)
Receiving objects: 100% (91210/91210), 228.41 MiB | 298.00 KiB/s, done.
Resolving deltas: 100% (63147/63147), done.
✓ Cloned via HTTPS
✓ Repository ready
→ Creating virtual environment with Python 3.11...
Using CPython 3.11.15
Creating virtual environment at: venv
Activate with: source venv/bin/activate
✓ Virtual environment ready (Python 3.11)
→ Installing dependencies...
→ Trying tier: hash-verified (uv.lock) ...
→ (this resolves + downloads the curated all set --- first run on a
→ fresh venv can take 1-5 minutes; uv prints progress below)
Resolved 215 packages in 2ms
Built hermes-agent @ file:///usr/local/lib/hermes-agent
Prepared 100 packages in 3m 52s
Installed 100 packages in 73ms
-
agent-client-protocol==0.9.0
-
aiohappyeyeballs==2.6.1
-
aiohttp==3.13.3
-
aiosignal==1.4.0
-
annotated-doc==0.0.4
-
annotated-types==0.7.0
-
anyio==4.12.1
-
attrs==25.4.0
-
certifi==2026.2.25
-
cffi==2.0.0
-
charset-normalizer==3.4.4
-
click==8.3.1
-
croniter==6.0.0
-
cryptography==46.0.7
-
debugpy==1.8.20
-
defusedxml==0.7.1
-
distro==1.9.0
-
fastapi==0.133.1
-
fire==0.7.1
-
frozenlist==1.8.0
-
google-api-core==2.30.3
-
google-api-python-client==2.194.0
-
google-auth==2.49.2
-
google-auth-httplib2==0.3.1
-
google-auth-oauthlib==1.3.1
-
googleapis-common-protos==1.73.0
-
h11==0.16.0
-
hermes-agent==0.14.0 (from file:///usr/local/lib/hermes-agent)
-
httpcore==1.0.9
-
httplib2==0.31.2
-
httptools==0.7.1
-
httpx==0.28.1
-
httpx-sse==0.4.3
-
idna==3.15
-
iniconfig==2.3.0
-
jinja2==3.1.6
-
jiter==0.13.0
-
jsonschema==4.26.0
-
jsonschema-specifications==2025.9.1
-
markdown-it-py==4.0.0
-
markupsafe==3.0.3
-
mcp==1.26.0
-
mdurl==0.1.2
-
multidict==6.7.1
-
oauthlib==3.3.1
-
openai==2.24.0
-
packaging==26.0
-
pluggy==1.6.0
-
prompt-toolkit==3.0.52
-
propcache==0.4.1
-
proto-plus==1.27.2
-
protobuf==6.33.5
-
psutil==7.2.2
-
ptyprocess==0.7.0
-
pyasn1==0.6.3
-
pyasn1-modules==0.4.2
-
pycparser==3.0
-
pydantic==2.13.4
-
pydantic-core==2.46.4
-
pydantic-settings==2.13.1
-
pygments==2.19.2
-
pyjwt==2.12.1
-
pyparsing==3.3.2
-
pytest==9.0.2
-
pytest-asyncio==1.3.0
-
pytest-timeout==2.4.0
-
python-dateutil==2.9.0.post0
-
python-dotenv==1.2.2
-
python-multipart==0.0.27
-
pytz==2025.2
-
pyyaml==6.0.3
-
referencing==0.37.0
-
requests==2.33.0
-
requests-oauthlib==2.0.0
-
rich==14.3.3
-
rpds-py==0.30.0
-
ruamel-yaml==0.18.17
-
ruamel-yaml-clib==0.2.15
-
ruff==0.15.10
-
simple-term-menu==1.6.6
-
six==1.17.0
-
sniffio==1.3.1
-
socksio==1.0.0
-
sse-starlette==3.3.2
-
starlette==0.52.1
-
tenacity==9.1.4
-
termcolor==3.3.0
-
tqdm==4.67.3
-
ty==0.0.21
-
typing-extensions==4.15.0
-
typing-inspection==0.4.2
-
uritemplate==4.2.0
-
urllib3==2.6.3
-
uvicorn==0.41.0
-
uvloop==0.22.1
-
watchfiles==1.1.1
-
wcwidth==0.6.0
-
websockets==15.0.1
-
yarl==1.22.0
-
youtube-transcript-api==1.2.4
✓ Main package installed (hash-verified via uv.lock)
✓ All dependencies installed
→ Installing Node.js dependencies (browser tools)...
✅ Browser tools ready. Run: python run_agent.py --help
✓ Node.js dependencies installed
→ Installing browser engine (Playwright Chromium)...
✓ Found system Chrome/Chromium at /usr/bin/chromium
→ Skipping Playwright browser download; Hermes will use the system browser.
✓ Browser engine setup complete
→ Installing TUI dependencies...
⠏⠉ ⠉⢹
██╗ ██╗███╗ ██╗██╗ ██████╗ ██████╗ ██████╗ ███████╗
██║ ██║████╗ ██║██║██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║ ██║██╔██╗ ██║██║██║ ██║ ██║██║ ██║█████╗
██║ ██║██║╚██╗██║██║██║ ██║ ██║██║ ██║██╔══╝
╚██████╔╝██║ ╚████║██║╚██████╗╚██████╔╝██████╔╝███████╗
╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
BRAILLE ANIMATIONS
⠧⠀ braille ⠀⠀⢸⡇ scan ⠂⠌⡠⠐ rain
⣀⠀ orbit ⢾⣉⡷⠀ pulse ⠊⡰⡡⡘ sparkle
⡑⠀ breathe ⠀⢀⡴⠋ cascade ⠙⠢⣄⣠ waverows
⠀⠛ snake ⣿⡇⠀⠀ columns ⣉⡱⣉⡱ helix
⣿⣿ fillsweep ⠓⠓⠓⠀ scanline ⠠⠐⠈⠁ braillewave
⣿⡿ diagswipe ⡪⡪⡪⠀ checkerboard ⠉⠙⠚⠒ dna
npx unicode-animations demo all spinners
npx unicode-animations --list list all spinners
npx unicode-animations --web open in browser
⣇⣀ ⣀⣸
✓ TUI dependencies installed
→ Setting up hermes command...
✓ Installed hermes launcher → /usr/local/bin/hermes
→ /usr/local/bin is already on PATH for all shells
✓ hermes command ready
→ Setting up configuration files...
✓ Created ~/.hermes/.env from template
✓ Configured browser tools to use /usr/bin/chromium
✓ Created ~/.hermes/config.yaml from template
✓ Created ~/.hermes/SOUL.md (edit to customize personality)
✓ Configuration directory ready: ~/.hermes/
→ Syncing bundled skills to ~/.hermes/skills/ ...
Syncing bundled skills into ~/.hermes/skills/ ...
-
plan
-
systematic-debugging
-
test-driven-development
-
requesting-code-review
-
spike
-
subagent-driven-development
-
writing-plans
-
python-debugpy
-
hermes-agent-skill-authoring
-
node-inspect-debugger
-
debugging-hermes-tui-commands
-
obsidian
-
github-code-review
-
github-pr-workflow
-
github-issues
-
github-repo-management
-
github-auth
-
codebase-inspection
-
hermes-agent
-
opencode
-
kanban-codex-lane
-
codex
-
claude-code
-
llm-wiki
-
arxiv
-
polymarket
-
research-paper-writing
-
blogwatcher
-
xurl
-
ascii-art
-
touchdesigner-mcp
-
manim-video
-
baoyu-article-illustrator
-
songwriting-and-ai-music
-
humanizer
-
architecture-diagram
-
excalidraw
-
ascii-video
-
comfyui
-
p5js
-
claude-design
-
popular-web-designs
-
baoyu-infographic
-
sketch
-
pretext
-
design-md
-
pixel-art
-
baoyu-comic
-
ideation
-
gif-search
-
heartmula
-
songsee
-
youtube-content
-
spotify
-
dogfood
-
kanban-worker
-
webhook-subscriptions
-
kanban-orchestrator
-
teams-meeting-pipeline
-
maps
-
airtable
-
google-workspace
-
ocr-and-documents
-
notion
-
nano-pdf
-
powerpoint
-
linear
-
jupyter-live-kernel
-
himalaya
-
openhue
-
godmode
-
native-mcp
-
yuanbao
-
apple-reminders
-
macos-computer-use
-
apple-notes
-
findmy
-
imessage
-
obliteratus
-
serving-llms-vllm
-
llama-cpp
-
dspy
-
huggingface-hub
-
weights-and-biases
-
evaluating-llms-harness
-
segment-anything-model
-
audiocraft-audio-generation
-
pokemon-player
-
minecraft-modpack-server
Done: 89 new, 0 updated, 0 unchanged. 89 total bundled.
✓ Skills synced to ~/.hermes/skills/
→ Starting setup wizard...
┌─────────────────────────────────────────────────────────┐
│ ⚕ Hermes Agent Setup Wizard │
├─────────────────────────────────────────────────────────┤
│ Let's configure your Hermes Agent installation. │
│ Press Ctrl+C at any time to exit. │
└─────────────────────────────────────────────────────────┘
Skipped (keeping current)
◆ Inference Provider
Choose how to connect to your main chat model.
Guide: https://hermes-agent.nousresearch.com/docs/integrations/providers
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
Custom OpenAI-compatible endpoint configuration:
API base URL e.g. https://api.example.com/v1: https://api.lkeap.cloud.tencent.com/plan/v3
API key optional:
Warning: could not verify this endpoint via https://api.lkeap.cloud.tencent.com/plan/v3/models. Hermes will still save it.
If this server expects /v1 in the path, try base URL: https://api.lkeap.cloud.tencent.com/plan/v3/v1
Select API compatibility mode:
- Auto-detect current
Use Hermes URL heuristics; best for standard OpenAI-compatible endpoints.
- Chat Completions
Use /chat/completions for standard OpenAI-compatible servers.
- Responses / Codex
Use /responses for Codex-compatible tool-calling backends.
- Anthropic Messages
Use /v1/messages for Anthropic-compatible endpoints.
Choice 1-4, Enter to keep current/detected: 2
API mode: chat_completions
Model name (e.g. gpt-4, llama-3-70b): GLM-5.1
Context length in tokens leave blank for auto-detect: 128000
Display name Api.lkeap.cloud.tencent.com:
Default model set to: GLM-5.1 (via https://api.lkeap.cloud.tencent.com/plan/v3)
💾 Saved to custom providers as "Api.lkeap.cloud.tencent.com" (edit in config.yaml)
◆ 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
Skipped (keeping current)
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.
✓ Setup complete! You're ready to go.
Configure all settings: hermes setup
Connect Telegram/Discord: hermes setup gateway
◆ Tool Availability Summary
6/10 tool categories available:
✓ Vision (image analysis)
✗ 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 (Local 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
┌─────────────────────────────────────────────────────────┐
│ ✓ Installation Complete! │
└─────────────────────────────────────────────────────────┘
📁 Your files:
Config: /root/.hermes/config.yaml
API Keys: /root/.hermes/.env
Data: /root/.hermes/cron/, sessions/, logs/
Code: /usr/local/lib/hermes-agent
─────────────────────────────────────────────────────────
🚀 Commands:
hermes Start chatting
hermes setup Configure API keys & settings
hermes config View/edit configuration
hermes config edit Open config in editor
hermes gateway install Install gateway service (messaging + cron)
hermes update Update to latest version
─────────────────────────────────────────────────────────
⚡ 'hermes' was linked into /usr/local/bin and is ready to use --- no shell reload needed.
Note: ripgrep (rg) was not found. File search will use
grep as a fallback. For faster search in large codebases,
install ripgrep: sudo apt install ripgrep (or brew install ripgrep)