把 Hermes 跑起来——安装、看懂 config.yaml、接入任意 LLM 模型。
安装器自动处理：uv、Python 3.11、Node.js、ripgrep、ffmpeg、便携 Git Bash（MinGit，解压到 %LOCALAPPDATA%\hermes\git，无需管理员权限，与系统 Git 完全隔离）。若已有 Git 则自动复用。
官方验证路径见 Termux 安装指南。注意：Termux 下安装的是精简版（.[termux] extras），完整版因 Android 音频依赖问题暂不可用。
source ~/.bashrc（或 ~/.zshrc）重新加载 shell，然后直接 hermes 开始使用。| 步骤 | 问什么 | 你做什么 |
|---|---|---|
| 1 | 选 Provider | 从列表选：OpenRouter / Nous Portal / Anthropic / OpenAI / DeepSeek / NovitaAI / NVIDIA NIM / … |
| 2 | 输入 API Key | 粘贴 Key，自动写入 .env |
| 3 | 选模型 | 从 Provider 的模型列表中选默认模型 |
| 4 | 终端后端 | local / docker / ssh / modal / daytona / singularity——默认 local |
| 5 | 平台接入（可选） | 配 Telegram/Discord/Slack/飞书等，跳过即纯终端模式 |
| 段 | 作用 | 关键字段 |
|---|---|---|
| model | 模型配置（必填） | default, provider, base_url, context_length |
| agent | Agent 行为 | max_turns(90), tool_use_enforcement |
| terminal | 终端后端 v0.17 | backend(local/docker/ssh/singularity/modal/daytona), timeout |
| compression | 上下文压缩 | threshold(0.50), target_ratio(0.20) |
| memory | 持久记忆 | memory_enabled, user_profile_enabled, provider |
| approvals | 命令审批 | mode(manual/smart/off) |
| delegation | 子代理 | model, max_iterations |
| curator v0.17 | Skill 自动维护 | enabled, interval_hours, stale_after_days |
| checkpoints | 文件快照 | enabled, max_snapshots |
/restart，终端退出重进。System Prompt 在会话启动时构建，改配置不会热加载。密钥放 .env，不入 git。环境变量优先级高于 config.yaml 中的 api_key 字段。
| Provider | 认证 | 环境变量 | 说明 |
|---|---|---|---|
| Nous Portal v0.17 新增 | OAuth | hermes setup --portal | 300+ 模型 + 工具网关一条龙 |
| OpenRouter | API Key | OPENROUTER_API_KEY | 200+ 模型聚合 ⭐推荐 |
| NovitaAI v0.17 新增 | API Key | NOVITA_API_KEY | AI 原生云：模型 API + Agent Sandbox + GPU Cloud |
| NVIDIA NIM v0.17 新增 | API Key | NVIDIA_API_KEY | Nemotron 系列 |
| Anthropic | API Key | ANTHROPIC_API_KEY | Claude 系列 |
| OpenAI | API Key | OPENAI_API_KEY | GPT-4o / o1 / o3 |
| DeepSeek | API Key | DEEPSEEK_API_KEY | 高性价比 |
| Google Gemini | API Key | GEMINI_API_KEY | Gemini 系列 |
| Xiaomi MiMo v0.17 新增 | API Key | XIAOMI_API_KEY | 小米 MiMo |
| Z.AI / GLM v0.17 新增 | API Key | GLM_API_KEY | 智谱 GLM |
| Kimi / Moonshot | API Key | KIMI_API_KEY | 月之暗面 |
| MiniMax | API Key | MINIMAX_API_KEY | MiniMax |
| Hugging Face | Token | HF_TOKEN | HF 推理端点 |
| Custom | 自定义 | 设 base_url | 任意 OpenAI 兼容端点 |
如果你不想分别申请 5 个 API Key（模型、搜索、生图、TTS、浏览器），Nous Portal 一个订阅全包：
/model 任意切换你仍然可以随时用自己的 Key 逐工具配置——网关是按后端可选的，不是全有或全无。
| 后端 | 适用场景 | 配置 |
|---|---|---|
| local（默认） | 本机运行 | 开箱即用 |
| docker | 容器隔离 | terminal.backend: docker |
| ssh | 远程执行 | 配 SSH 连接信息 |
| singularity v0.17 | HPC 集群 | 配镜像路径 |
| modal v0.17 | Serverless，休眠不计费 | 配 Modal token |
| daytona v0.17 | Serverless 开发环境 | 配 Daytona 凭证 |
anthropic/claude-sonnet-4（通过 OpenRouter）
deepseek/deepseek-chat
DeepSeek / Z.AI(智谱) / Kimi / MiniMax
Ollama / vLLM + Custom Provider
| 现象 | 解决 |
|---|---|
command not found | source ~/.bashrc，确认 ~/.local/bin 在 PATH |
| 401/403 | 检查 .env 中 API Key |
| 429 Rate Limit | 等几分钟，或加第二个 Key 到凭证池 |
| 工具不出现 | hermes tools 启用 → /reset |