尧图网络 高端网站定制 · 原创设计
免费咨询热线
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/9/8 10:49:16
图解TCP报文段结构:从字段拆解到实战抓包分析

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

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

📅 2026/8/22 15:37:50
codex cli 源码教程 | 第一篇:Codex CLI 不只是一个 CLI

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

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

📅 2026/8/22 15:37:50
MORE NEWS

更多资讯

📰

魔方最高多少阶?别被高频面试题带偏了,资深开发者揭秘底层逻辑

魔方最高多少阶?别被高频面试题带偏了,资深开发者揭秘底层逻辑 刚写完几百行 Python 语法,打开 IDE 却对着空白编辑器发呆,脑子一片空白?这种“会写代码但不会搭项目”的断层,是无数初学者最痛的伤疤。更扎心的是,当你去刷 CSDN…

📰

playboy杂志封面渲染卡顿?这份速查手册教你优化

playboy杂志封面渲染卡顿?这份速查手册教你优化 刚把那段处理图片网格的代码复制过来,一跑就卡死?内存直接飙到爆表,页面白屏半天出不来?别慌,这种“复制即死”的坑,我踩了十年,太懂了。你需要的不是重写逻辑,而是一份能直接抄作业的…

📰

腾讯浏览器高频面试题:证书与职责边界实战拆解

腾讯浏览器高频面试题:证书与职责边界实战拆解 刚把网上找的腾讯浏览器面试题复制下来,结果跑不通,报错满天飞?别急,这种“复制粘贴即崩”的情况太常见了。很多老手都踩过这个坑,尤其是准备面试突击时,光背八股文没用,得懂原理。今天咱们不聊虚的,直…

📰

佳能e500驱动升级后API全变?3招性能优化最佳实践

佳能e500驱动升级后API全变?3招性能优化最佳实践 版本升级后 API 全变了,代码跑起来直接报错,这是很多开发者在面对 佳能e500 相关设备驱动或底层接口更新时最头疼的事。别急,这不是你的问题,是接口层变动太大。要想在…

📰

3招解决帷幕代码卡顿图解原理

3招解决帷幕代码卡顿图解原理 复制来的代码跑不通不知道怎么调?别急着删库重装。我见过太多人卡在“为什么这行代码在我机器上慢成狗”上,其实问题往往出在资源调度与内存管理的底层逻辑。今天我们就用 图解原理…

📰

搞定计量单位换算表大全,5个坑让你少熬3夜

搞定计量单位换算表大全,5个坑让你少熬3夜 官方文档翻了三遍还是晕?别急,那是你没抓到重点。 想搞定计量单位换算表大全,光背公式没用,得看 完整示例 。 今天不聊虚的,直接上代码,帮你避开那些让人头秃的坑。…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

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

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

📞 💬