尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
hermes最新版安装指南
Hermes Agent Web UI在Windows 10/11WSL2下的完整安装指南本指南适用于希望在一台Windows电脑上通过WSL2部署Hermes Agent命令行界面和hermes-web-uiWeb管理界面的用户。所有步骤均经过验证可稳定运行。一、准备工作1.1系统要求Windows 10 版本 2004 及以上内部版本 19041 及以上或 Windows 11至少 8GB 内存推荐 16GB网络能够访问 GitHub若速度慢请参考下文“加速技巧”1.2开启WSL2和虚拟机平台以管理员身份打开PowerShell执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart然后重启电脑。重启后继续以管理员身份运行PowerShell设置WSL2为默认版本wsl --set-default-version 2二、安装Ubuntu 22.04解决下载慢问题2.1常规安装如果网络良好直接执行wsl --install -d Ubuntu-22.042.2如果下载缓慢或超时方法一使用--web-download参数从 GitHub 直接下载避开微软商店wsl --install -d Ubuntu-22.04 --web-download方法二手动下载并导入最稳定从WSL 发行版 GitHub 仓库或Ubuntu WSL 镜像下载ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz。在 PowerShell 中执行mkdir D:\WSL\Ubuntu-22.04 # 安装到 D 盘可自定义 wsl --import Ubuntu-22.04 D:\WSL\Ubuntu-22.04 D:\下载路径\ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz --version 2 #​​​​​​​设置默认用户可选 powershell wsl -d Ubuntu-22.04#进入后创建用户useradd -m -G sudo -s /bin/bash yourname然后passwd yourname再编辑/etc/wsl.conf设置默认用户方法三配置国内镜像源若wsl --install卡在“正在下载”可尝试修改 DNS 或使用代理。在 Windows 的C:\Windows\System32\drivers\etc\hosts中添加185.199.108.133 raw.githubusercontent.com 185.199.109.133 raw.githubusercontent.com 185.199.110.133 raw.githubusercontent.com 185.199.111.133 raw.githubusercontent.com安装完成后从开始菜单启动 Ubuntu按提示创建普通用户请勿使用root。三、安装Hermes Agent自动处理所有依赖3.1进入Ubuntu终端更新软件源并安装Gitsudo apt update sudo apt install -y git curl3.2执行官方安装脚本自动安装Python 3.11、Node.js v22等如果你的网络访问GitHub较慢请使用国内镜像加速。方式A推荐使用加速镜像curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash方式B使用GitCode镜像克隆git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent bash scripts/install.sh --local方式C如果上述均失败手动配置hosts在/etc/hosts中添加185.199.108.133 raw.githubusercontent.com然后重试方式A。安装脚本会自动完成安装 Python 3.11若系统中没有安装 Node.js v22 LTS~/.hermes/node/bin安装ripgrep、ffmpeg等工具创建虚拟环境并安装 Python 依赖注意此过程中无需你手动安装nvm或Node.js脚本已妥善处理。3.3刷新环境变量并验证source ~/.bashrc hermes doctor此时若看到API key not configured或OpenRouter API (not configured)属于正常现象下一步会配置。️四、配置Hermes Agent选择模型提供商运行配置向导hermes setup按照提示完成选择模型提供商可选OpenRouter推荐聚合多家模型、OpenAI、Anthropic等或使用自定义端点如你已有的gpt-oss-20b。输入API Key若使用付费服务或跳过若使用本地模型。选择默认模型。如果你已有自定义端点可直接在~/.hermes/.env中设置CUSTOM_API_KEYyour_key CUSTOM_BASE_URLhttp://your_endpoint/v1之后通过hermes model选择自定义模型。配置完成后再次运行hermes doctor确认API key or custom endpoint configured为✓。五、安装hermes-web-uiWeb管理面板Hermes安装脚本已经为你安装了Node.js因此可以直接使用npm。5.1全局安装hermes-web-uinpm install -g hermes-web-ui如果提示command not found请将npm全局bin目录加入PATHecho export PATH$(npm prefix -g)/bin:$PATH ~/.bashrc source ~/.bashrc5.2启动Web UIhermes-web-ui start成功后在Windows浏览器中访问http://localhost:8648即可。注意hermes-web-ui需要Hermes网关服务在后台运行。如果页面提示连接错误请另开一个终端窗口执行hermes gateway run保持前台运行然后刷新Web UI。六、验证与常用命令启动命令行交互hermes启动Web UIhermes-web-ui start运行诊断hermes doctor更新Hermeshermes update若后续需要️七、可选优化与故障排除7.1增加WSL内存限制避免Windows卡顿在Windows用户目录C:\Users\你的用户名\下创建.wslconfig内容ini [wsl2] memory4GB processors2然后重启WSLwsl --shutdown7.2配置国内镜像加速npm下载npm config set registry https://registry.npmmirror.com7.3若hermes-web-ui启动后无法连接确认hermes gateway run在另一个终端中运行。检查防火墙是否允许 8648 端口。7.4若hermes doctor提示agent-browser not installed这是可选的浏览器自动化工具如需安装npm install -g agent-browser agent-browser install
RELATED

相关推荐

Qwen3.8正式版即将开源!2.4T参数的通义千问新秀,预览版已上线,限时1折抢先体验

Qwen3.8正式版即将开源!2.4T参数的通义千问新秀,预览版已上线,限时1折抢先体验

原创:凯哥Java本文标签:Qwen3.8、通义千问新模型、2.4T大模型、阿里云AI、大模型开源大家好,我是凯哥Java。做AI开发这么多年,凯哥深知一个道理:大模型这东西,跟手机一样,更新换代快得离谱。这不…

📅 2026/11/17 0:09:43
图解TCP报文段结构:从字段拆解到实战抓包分析

图解TCP报文段结构:从字段拆解到实战抓包分析

1. 项目概述:为什么我们需要拆解TCP包?在网络世界里,数据就像一封封信件,而TCP(传输控制协议)就是那个最可靠、最负责任的邮差。它确保你的每一封“信”——无论是网页请求、文件下载还是视频流——都能完整…

📅 2026/11/17 0:09:43
codex cli 源码教程 | 第一篇:Codex CLI 不只是一个 CLI

codex cli 源码教程 | 第一篇:Codex CLI 不只是一个 CLI

Codex CLI 表面上是一个终端命令:在项目目录执行 codex,输入任务,然后等待它阅读代码、执行命令并修改文件。 如果只把它理解成“给大模型套了一层命令行界面”,后续阅读源码会很快遇到困难。这个仓库实际实现的是一套本地 Agent…

📅 2026/10/30 4:02:52
MORE NEWS

更多资讯

📰

高级电工证年审时间别踩坑,考前押题攻略全在这

高级电工证年审时间别踩坑,考前押题攻略全在这 不知道去哪报名怕被中介坑?你不是一个人。高级电工证年审时间一到,很多人就慌了,不仅担心错过时间,还怕被虚假机构忽悠。其实,只要掌握了正确的流程,年审和考试都能顺利通过。下面我结合河南地区实际,告…

📰

临沧学低压电工证网上查询攻略:考前必看的避坑指南

临沧学低压电工证网上查询攻略:考前必看的避坑指南 找工作没证,连门都进不去,这话不是夸张。特别是现在国家对特种作业人员持证上岗的要求越来越严, 临沧学低压电工证…

📰

一级技师电工证到期换证流程官方回应来了

一级技师电工证到期换证流程官方回应来了 急需特种作业证才能上岗找工作,别再等了,一级技师电工证到期换证流程已经明确,官方回应不再模糊,多地市安全生产教育培训中心已经发布最新操作规范。如果你手头还有一级技师电工证,别等到快失效了才慌张,现在了…

📰

灯具厂电工证含金量够不够?外省证书能转吗?这几点必须知道

灯具厂电工证含金量够不够?外省证书能转吗?这几点必须知道 之前考的证在外省能不能转过来?这是很多灯具厂电工从业者最关心的问题,尤其是那些在外地打工、换过工作地点的电工。如果你正打算考灯具厂电工证,或者已经在准备转证,那你一定想知道…

📰

邯郸考建筑电工证官方回应:怕考不过白交培训费?别慌,有这招稳过

邯郸考建筑电工证官方回应:怕考不过白交培训费?别慌,有这招稳过 怕考不过白交培训费?你不是一个人。我带过十几个学员,80%的人都在培训前担心这事儿。别急,我今天就从【邯郸考建筑电工证】的真实案例出发,给你讲明白怎么稳稳拿证,少走弯路。…

📰

哪个电工证资质高电子证书怎么领最稳妥

哪个电工证资质高电子证书怎么领最稳妥 实操考试心里没底怕挂科,这几乎是每个准备考电工证的学员心里的共同焦虑。尤其是第一次接触这类考试的人,面对实操环节,更是紧张得不行。别担心,这里不仅告诉你哪个电工证资质高,还会教你如何稳妥拿到电子证书,让…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬