速览推荐一键安装Linux/macOS/WSL2用curl脚本Windows用PowerShell脚本中国大陆用户优先用国内镜像源安装后通过hermes setup配置模型与API国内用户注意推荐搭配 Kimi 大模型使用无需特殊网络中文理解和智能体任务表现出色最后hermes启动即可。一、准备工作必看系统要求Windows102004/11推荐WSL2长期稳定也支持原生PowerShellLinuxUbuntu 20.04、Debian 11、Fedora 36、Arch等主流发行版macOS11Big Sur及以上支持Intel/Apple SiliconAndroidTermux需开启存储权限网络与权限建议科学上网国际版或用国内镜像源推荐Linux/macOS无需sudo脚本自动安装到用户目录WindowsPowerShell建议管理员权限避免路径限制账号准备可选国内用户大模型推荐Kimi国内优选无需特殊网络访问速度快200万字超长上下文支持文档解析免费额度充足智谱 AI / z.ai性价比高中文理解和生成能力优秀通义千问阿里云生态集成好功能全面阿里云用户海外用户大模型推荐Nous Portal官方原生支持集成度高体验流畅OpenRouter模型全支持一键切换上百种大模型灵活度高OpenAI能力全面生态完善适合各类通用场景Anthropic长文处理王者上下文窗口大安全性高Google Gemini多模态技术领跑全球可用免费额度友好本地模型Ollama/vLLM完全隐私保护无需联网即可使用永久免费二、各平台一键安装推荐1. 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自动完成安装uv包管理器、Python 3.11、克隆仓库、配置环境变量安装后执行source \~/\.bashrcbash或source \~/\.zshrczsh刷新环境变量2. Windows原生PowerShell# 国际官方源 iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1) # 国内镜像源推荐 irm https://res1.hermesagent.org.cn/install.ps1 | iex安装路径%LOCALAPPDATA%\\hermes自动配置便携Git Bash无需额外安装Python脚本自带依赖3. AndroidTermux安装TermuxGoogle Play或F-Droid下载执行Linux同款命令curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash自动适配Termux环境安装完成后直接输入hermes启动三、手动安装适合开发者/高级用户克隆仓库含子模块git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 若已克隆未拉取子模块git submodule update --init --recursive安装uv包管理器curl -LsSf https://astral.sh/uv/install.sh | sh创建并激活虚拟环境uv venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows安装依赖并配置uv pip install -e . hermes setup # 交互式配置向导四、配置与启动关键步骤基础配置# 方式1交互式向导推荐新手 hermes setup # 方式2直接选择模型 hermes model配置选项选择模型Kimi输入API密钥国内用户优选网络稳定处理能力强Nous Portal通过OAuth登录适合新手OpenRouter输入API密钥模型选择多本地部署选择Ollama完全离线使用输入API密钥、设置消息通道本地推理配置无需API# 安装Ollama先安装Ollama客户端 ollama pull nous-hermes2 hermes model --local ollama:nous-hermes2启动Hermes Agent# 启动聊天界面 hermes # 后台运行Linux/macOS hermes start # 停止后台服务 hermes stop成功启动会显示Hermes欢迎界面即可开始对话五、常见问题与解决方法安装失败网络问题切换国内镜像源或检查网络连接权限不足Linux/macOS不要加sudoWindows用管理员PowerShell依赖缺失手动安装git、curl等基础工具Linuxsudo apt install git curl命令未找到执行source \~/\.bashrc或source \~/\.zshrc刷新环境变量Windows重启PowerShell或手动添加%LOCALAPPDATA%\\hermes\\bin到系统PATH模型连接失败核对API密钥是否正确是否有足够额度本地Ollama确保服务已启动ollama serve模型已正确拉取更新Hermes Agenthermes update # 一键更新 # 或手动更新 cd ~/.hermes/hermes-agent git pull git submodule update --init --recursive uv pip install -e .六、结语Hermes Agent 以极致简化的部署体验和强大的智能体核心能力脱颖而出它支持 Windows、macOS、Linux 全主流操作系统通过单行命令一键完成安装无需繁琐的环境配置安装后跟随内置交互式配置向导即可快速接入大模型即刻拥有一款具备持续自主学习能力、能调用各类工具、执行复杂长程任务的智能工作伙伴针对国内用户使用中文社区专属镜像源可大幅提升下载速度与稳定性Windows 平台用户优先采用 WSL2 环境部署更能获得与 Linux 原生一致的流畅运行体验而在大模型选型上国内用户优选 Kimi 大模型堪称黄金搭档 —— 它无需额外网络配置即可直接访问对中文语境的理解精准自然更拥有业界领先的长文本处理能力在代码生成、多工具调用及复杂任务执行方面表现优异能与 Hermes Agent 的智能体特性深度契合全方位助力用户高效完成各类自动化工作。
