引言

在 AI Agent 技术井喷的今天，如何让智能体走出代码堆栈、真正走向落地应用，成为了开发者们关注的焦点。Hermes Agent 作为一款轻量且高效的智能体框架，凭借其出色的扩展性与灵活的编排能力，正逐渐成为开发者构建自动化工作流的利器。然而，面对纯代码或命令行交互，调试和展示的门槛常常让人望而却步。并且部署完成后，纯命令行使用起来也不是非常可观。

所以站长研究出了Hermes Agent + hermes-web-ui 组合的方案，Hermes Agent 负责底层核心逻辑与工具生态的高效运转，而 hermes-web-ui 则负责将复杂的运行状态，转化为优雅、直观的 Web 交互界面。

本篇教程将带你“零踩坑”快速完成 Hermes Agent 与 hermes-web-ui 的双剑合璧。我们不仅会演示如何在本地实现极速部署，更会手把手教你配置可视化界面，让你用最短的时间拥有一个属于自己的、兼具强大内核与高颜值的 AI Agent 协同工作台。

部署教程

1、部署Hermes Agent

以Linux系统为例，首先在系统上部署Hermes Agent，执行官方提供的一键部署命令。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

国内的网络环境使用官方的部署命令可能会受网络条件限制，无法进行下载安装，可以使用第三方安装脚本，以Hermes Agent中文站为例，使用以下命令进行部署。

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

等待安装时，直到跳转到引导界面。看到这个界面的时候进行引导安装，到这个页面回车选择，然后根据自己的情况进行配置

出现以下信息代表安装成功，最后还需要根据你的Linux使用的shell执行命令以加载环境变量，如果不加载环境变量的话，你无法正常使用 hermes 命令。

# bash使用
source ~/.bashrc

# ZSH使用
source ~/.zshrc

---

2、安装hermes-web-ui

接着安装hermes-web-ui以用来对接hermes Agent实现可视化，使用hermes-web-ui官方提供的一键脚本进行安装，直到流程走完即可完成安装。

注意：如果提示某些环境未安装，例如：npm、hermes agent未安装，需要手动安装一下。

bash <(curl -fsSL https://cdn.jsdelivr.net/gh/EKKOLearnAI/hermes-web-ui@main/scripts/setup.sh)

---

3、启动 hermes-web-ui

hermes-web-ui默认监听localhost，如果我们想对局域网或者公网开放的话，或者要自定义端口就需要使用以下命令。

出现以下提示则代表开启成功，如果对外监听了但是启动提示localhost则无需理会，将localhost替换为你的公网/局域网IP即可访问。

BIND_HOST=0.0.0.0 hermes-web-ui start 30501

//对外监听并且以30501端口开放hermes-web-ui

进入hermes-web-ui后不要立马开始使用！因为npm默认安装的版本很旧，基本无法使用，需要立刻点击左下角进行更新！

更新完成后，会自动终止hermes-web-ui服务，你需要再次输入启动命令以启动，这次启动之后需要手动重启一下hermes agent网关！

接下来就可以开始使用了！并且可以在设置里面启用账号密码登录，这样就不用每次输入token进行登录了！

相关模型的配置以及对话均可以在hermes-web-ui里面进行配置使用！

---

4、其他说明

关于顶部提示Nodejs版本，可以暂时无视且不影响使用，作者已经建立了TODO，等待更新即可，同时不建议用户自行解决Node版本问题，很麻烦！

如果出现了什么奇怪的问题，例如无法对话等，可以尝试重启网关或者重启系统！

卸载教程

卸载 Hermes Agent

hermes uninstall

卸载 hermes-web-ui

# 卸载
npm uninstall -g hermes-web-ui
# 删除配置文件
rm -rf ~/.hermes-web-ui