核心速览推荐使用一键安装脚本最快最稳按系统选择对应命令Linux/macOS/WSL2 用curlWindows 原生用 PowerShellAndroid(Termux)同 Linux 命令。安装后执行hermes setup配置模型hermes启动聊天全程约 3-5 分钟。给国内小伙伴的专属避坑提醒安装的时候一定要用中文社区的镜像源不然很容易因为网络慢、连不上导致安装失败用镜像源速度能快好几倍一次就能装成功 大模型优选 Kimi 就对了不用折腾特殊网络打开就能用200 万字的超长上下文不管是长文档、论文还是代码库直接拖进去就能解析免费额度够日常用中文理解也特别准工作学习的大部分需求都能满足。一、系统要求与准备支持平台Linux、macOS、Windows(WSL2 推荐)、Android(Termux)网络能访问 GitHub 和模型 APIKimi/Nous Portal/OpenRouter/OpenAI 等无需预装Python、Node.js、Git 等依赖由安装脚本自动处理推荐配置Windows 用户优先用 WSL2原生 Windows 为早期 Beta 版ermes 支持市面上绝大多数主流大模型服务你可以根据自己的使用需求、预算和网络情况选择合适的平台。以下是综合体验推荐指数国内用户大模型推荐Kimi国内优选无需特殊网络访问速度快200 万字超长上下文支持文档解析免费额度充足智谱 AI / z.ai性价比高中文理解和生成能力优秀通义千问阿里云生态集成好功能全面阿里云用户海外用户大模型推荐Nous Portal官方原生支持集成度高体验流畅OpenRouter模型全支持一键切换上百种大模型灵活度高OpenAI能力全面生态完善适合各类通用场景Anthropic长文处理王者上下文窗口大安全性高Google Gemini多模态技术领跑全球可用免费额度友好本地模型Ollama/vLLM完全隐私保护无需联网即可使用永久免费二、各平台一键安装推荐Linux/macOS/WSL2最稳定打开终端执行官方一键安装命令curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash国内用户可选镜像加速curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash安装完成后重新加载 Shell 配置source ~/.bashrc # 或 source ~/.zshrcZsh用户验证安装hermes --version # 应显示版本号如 v0.13.0Windows两种方案方案一WSL2推荐以管理员身份打开 PowerShell安装 WSL2wsl --install- 重启电脑后打开Ubuntu终端执行Linux一键安装命令同上 - 方案二原生Windows早期Beta - 打开PowerShell无需管理员执行 powershell iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)- 国内镜像加速 powershellirm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex#### AndroidTermux - 安装Termux应用Google Play或F-Droid - 打开Termux执行Linux一键安装命令 bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash三、手动安装适合开发者克隆仓库含子模块git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent安装 uv 包管理器推荐pip install uv uv venv source .venv/bin/activate # Linux/macOS # Windows: .venv\Scripts\activate安装依赖uv pip install -e .[all]配置环境变量echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc四、初始化配置关键步骤启动交互式配置向导hermes setup选择模型接入方式四选一Kimi输入 API 密钥国内用户优选网络稳定处理能力强Nous Portal通过 OAuth 登录适合新手OpenRouter输入 API 密钥模型选择多本地部署选择 Ollama完全离线使用按提示完成配置设置默认模型和工具权限五、启动与使用启动 Hermes Agenthermes基本命令hermes model切换模型hermes update更新到最新版本hermes doctor检查环境和配置问题hermes help查看所有命令六、常见问题与解决网络问题国内用户建议用镜像安装脚本配置代理或使用国内镜像源加速依赖下载权限问题安装脚本无需 sudo 权限自动安装到用户目录若提示权限不足检查目录权限或重新启动终端Windows 原生问题建议改用 WSL2 方案获得更稳定体验安装失败可尝试更新 PowerShell 或重启电脑模型配置问题确保 API 密钥有效且余额充足本地部署需先安装 Ollama 并下载模型七、升级与卸载升级hermes update # 自动更新 # 或手动更新 cd ~/.hermes/hermes-agent git pull uv pip install -e .[all]卸载rm -rf ~/.hermes ~/.local/bin/hermes # Windows原生删除 %LOCALAPPDATA%\hermes 目录八、总结Hermes Agent 提供了极简的安装体验主流操作系统平台均可通过单行命令完成部署。安装完成后用户只需跟随内置的配置向导完成大模型接入设置即可启用这款具备持续学习能力的 AI 智能体。针对国内用户我们强烈建议使用中文社区提供的镜像源进行安装以显著提升下载速度和稳定性。Windows 平台用户推荐优先采用 WSL2 环境部署以获得与 Linux 原生环境一致的最佳运行体验。在大模型选型方面国内用户可优先考虑 Kimi 大模型。它在中文场景下具备独特优势无需额外网络配置即可直接访问对中文语境的理解更为精准自然同时拥有业界领跑的长文本处理能力支持一次性处理海量文档和复杂任务在代码生成、工具调用及长程任务执行方面表现优秀能够与 Hermes Agent 的智能体特性深度契合助力用户高效完成各类自动化工作。
