hermes agent v0.19.1可在10分钟内跑起来：一行命令安装（curl -fssl脚本）、source重载环境变量、hermes setup选quick模式自动配置、hermes doctor验证model/memory/tools三项全绿即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手想在10分钟内让Hermes Agent v0.19.1跑起来，核心是跳过手动编辑配置文件、绕开环境变量路径陷阱、避开国内API直连失败——直接用官方向导生成合规配置，再用诊断命令确认模型连通性。
一行命令完成安装与环境加载
先确保终端能执行bash脚本：macOS/Linux用户打开Terminal，Windows用户需启用WSL2并启动Ubuntu终端。这一步不能跳，【原生Windows不支持，硬装会报ModuleNotFoundError】。
粘贴执行安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后立即加载新环境变量：source ~/.zshrc（macOS）或source ~/.bashrc（Linux/WSL2）。若提示“command not found: hermes”，说明环境变量没生效，必须重跑这行命令。
用quick模式启动交互式配置向导
向导是新手唯一推荐的配置方式，它自动校验缩进、跳过非法字符、屏蔽未启用平台选项，比手写YAML安全十倍。
第一步：在终端输入hermes setup并回车；
第二步：当出现“Select setup mode”时，键盘输入quick后按回车；
第三步：从列表中选模型提供商（国内用户优先选Kimi或OpenRouter），向导会自动匹配对应密钥字段名；
第四步：粘贴你的API Key——终端不会显示任何字符，这是正常的安全机制，别误以为没输进去；
第五步：从模型列表里选一个带中文优化标识的默认模型，比如kimi/kimi-plus或anthropic/claude-3.5-sonnet，选错会导致后续中文响应乱码。
验证模型是否真正可用
向导结束不代表模型已就绪，很多新手卡在这一步：配置文件生成了，但模型注册表没刷新。
执行诊断命令：hermes doctor
重点盯住三行输出：Model: connected、Memory: initialized、Tools: enabled——只要其中任意一项不是绿色“✓”，就说明配置没生效。
如果Model: connected显示红色“✗”，立刻检查~/.hermes/.env里密钥是否被意外换行截断，【密钥末尾多一个空格或换行符都会导致认证失败】。
