Hermex

Hermex 快速入门

一款开源 iOS 原生客户端，专为 Hermes Agent 设计，支持连接自托管实例，在 iPhone 上使用你自己的 AI 助手。

这是什么？解决什么问题？

Hermex 是为 Hermes Agent 用户打造的原生 iOS 客户端。Hermes Agent（由 Nous Research 开发）是一个可自托管的 AI Agent 框架，支持多种 LLM 后端和丰富的工具调用能力。但 Hermes Agent 的 Web 界面在手机上操作不便——Hermex 解决了这个问题：用 SwiftUI 构建原生 iOS 体验，保持了 iOS 平台的流畅交互、推送通知和本地存储能力。

Hermex 将 Hermes Agent 的后端能力完整转移到手机上：你可以通过 Hermex 连接自己部署的 Hermes 实例，使用熟悉的对话界面与 AI 交互，所有对话数据存储在本地设备上，无需担心云端隐私泄露。它本质上是一个”私人 AI 助手客户端”——你的 AI 跑在你的服务器上，而 Hermex 是你的随身入口。

该项目由独立开发者 Uzair Ansar 创建并开源（MIT 许可），目前处于活跃开发阶段。核心设计理念是”简洁”：不追求功能膨胀，而是让 AI 对话体验回归 iOS 原生质感。

功能特性

1. 原生 iOS 对话界面

Hermex 使用 SwiftUI 构建，充分利用 iOS 系统特性：原生导航动画、系统键盘集成、深色模式自动适配、Dynamic Type 字体缩放。与 Web 套壳应用（如 PWA 封装的 AI 客户端）不同，Hermex 的滚动性能、触摸反馈和过渡动画都是原生的，体验接近 iMessage 的流畅度。

• 来源：Hermex GitHub

2. 自托管实例连接

支持通过自定义 URL 连接任意 Hermes Agent 实例。你可以在自己的服务器、家庭 NAS 甚至树莓派上运行 Hermes Agent，然后通过 Hermex 远程访问。这避免了依赖第三方 API 服务的隐私风险——所有对话数据直接从你的设备到你的服务器，中间不经过任何第三方。

• 来源：Hermex README

3. 多模型切换

支持在已连接的 Hermes 实例上切换不同 LLM 模型。如果你的 Hermes 实例配置了多个后端（如 DeepSeek-V4、Claude、本地 Ollama 模型），Hermex 允许你在对话中直接切换模型，无需回到设置页。

• 来源：Hermex GitHub

4. 对话历史本地存储

所有对话记录使用 Core Data 存储在设备本地，支持搜索、删除和导出。与基于云的聊天客户端不同，Hermex 的历史记录不会上传到任何服务器——它完全是你的本地数据。

5. 开源 MIT 许可

MIT 许可证意味着你可以自由使用、修改和分发 Hermex，甚至可以将其作为基础构建商业应用。源代码完全透明，任何关注安全性的用户都可以自行审查代码。

• 来源：LICENSE

准备工作

1. 一台运行 Hermes Agent 的服务器：在你自己的服务器上部署 Hermes Agent（参考 Hermes Agent 文档）
2. iOS 17.0+ 设备：Hermex 需要 iOS 17 或更高版本
3. Xcode 16+（如需自行编译）：从 GitHub 克隆源码后需要 Xcode 编译安装到设备
4. 网络连通性：你的 iPhone 需要能访问 Hermes Agent 服务器的 URL

快速上手

第 1 步：部署 Hermes Agent 后端

首先确保你有一个运行中的 Hermes Agent 实例。按照官方文档部署后，记录下实例的访问 URL（如 https://your-server.com:8080 或局域网 IP http://192.168.1.100:8080）。

第 2 步：安装 Hermex

从 GitHub Release 页面下载最新 IPA 文件（如果提供了预编译版本），或克隆源码在 Xcode 中编译安装到你的 iPhone：

git clone https://github.com/uzairansaruzi/hermex.git
cd hermex
open Hermex.xcodeproj  # 在 Xcode 中打开，选择你的设备，点击 Run

第 3 步：连接并对话

打开 Hermex，在设置页输入你的 Hermes Agent 实例 URL。连接成功后即可开始对话——体验与 Hermes Web 界面一致，但拥有了原生 iOS 的手势操作和推送通知。

竞品对比

Hermex 的差异化在于它是”专用客户端”——不是通用 LLM 前端，而是专门为 Hermes Agent 生态打造的入口。如果你已经使用 Hermes Agent 作为 AI 助手框架，Hermex 是目前唯一的原生 iOS 选择。

适用场景

1. 个人 AI 助手随身携带：在家里的服务器上运行 Hermes Agent，出门时用 Hermex 随时访问——你的 AI 数据和上下文保持连续性
2. 隐私敏感场景：企业或研究人员需要完全控制 AI 对话数据流，不希望经过 OpenAI/Google 的服务器时，Hermes + Hermex 提供了端到端的私有方案
3. 开发者测试：Hermes Agent 开发者可以用 Hermex 快速测试新功能在移动端的表现