当前位置： 首页 > news >正文

如何快速部署 Hermes Studio：桌面应用、npm 和 Docker 三种方式完整教程

news 2026/7/6 16:09:44

如何快速部署 Hermes Studio：桌面应用、npm 和 Docker 三种方式完整教程

【免费下载链接】hermes-studioWeb dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics项目地址: https://gitcode.com/gh_mirrors/he/hermes-studio

Hermes Studio 是一个功能强大的 AI 智能体管理平台，提供多平台 AI 聊天、会话管理、定时任务和数据分析等完整解决方案。无论你是 AI 开发者还是普通用户，都能通过本文介绍的三种部署方式快速上手使用 Hermes Studio。本文将详细介绍桌面应用、npm 和 Docker 三种部署方法，帮助你选择最适合自己的部署方案。

📦 桌面应用部署（推荐新手使用）

桌面应用是最简单快捷的部署方式，适合想要快速体验 Hermes Studio 所有功能的用户。

下载安装包

访问官方发布页面下载对应操作系统的安装包：

  • Windows：下载.exe或.msi安装程序
  • macOS：下载.dmg或.pkg安装包
  • Linux：下载.AppImage、.deb或.rpm包

安装完成后，Hermes Studio 会自动启动并创建必要的配置文件。

数据存储位置

桌面应用会自动管理数据存储：

  • Windows：%LOCALAPPDATA%\hermes（备用路径：%APPDATA%\hermes）
  • macOS/Linux：~/.hermes

Web UI 状态数据存储在：~/.hermes-web-ui（可通过HERMES_WEB_UI_HOME环境变量自定义）

命令行工具集成

安装后，系统会添加以下命令工具：

  • hermes-studio- 打开 Hermes Studio 桌面应用
  • hermes-studio cli ...- 运行捆绑的 Hermes Agent CLI
  • hermes-studio web ...- 运行捆绑的hermes-web-ui命令
  • hermes-studio-mcp- 运行托管的 Web UI MCP 桥接器

自动更新机制

桌面应用支持自动更新：

  1. 优先从https://download.ekkolearnai.com/latest获取更新
  2. 备用方案：GitHub Releases 最新版本
  3. Windows 升级时会尝试关闭现有进程后替换文件

🔧 npm 命令行部署（适合开发者）

如果你习惯使用命令行工具，npm 部署方式提供了最大的灵活性。

安装步骤

# 全局安装 Hermes Web UI npm install -g hermes-web-ui # 启动服务 hermes-web-ui start

启动后访问：http://localhost:8648

常用命令

命令说明
hermes-web-ui start后台启动（守护进程模式）
hermes-web-ui start --port 9000在自定义端口启动
hermes-web-ui stop停止后台进程
hermes-web-ui restart重启后台进程
hermes-web-ui status检查运行状态
hermes-web-ui update更新到最新版本并重启
hermes-web-ui -v显示版本号
hermes-web-ui -h显示帮助信息

环境变量配置

通过环境变量可以自定义 Hermes Studio 的行为：

# 设置端口和绑定主机 export PORT=9000 export BIND_HOST=0.0.0.0 # 设置数据目录 export HERMES_WEB_UI_HOME=/path/to/your/data # 设置认证令牌 export AUTH_TOKEN=your-custom-token # 启动服务 hermes-web-ui start

维护命令

# 清除登录锁定记录 hermes-web-ui clear-login-locks # 清除登录锁定并重启运行中的 Web UI 进程 hermes-web-ui clear-login-locks --restart # 创建或重置默认超级管理员登录（admin / 123456） hermes-web-ui reset-default-login

🐳 Docker 容器化部署（适合生产环境）

Docker 部署提供了最好的隔离性和可移植性，适合在生产环境中使用。

快速开始

使用预构建镜像（推荐）：

# 使用预构建镜像启动 WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d # 查看日志 docker compose logs -f hermes-webui

从源码构建：

# 从源码构建并启动 docker compose up -d --build # 查看日志 docker compose logs -f hermes-webui

启动后访问：http://localhost:6060

配置文件详解

查看docker-compose.yml文件了解完整的配置选项：

services: hermes-webui: build: context: . dockerfile: Dockerfile image: ${WEBUI_IMAGE:-hermes-web-ui-local:latest} ports: - "${PORT:-6060}:${PORT:-6060}" volumes: - ${HERMES_DATA_DIR:-./hermes_data}:/home/agent/.hermes - ${HERMES_DATA_DIR:-./hermes_data}/hermes-web-ui:/home/agent/.hermes-web-ui

数据持久化配置

Docker 部署的数据存储结构：

路径说明
./hermes_dataHermes 运行时数据（会话、配置、配置文件）
./hermes_data/hermes-web-uiWeb UI 数据（认证令牌等）

认证令牌会在首次运行时自动生成，并打印到容器日志中。

环境变量配置

创建.env文件来自定义配置：

# 使用预构建镜像 WEBUI_IMAGE=ekkoye8888/hermes-web-ui # 自定义端口 PORT=8080 # 自定义绑定主机 BIND_HOST=0.0.0.0 # 自定义数据目录 HERMES_DATA_DIR=/path/to/hermes/data

🔄 部署方式对比

特性桌面应用npm 部署Docker 部署
安装难度⭐⭐⭐⭐⭐（最简单）⭐⭐⭐⭐（需要 Node.js）⭐⭐⭐（需要 Docker）
配置灵活性⭐⭐（有限）⭐⭐⭐⭐⭐（完全可配置）⭐⭐⭐⭐（环境变量配置）
系统资源⭐⭐⭐（中等）⭐⭐⭐⭐（可控）⭐⭐⭐⭐⭐（最佳隔离）
更新维护⭐⭐⭐⭐⭐（自动更新）⭐⭐⭐⭐（命令行更新）⭐⭐⭐（手动更新镜像）
适合场景个人用户、快速体验开发者、自定义部署生产环境、服务器部署

🛠️ 常见问题解决

1. 端口冲突问题

如果默认端口被占用，可以修改启动端口：

# npm 方式 hermes-web-ui start --port 9000 # Docker 方式 PORT=9000 docker compose up -d

2. 认证令牌获取

首次启动后，认证令牌会自动生成：

# Docker 方式查看令牌 docker compose logs hermes-webui | grep token # 或直接查看文件 cat ./hermes_data/hermes-web-ui/.token

3. 数据备份与迁移

所有部署方式的数据都存储在指定目录中：

  • 桌面应用：~/.hermes和~/.hermes-web-ui
  • npm 部署：~/.hermes和~/.hermes-web-ui（或HERMES_WEB_UI_HOME指定目录）
  • Docker 部署：./hermes_data挂载目录

📊 部署后的功能体验

成功部署 Hermes Studio 后，你可以享受以下核心功能：

AI 聊天功能

  • 实时聊天流式传输，支持文件上传下载
  • 多会话管理，支持创建、重命名、删除和切换会话
  • 本地 SQLite 会话数据库存储
  • 按来源（Telegram、Discord、Slack 等）分组会话

平台通道集成

  • 统一配置 8 个平台：Telegram、Discord、Slack、WhatsApp、Matrix、飞书、微信、企业微信
  • 凭据管理写入~/.hermes/.env
  • 通道行为设置写入~/.hermes/config.yaml

自动化管理

  • 创建、编辑、暂停、恢复和删除定时任务
  • 看板板用于规划和跟踪智能体工作
  • 多智能体聊天室，支持 @提及路由和上下文压缩

模型管理

  • 自动从凭据池发现可用模型
  • 添加、更新和删除提供商（预设和自定义 OpenAI 兼容）
  • OpenAI Codex 和 Nous Portal OAuth 登录支持

🚀 进阶配置技巧

自定义 Hermes Agent 运行时

如果你已经安装了 Hermes Agent，可以配置 Web UI 使用现有的运行时：

# 设置 Hermes CLI 路径 export HERMES_BIN=/path/to/hermes # 设置 Hermes Agent 源码目录 export HERMES_AGENT_ROOT=/path/to/hermes-agent # 启动服务 hermes-web-ui start

多配置文件管理

Hermes Studio 支持多配置文件管理：

  • 创建、重命名、删除和切换 Hermes 配置文件
  • 克隆现有配置文件或从存档导入（.tar.gz）
  • 导出配置文件进行备份或共享
  • 配置文件作用域的配置、缓存、上传、会话、任务等

性能优化配置

# 调整日志级别 export LOG_LEVEL=warn export BRIDGE_LOG_LEVEL=warn # 调整文件大小限制 export MAX_DOWNLOAD_SIZE=500MB export MAX_EDIT_SIZE=20MB # 调整桥接超时设置 export HERMES_AGENT_BRIDGE_TIMEOUT_MS=180000

🎯 总结与建议

Hermes Studio 提供了三种灵活的部署方式，满足不同用户的需求：

  1. 桌面应用：适合想要快速上手、无需配置的个人用户
  2. npm 部署：适合需要高度自定义配置的开发者
  3. Docker 部署：适合在生产环境中需要隔离性和可移植性的团队

无论选择哪种部署方式，Hermes Studio 都能为你提供强大的 AI 智能体管理功能。建议新手从桌面应用开始，开发者使用 npm 部署进行定制，生产环境选择 Docker 部署确保稳定性。

现在就开始部署 Hermes Studio，体验智能 AI 助手带来的高效工作流吧！🚀

【免费下载链接】hermes-studioWeb dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics项目地址: https://gitcode.com/gh_mirrors/he/hermes-studio

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

http://www.cnnetsun.cn/news/3187424.html

相关文章：

  • linux_kernel_cves数据准确性验证：避免误报的3个方法
  • Temboard用户指南：从入门到精通的PostgreSQL远程管理技巧
  • MegaDepth代码架构深度解析：理解pytorch-CycleGAN基础框架
  • 中尺度混凝土二维有限元求解——运行弯曲、运行光盘、运行比较、运行半圆形附Matlab代码
  • git-peek安装与配置：5分钟搭建你的本地代码预览环境
  • GraphRAG 实战：从场景选择到效果验证
  • 自托管CMS未来趋势：Instatic发展路线图分析
  • QiLink OS：全球极客的专利孵化器 失败数据共享平台2.0版公告
  • Wayback Machine：你的免费网页时光机，轻松找回消失的互联网记忆
  • CodexGuide × Draw.io：AI自动绘制架构图的实用技巧
  • CRDs-catalog项目深度解析：为什么每个Kubernetes开发者都需要它
  • Pure.DI与Avalonia集成：构建高性能桌面应用的终极指南
  • SymbolicRegression.jl完全指南：如何用分布式高性能符号回归发现隐藏数学规律
  • OpenCord：基于Material You设计的现代化Discord客户端架构解析
  • ESC-50环境声音分类数据集：如何选择最适合您研究需求的音频基准库？
  • 基于LaTeX3技术栈的BIThesis：北京理工大学学位论文自动化格式引擎
  • 在Switch游戏中实现无缝功能访问：Tesla-Menu覆盖菜单完全指南
  • 3分钟掌握Escrcpy：免费实现电脑完美控制安卓设备的终极方案
  • 揭秘 Apache Polaris Catalog：开源数据目录管理的跨引擎革命
  • Penpot本地化架构：如何构建面向全球市场的设计协作平台
  • 30分钟从零到精通：BIThesis助你搞定北理工论文格式难题
  • 终极免费AI图像超分神器：Upscayl完全使用指南
  • Atomic开源AI智能助手平台：5步高效部署与配置实用指南
  • 5秒克隆任意人声：Real-Time-Voice-Cloning终极使用指南
  • D3KeyHelper深度指南：暗黑3智能按键自动化工具完全解析
  • 如何免费获取Revit 2024破解版：完整安装激活指南
  • GPT-SoVITS语音克隆终极指南：5分钟实现专业级AI语音合成
  • WezTerm终极配置指南：5个核心技巧打造高效终端开发环境
  • 艾尔登法环存档编辑器终极指南：3分钟解决跨设备存档难题
  • 5步搞定Intel无线网卡：macOS黑苹果Wi-Fi驱动终极指南