Hermex - 自託管 Hermes AI 代理的原生 iPhone 客戶端
uzairansaruzi/hermex
原生 SwiftUI 打造的 iOS 應用,讓你在 iPhone 上控制自託管的 Hermes AI 代理,資料和計算全在自己伺服器,零訂閱零追蹤
成熟度:維護活躍,1天前最後提交,已釋出 v1.4.0,28 個 open issues 顯示持續迭代中
项目体检
许可 · MIT 协议,可自由商用和修改,需保留原作者版权声明
活跃 · 1天前最后提交,6位贡献者参与,v1.4.0 于 3 天前发布,活跃开发中
解決什麼
Hermex 解決的是自託管 AI 代理的移動端控制問題。當你在自己伺服器上執行 hermes-webui(一個開源 AI 代理框架)時,傳統方案只能通過瀏覽器訪問,體驗不佳且缺乏原生移動特性。Hermex 提供真正的 iOS 原生介面,讓 iPhone 成為 AI 代理的"駕駛艙"——所有計算和資料留在你的伺服器,手機只負責傳送指令和展示結果。這種架構徹底規避了商業 AI 服務的訂閱費用、資料上傳和隱私風險,同時保留了移動端的便捷性。
為何火
專案在 GitHub 獲得 849 stars,核心吸引力在於三點:一是真隱私,應用不含任何分析追蹤程式碼,僅與使用者自己的伺服器通訊;二是零成本,App Store 免費下載且無內購無訂閱,後端用開源 hermes-webui 自建;三是原生體驗,純 SwiftUI 開發而非 WebView 套殼,支援流式響應、離線快取、iOS 18 新特性。對於關注資料主權的開發者和企業使用者,這是少有的既能自託管又有完整移動端的 AI 代理方案。
核心功能
- 即時聊天:支援流式響應,可見 AI 思考過程和工具呼叫細節,支援附件上傳(檔案/圖片),可中途暫停或調整執行引數
- 會話管理:瀏覽、搜尋伺服器上所有歷史對話,已快取會話支援離線檢視
- 模型切換:動態選擇服務端配置的任意模型或提供商,支援收藏和最近使用記錄
- 任務排程:檢視和編輯代理的定時任務(cron jobs)
- 技能瀏覽:搜尋和檢視代理已安裝的所有技能模組
- 工作區檔案:直接從手機瀏覽伺服器檔案系統
- 記憶與洞察:只讀訪問代理的記憶庫和使用分析資料
安裝
- 搭建後端:在 macOS/Linux/WSL2 上安裝 hermes-webui(需 Python 3.11+),設定
HERMES_WEBUI_PASSWORD環境變數 - 配置網路:推薦通過 Cloudflare Tunnel 或反向代理提供 HTTPS 訪問;或使用 Tailscale 組網後通過內網 IP 連線(應用允許
100.64.0.0/10段走 HTTP) - 安裝客戶端:從 App Store 下載 Hermex(需 iOS 18+),輸入伺服器 URL 和密碼即可連線
中國大陸使用者注意:App Store 下載需美區賬號或梯子;服務端可部署在國內伺服器,通過 Tailscale 等內網穿透工具訪問無需梯子。
適合誰
- 隱私敏感使用者:不願將對話資料上傳到 OpenAI/Claude 等商業服務,希望資料完全自控
- 企業內部部署:需要在私有網路執行 AI 代理,通過移動端遠端管理
- 開發者與 Geek:有自建服務能力,追求開源方案和定製自由度
- 成本控制需求:不想支付 ChatGPT Plus 等訂閱費,願意自行承擔伺服器和 API 成本
不適合:不熟悉命令列、無法自建 Python 服務、或希望開箱即用的普通使用者。
社群評價
暫無足量社群公開討論,以下為基於專案本身的中立評估:
從 GitHub 資料看,專案建立僅 14 天即獲 849 stars,顯示出強勁的初期熱度。28 個 open issues 中多為功能請求(如 iPad 適配、Android 版本),說明使用者期待擴充套件平臺支援。程式碼庫結構清晰,包含完整的測試和 CI 配置,開發者在 README 中明確宣告"上游 API 尚未穩定,版本不相容可能導致功能失效",展現出對依賴風險的透明態度。6 位貢獻者參與且最近一次提交在 1 天前,表明專案處於活躍維護狀態而非一次性發布。
選型對比
vs 商業 AI 應用(ChatGPT/Claude 官方 App):Hermex 需自建後端,初期投入高但長期零訂閱費;資料完全自控但需自行保障服務可用性和安全性。商業應用開箱即用但資料上傳到第三方,且受限於官方功能迭代節奏。
vs 其他開源 AI 客戶端:多數開源方案是 Web 介面或 Electron 套殼,Hermex 是少有的原生 iOS 實現,效能和系統整合度更優。但僅支援 hermes-webui 後端,不相容 Open WebUI 等其他框架。
技術取捨:選擇 Swift 原生開發保證了流暢體驗,但限制了跨平臺能力(目前無 Android 版);客戶端-伺服器分離架構降低了手機負載,但增加了網路配置複雜度。
已知坑
- API 穩定性風險:上游 hermes-webui 尚未承諾 API 穩定,服務端版本更新可能導致客戶端功能失效,建議鎖定測試通過的服務端版本(見倉庫
UPSTREAM_TESTED_SHA檔案) - 網路配置門檻:iOS App Transport Security 要求 HTTPS 或特定白名單 IP 段,普通使用者可能在配置 Cloudflare Tunnel 或 Tailscale 時遇到困難
- 平臺限制:僅支援 iOS 18+,無 iPad 最佳化介面,無 Android/Web 版本
- 密碼安全:若通過公網暴露服務端,密碼是唯一的應用層防護,務必設定強密碼並考慮額外的防火牆規則
- 離線能力有限:雖然已快取會話可離線檢視,但所有新操作(發訊息、檢視任務等)均需聯網訪問服務端
安装方式:App Store 下载客户端 + 自建 hermes-webui 服务端(Python 3.11+)