Hermex 是一个面向 iPhone 的原生 SwiftUI 应用，用于远程控制自托管的 hermes-webui AI Agent 服务。它本身不提供后端、不运行模型，也不托管数据，而是作为移动端控制台连接用户自己部署的 Hermes 服务器，实现聊天、会话管理、模型切换、任务管理、技能浏览、工作区文件浏览、记忆与分析查看等功能。项目采用 MIT 协议，免费、无订阅、无内购，强调隐私、无追踪、无第三方中转。
适用领域
iOS 原生应用开发 / Swift / SwiftUI / AI Agent 控制台 / 自托管 LLM 工具 / 移动端 AI 工作流 / 远程服务器管理 / 隐私优先应用 / 个人自动化与任务调度
配置难度
中等。普通用户如果已经熟悉自托管、HTTPS、Tailscale 或反向代理，大约可以在 15 分钟内完成使用配置；但对没有服务器部署经验的用户，难点主要在 hermes-webui 安装、网络暴露、TLS 配置和安全加固。对于 iOS 开发者，源码构建流程较直接，但需要较新的 Xcode 和 iOS SDK。
商业价值
Hermex 的商业价值主要体现在为自托管 AI Agent 用户提供安全、私密、移动化的控制入口。对于个人开发者和小团队，它可以降低在手机上操作 AI Agent 的成本，提升任务监控、会话恢复、任务调度和远程控制效率。由于项目免费、无订阅、MIT 开源，直接变现能力有限，但具备较高的生态价值：可作为 hermes-webui 的移动端补充、SwiftUI AI 客户端参考实现、自托管 AI 产品的前端样板，或进一步扩展为企业内网 Agent 控制台、私有化 AI 工作流移动端入口。
01
技术亮点
- 原生 SwiftUI iPhone 应用，不是 WebView 包装。
- 隐私友好：无分析、无追踪、无第三方中转，客户端只连接用户自己的服务器。
- 免费开源，MIT 协议，无订阅、无内购。
- 支持流式聊天响应，可显示 thinking 和 tool-call 细节。
- 支持文件和图片附件。
- 支持中途停止或控制 Agent 运行。
- 支持会话浏览、搜索、恢复和离线缓存阅读。
- 支持模型、Provider、Profile、Project 和 Workspace 切换。
- 支持查看和编辑 Agent 定时任务。
- 支持技能浏览、工作区文件浏览、Memory 与 Insights 面板。
- 项目文档较完整，包含开发流程、测试策略、安全报告、贡献指南和上游 API 合约测试说明。
- 对 Codable 模型采取宽容解码策略，未知字段不会导致崩溃。
02
目标用户
- 已经部署或计划部署 hermes-webui 的开发者
- 希望用 iPhone 管理自托管 AI Agent 的个人用户
- 重视隐私和数据自主权的 LLM 用户
- 需要在移动端查看和控制 AI Agent 任务的工程师
- Swift / SwiftUI 开发者和 iOS 开源项目贡献者
- 使用 Tailscale、Cloudflare Tunnel 或反向代理暴露私有服务的自托管用户
03
配置要求
- 客户端要求 iOS 18+。
- 源码构建要求 Xcode 26+、Swift 5.9+、iOS 18 SDK。
- 必须自备并运行 hermes-webui 服务，Hermex 不包含后端。
- hermes-webui 需要设置 HERMES_WEBUI_PASSWORD。
- 服务器需要对 iPhone 可达，推荐 HTTPS 域名、Cloudflare Tunnel 或反向代理。
- 公网部署时密码是主要应用层防线，必须使用强密码。
- Tailscale 模式下可使用 Tailscale 内网 IP 的 HTTP 访问。
- 普通公网 HTTP 不推荐，且可能被 iOS ATS 限制。
- 本地模拟器测试可在同一台 Mac 上访问 http://localhost:8787。
- 服务器版本需要与项目中 UPSTREAM_TESTED_SHA 指定的 hermes-webui 提交尽量一致，因为上游 API 尚未稳定。
04
适用场景
- 在 iPhone 上与自托管 Hermes AI Agent 进行流式对话
- 在移动端选择不同模型、Provider、Profile、Workspace 和项目
- 查看、搜索并恢复服务器上的历史会话
- 离线阅读已缓存的会话内容
- 查看和编辑 Agent 的定时任务或 cron jobs
- 浏览 Agent 已安装的 Skills
- 通过移动端查看服务器工作区文件系统
- 查看 Agent Memory 和使用情况 Insights
- 在 Agent 运行过程中中止或调整执行
- 作为 hermes-webui 的 iOS 原生客户端进行二次开发或贡献
05
部署与配置
- 准备一台可控的服务器或本地机器，支持 macOS、Linux 或 Windows/WSL2。
- 安装并启动第三方项目 hermes-webui，要求 Python 3.11+。
- 为 hermes-webui 设置 HERMES_WEBUI_PASSWORD，建议使用强密码。
- 确保 hermes-webui 的 /health 接口可访问，例如 curl https://<your-server>/health。
- 让 iPhone 能访问服务器：推荐使用 HTTPS 域名加 Cloudflare Tunnel 或反向代理，也可使用 Tailscale。
- 如果使用公网 HTTPS，配置真实 TLS 证书，避免 iOS App Transport Security 限制。
- 如果使用 Tailscale，在服务器和 iPhone 上都安装 Tailscale，并通过 http://<tailnet-ip>:8787 连接；应用仅允许 Tailscale 100.64.0.0/10 网段使用明文 HTTP。
- 从 App Store 下载 Hermex，输入服务器 URL 和密码完成连接。
- 如需源码构建，安装 Xcode 26 或更高版本，确保具备 iOS 18 SDK。
- 克隆仓库后打开 HermesMobile.xcodeproj，运行 HermesMobile scheme。
- 也可以使用命令行构建：xcodebuild -project HermesMobile.xcodeproj -scheme HermesMobile -destination 'platform=iOS Simulator,name=iPhone 17' build。
- 运行测试可使用：xcodebuild test -project HermesMobile.xcodeproj -scheme HermesMobile -destination 'platform=iOS Simulator,name=iPhone 17'。
06
风险与注意事项
- Hermex 依赖第三方 hermes-webui，且上游 API 尚未保证稳定，服务器版本不匹配可能导致部分功能失效。
- 项目不负责部署、托管、保护或维护后端，用户需要自行承担自托管安全责任。
- 如果将服务暴露到公网，强密码和 HTTPS 配置非常关键，否则存在未授权访问风险。
- 只支持 iOS 18+，旧设备或旧系统无法使用。
- 源码构建要求 Xcode 26+，对部分开发者门槛较高。
- 目前是 iPhone 客户端定位，不适合希望在 Android、Web 或桌面端使用的用户。
- 工作区文件浏览、任务编辑等能力涉及服务器侧敏感资源，若手机丢失或凭据泄露风险较高。
- 该项目是独立客户端，并非 hermes-webui 官方项目，长期兼容性取决于维护者跟进速度。
2026-07-09
第13名
新收录 · github_search
2026-07-08
第9名
新收录 · github_search
2026-07-07
第9名
新收录 · github_search
2026-07-06
第8名
新收录 · github_search
2026-07-05
第10名
新收录 · github_search
2026-07-04
第13名
新收录 · github_search
