速览全平台支持一键部署Linux/macOS/WSL2 可使用 curl 脚本、Windows 适配 PowerShell 脚本中国大陆用户优先选用国内镜像源安装速度更快、运行更稳定。部署完成后通过hermes setup配置模型与 API 密钥国内环境优选** **Kimi 大模型无需特殊网络中文理解能力、长文本处理及智能体任务表现优异配置完成后执行hermes即可启动使用。重点核心Hermes Agent v0.8.0及以上版本原生支持KimiMoonshot大模型旧版本无Kimi选项本教程全程安装最新版国内无需特殊网络完美适配Kimi长文本、文档解析、中文智能体任务。本教程适配Windows、macOS、Linux、WSL2、Android Termux 全平台安全声明本文所有安装脚本为官方镜像正规文件可放心使用介意远程脚本执行的用户可选择文末手动安装方式。一、系统与环境前置准备必看1.1 系统支持要求WindowsWin102004、Win11推荐WSL2部署最稳定无报错macOSBig Sur 11.0适配Intel/Apple Silicon芯片LinuxUbuntu20.04、Debian11、Fedora36、Arch 主流发行版AndroidTermux 最新版本需开启存储权限1.2 网络与权限规范避坑核心国内用户优先使用国内镜像源无需国际网络可直接使用Kimi、智谱、通义千问海外模型OpenAI、Gemini、Anthropic需要具备国际网络访问能力Linux/macOS禁止使用sudo执行安装脚本自动安装至用户目录加权限会导致环境错乱WindowsPowerShell需管理员身份运行规避路径权限限制1.3 平台前置配置新手必做Windows 用户专属前置解决脚本运行报错Windows默认拦截远程脚本需提前放行管理员PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope Process输入Y确认仅当前会话生效安全无风险。WSL2 一键安装推荐管理员PowerShell执行重启电脑自动部署Ubuntu子系统wsl --install1.4 大模型选择与API密钥获取国内优选安全提醒API密钥为私密凭证禁止截图、分享、公开传播避免额度被盗刷。国内在线模型无特殊网络要求新手优选Kimi月之暗面/Moonshot【推荐】200万字超长上下文、中文最优、智能体任务适配完美免费额度充足使用成本低。登录Kimi网站获取API Key访问 https://platform.moonshot.cn/console 点击登录点击左侧的API Key管理创建API Key复制弹出的密钥字符密钥格式sk\-kimi\-xxxx海外在线模型需国际网络OpenAI、Anthropic、Google Gemini、OpenRouter、Nous Portal本地离线模型无网络、纯隐私基于Ollama部署完全离线运行推荐 nous-hermes2 专属模型内存≥8G可流畅运行二、全平台一键安装推荐新手所有脚本自动安装Python3.11、uv包管理器、源码、环境变量无需手动配置依赖2.1 Linux / macOS / WSL2最稳定国内镜像源优先使用速度最快curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash国际官方源海外用户使用curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装后必执行刷新环境变量# bash 用户 source ~/.bashrc # zsh 用户 source ~/.zshrc永久生效直接关闭当前终端重新打开新终端即可2.2 Windows 原生 PowerShell管理员身份运行统一管道格式无报错国内镜像源推荐irm https://res1.hermesagent.org.cn/install.ps1 | iex国际官方源irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex安装路径%LOCALAPPDATA%\\hermes安装完成重启PowerShell2.3 Android Termux先切换清华镜像源提升速度开启存储权限执行Linux同款命令curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash三、手动安装开发者/安装失败备用# 1. 克隆完整源码含子模块 git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 2. 安装uv包管理器 curl -LsSf https://astral.sh/uv/install.sh | sh # 3. 创建虚拟环境 uv venv # 4. 激活虚拟环境 source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows # 5. 安装核心依赖 uv pip install -e . # 6. 启动配置向导 hermes setup四、核心配置重点Kimi模型配置关键前置校验确保版本≥v0.8.0否则无Kimi选项hermes version # 查看版本 hermes update # 一键升级到最新版4.1 新手推荐交互式配置向导hermes setup按提示选择模型Moonshot/Kimi列表中MoonshotKimi为官方统一命名输入Kimi API密钥国内节点默认稳定直连。4.2 快速切换Kimi模型极简指令# 打开模型列表直接选择Kimi/Moonshot hermes model4.3 本地Ollama模型配置离线使用先安装 Ollama客户端启动后台服务ollama serve拉取Hermes专属模型并配置ollama pull nous-hermes2 hermes model --local ollama:nous-hermes2五、启动与常用指令# 1. 前台交互式聊天日常使用推荐 hermes # 2. 后台常驻服务服务器挂机使用 hermes start # 3. 停止后台服务 hermes stop # 4. 查看当前所有配置 hermes config show # 5. 模型管理 hermes model # 6. 一键更新版本 hermes update # 7. 卸载Hermes hermes uninstall六、高频踩坑问题汇总6.1 安装提示依赖缺失Linux/debian/ubuntu 执行sudo apt install git curl build-essential python3-venv6.2 终端提示 hermes: 未找到命令刷新环境变量或重启终端Windows手动添加%LOCALAPPDATA%\\hermes\\bin到系统PATH6.3 模型连接失败/401密钥错误核对API密钥是否正确、是否过期检查账号是否有可用额度国内用户优先选择kimi\-coding\-cn国内节点6.4 报错排查所有运行日志路径Linux/macOS\~/\.hermes/logs、Windows%LOCALAPPDATA%\\hermes\\logs七、补充说明国内镜像版默认跳过浏览器、WhatsApp桥接等海外依赖不影响核心AI对话、智能体任务使用如需完整扩展功能可进入源码目录执行uv pip install \-e \\#39;\.\[all\]\\#39;所有配置文件统一存放于\~/\.hermes/目录重装不会丢失自定义配置
国内可用！Hermes Agent 一键部署 + Kimi 完整配置教程
发布时间：2026/5/28 15:55:39
速览全平台支持一键部署Linux/macOS/WSL2 可使用 curl 脚本、Windows 适配 PowerShell 脚本中国大陆用户优先选用国内镜像源安装速度更快、运行更稳定。部署完成后通过hermes setup配置模型与 API 密钥国内环境优选** **Kimi 大模型无需特殊网络中文理解能力、长文本处理及智能体任务表现优异配置完成后执行hermes即可启动使用。重点核心Hermes Agent v0.8.0及以上版本原生支持KimiMoonshot大模型旧版本无Kimi选项本教程全程安装最新版国内无需特殊网络完美适配Kimi长文本、文档解析、中文智能体任务。本教程适配Windows、macOS、Linux、WSL2、Android Termux 全平台安全声明本文所有安装脚本为官方镜像正规文件可放心使用介意远程脚本执行的用户可选择文末手动安装方式。一、系统与环境前置准备必看1.1 系统支持要求WindowsWin102004、Win11推荐WSL2部署最稳定无报错macOSBig Sur 11.0适配Intel/Apple Silicon芯片LinuxUbuntu20.04、Debian11、Fedora36、Arch 主流发行版AndroidTermux 最新版本需开启存储权限1.2 网络与权限规范避坑核心国内用户优先使用国内镜像源无需国际网络可直接使用Kimi、智谱、通义千问海外模型OpenAI、Gemini、Anthropic需要具备国际网络访问能力Linux/macOS禁止使用sudo执行安装脚本自动安装至用户目录加权限会导致环境错乱WindowsPowerShell需管理员身份运行规避路径权限限制1.3 平台前置配置新手必做Windows 用户专属前置解决脚本运行报错Windows默认拦截远程脚本需提前放行管理员PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope Process输入Y确认仅当前会话生效安全无风险。WSL2 一键安装推荐管理员PowerShell执行重启电脑自动部署Ubuntu子系统wsl --install1.4 大模型选择与API密钥获取国内优选安全提醒API密钥为私密凭证禁止截图、分享、公开传播避免额度被盗刷。国内在线模型无特殊网络要求新手优选Kimi月之暗面/Moonshot【推荐】200万字超长上下文、中文最优、智能体任务适配完美免费额度充足使用成本低。登录Kimi网站获取API Key访问 https://platform.moonshot.cn/console 点击登录点击左侧的API Key管理创建API Key复制弹出的密钥字符密钥格式sk\-kimi\-xxxx海外在线模型需国际网络OpenAI、Anthropic、Google Gemini、OpenRouter、Nous Portal本地离线模型无网络、纯隐私基于Ollama部署完全离线运行推荐 nous-hermes2 专属模型内存≥8G可流畅运行二、全平台一键安装推荐新手所有脚本自动安装Python3.11、uv包管理器、源码、环境变量无需手动配置依赖2.1 Linux / macOS / WSL2最稳定国内镜像源优先使用速度最快curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash国际官方源海外用户使用curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装后必执行刷新环境变量# bash 用户 source ~/.bashrc # zsh 用户 source ~/.zshrc永久生效直接关闭当前终端重新打开新终端即可2.2 Windows 原生 PowerShell管理员身份运行统一管道格式无报错国内镜像源推荐irm https://res1.hermesagent.org.cn/install.ps1 | iex国际官方源irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex安装路径%LOCALAPPDATA%\\hermes安装完成重启PowerShell2.3 Android Termux先切换清华镜像源提升速度开启存储权限执行Linux同款命令curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash三、手动安装开发者/安装失败备用# 1. 克隆完整源码含子模块 git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 2. 安装uv包管理器 curl -LsSf https://astral.sh/uv/install.sh | sh # 3. 创建虚拟环境 uv venv # 4. 激活虚拟环境 source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows # 5. 安装核心依赖 uv pip install -e . # 6. 启动配置向导 hermes setup四、核心配置重点Kimi模型配置关键前置校验确保版本≥v0.8.0否则无Kimi选项hermes version # 查看版本 hermes update # 一键升级到最新版4.1 新手推荐交互式配置向导hermes setup按提示选择模型Moonshot/Kimi列表中MoonshotKimi为官方统一命名输入Kimi API密钥国内节点默认稳定直连。4.2 快速切换Kimi模型极简指令# 打开模型列表直接选择Kimi/Moonshot hermes model4.3 本地Ollama模型配置离线使用先安装 Ollama客户端启动后台服务ollama serve拉取Hermes专属模型并配置ollama pull nous-hermes2 hermes model --local ollama:nous-hermes2五、启动与常用指令# 1. 前台交互式聊天日常使用推荐 hermes # 2. 后台常驻服务服务器挂机使用 hermes start # 3. 停止后台服务 hermes stop # 4. 查看当前所有配置 hermes config show # 5. 模型管理 hermes model # 6. 一键更新版本 hermes update # 7. 卸载Hermes hermes uninstall六、高频踩坑问题汇总6.1 安装提示依赖缺失Linux/debian/ubuntu 执行sudo apt install git curl build-essential python3-venv6.2 终端提示 hermes: 未找到命令刷新环境变量或重启终端Windows手动添加%LOCALAPPDATA%\\hermes\\bin到系统PATH6.3 模型连接失败/401密钥错误核对API密钥是否正确、是否过期检查账号是否有可用额度国内用户优先选择kimi\-coding\-cn国内节点6.4 报错排查所有运行日志路径Linux/macOS\~/\.hermes/logs、Windows%LOCALAPPDATA%\\hermes\\logs七、补充说明国内镜像版默认跳过浏览器、WhatsApp桥接等海外依赖不影响核心AI对话、智能体任务使用如需完整扩展功能可进入源码目录执行uv pip install \-e \\#39;\.\[all\]\\#39;所有配置文件统一存放于\~/\.hermes/目录重装不会丢失自定义配置
相关文章
暖心通信赋能基层，服务守护奋斗身影
在咱们社区，快递员老王一直是最忙碌的人。每日穿梭在各个小区之间，步履匆匆、风雨无阻，手机铃声更是从早到晚响个不停，接单、通知取件、对接客户，早已成为他工作的日常。可前段时间，向来乐观麻利的老王&…
业财一体化 AI 基础平台：用智能技术打通企业业务与财务数字化底座
多数企业长期存在业务、财务数据割裂的问题：业务系统只管订单、合同、流程，财务系统只管记账、核算、报税，两套数据互不打通，靠人工对账、手工录入、线下汇总。不仅人力成本高、出错率大，还存在数据滞后、账目不符、风…
牵手西门子 Xcelerator，TDengine 加速进入全球工业数字化生态
近日，涛思数据正式成为西门子 Xcelerator 官方“繁星伙伴”，TDengine 成功上架西门子 Xcelerator 开放式数字商业平台（Marketplace）。同时，TDengine TSDB / IDMP 也已完成与西门子 IPC 工控机系列产品的适配࿰…
WechatDecrypt微信解密工具：三步轻松解密本地聊天记录
WechatDecrypt微信解密工具：三步轻松解密本地聊天记录 【免费下载链接】WechatDecrypt 微信消息解密工具 项目地址: https://gitcode.com/gh_mirrors/we/WechatDecrypt 在数字化时代，微信已成为我们日常沟通的主要工具，但你是否曾因无…
3分钟快速上手：如何在Blender中实现专业3D打印工作流
3分钟快速上手：如何在Blender中实现专业3D打印工作流 【免费下载链接】Blender3mfFormat Blender add-on to import/export 3MF files 项目地址: https://gitcode.com/gh_mirrors/bl/Blender3mfFormat 你是否曾经在Blender中精心设计的模型，在导出…
在 Node.js 后端服务中集成 Taotoken 实现稳定 AI 功能
🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度 在 Node.js 后端服务中集成 Taotoken 实现稳定 AI 功能 为产品添加 AI 能力已成为许多后端服务的标准需求。对于 Node.js 开发者而…
A2A与MCP协议：构建2025年AI智能体协作生态的技术基石
1. 项目概述：2025年的AI智能体协议格局如果你在2024年还在为如何让ChatGPT调用一个简单的API而写冗长的Function Calling提示词，或者为不同AI模型之间的“沟通障碍”而头疼，那么2025年的AI智能体世界可能会让你感到既兴奋又陌生。我们正站在一…
别再只跑MNIST了！用PyTorch和DCGAN从零生成你自己的动漫头像（附完整代码与数据集处理）
用PyTorch打造专属动漫头像生成器：从数据集处理到DCGAN实战第一次看到AI生成的动漫头像时，我正为一个独立游戏项目寻找美术资源。那些线条流畅、色彩鲜明的角色让我意识到——与其在素材网站大海捞针，不如训练一个懂我审美的生成模型。本文将…
别再只当提Bug的工具人！Bugzilla状态流转详解与高效协作实战（附流程图）
Bugzilla状态流转与团队协作实战指南在敏捷开发团队中，Bug跟踪系统如同项目的神经系统，承载着缺陷信息的传递与反馈。而Bugzilla作为开源缺陷跟踪系统的代表，其真正的价值往往被低估——许多团队仅仅将其视为记录Bug的"记事本"&…
大模型核心加速器：KV Cache 如何将 O(n²) 计算复杂度降至 O(n)？
KV Cache 是大模型自回归生成任务的关键优化技术，通过“空间换时间”策略缓存历史 Key 和 Value 向量，将推理复杂度从 O(n) 降至 O(n)。文章阐述了语义缓存与前缀精确匹配两种核心范式，深入分析了 KV Cache 的技术底层原理、工程化应用及规模…
物流系统如何打通信息孤岛？哲盟软件系统：一键打通内外部数据壁垒
在数字化转型加速的今天，物流企业面临的最大痛点之一就是信息孤岛——ERP、电商平台、智能硬件、OMS/TMS/WMS等系统各自为政，数据无法自由流转，导致人工操作繁琐、效率低下、出错率高。特别是在跨境物流领域，亚马逊、Shopee、TikT…
Windows Defender终极恢复指南：5种强力方法解决禁用问题
Windows Defender终极恢复指南：5种强力方法解决禁用问题 【免费下载链接】no-defender A slightly more fun way to disable windows defender firewall. (through the WSC api) 项目地址: https://gitcode.com/GitHub_Trending/no/no-defender 当你的Windo…
施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录
更多请点击： https://codechina.net 第一章：施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录 在华北某大型地铁盾构施工现场，一套轻量化AI Agent系统于2024年Q2完成全栈部署ÿ…
附录 B：术语表
本术语表面向“从 MM 到 HMM”专栏阅读过程中的快速查阅。它不是内核 API 手册，而是把文章中反复出现的概念放到同一张地图上：先给出直观含义，再说明它在 Linux MM/HMM 语境里的作用。建议阅读方式： 初读专栏时，把它当…
Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表·行业首曝）
更多请点击： https://kaifayun.com 第一章：Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表行业首曝） Midjourney 的渐变美学并非传统插值实现，而是由其隐式神经渲染器（Implicit Neu…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…