uzairansaruzi/hermex

Hermex – iPhone control panel for a self‑hosted Hermes AI agent

What it is – Hermex is a native iOS 18+ SwiftUI app that lets you talk to, manage, and inspect a hermes‑webui server you run yourself. The phone is only the control plane; all model inference, tool execution and data stay on the machine where you host the Hermes server.

Key capabilities

• Chat – send prompts, choose the model/provider, attach files, and watch a streamed response that includes tool‑call details.
• Run control – pause or stop an ongoing agent run.
• Sessions – list, search and resume past conversations; cached locally for offline reading.
• Model picker – switch among any models the server exposes, with favourites and recent list.
• Profiles & projects – organise conversations under different agent profiles or project groups.
• Tasks – view and edit cron‑style jobs the agent has scheduled.
• Skills browser – explore the agent’s installed “skills”.
• Workspace browser – navigate the server’s file system from the phone.
• Memory & Insights – read‑only panels showing the agent’s memory store and usage analytics.

How it works

1. You run hermes‑webui (a separate open‑source Python server) on a machine you control (macOS, Linux, Windows/WSL2).
2. Expose that server to your iPhone via HTTPS – e.g. Cloudflare Tunnel, Tailscale Serve, a private VPN, or simple local Wi‑Fi.
3. In Hermex enter the server URL and the password you set (HERMES_WEBUI_PASSWORD). The app then talks directly to the server’s REST API.

Privacy & cost – The app is free, has no in‑app purchases, and does not collect analytics. Push notifications are optional and go through an open‑source relay you can self‑host; the relay only sees metadata, never the message content.

Getting started – The README walks through a ~15‑minute setup, including server installation, exposing it securely, and connecting from the iPhone. For developers, the source builds with Xcode 26 (iOS 18 SDK) and uses Swift Package Manager for dependencies.

Scope – Hermex does not provide the AI model itself; it is purely a client for the Hermes‑webui backend, which in turn can proxy any LLM you configure.

---

TL;DR – Hermex is a privacy‑first iOS app that gives you a native UI to chat with and manage a self‑hosted Hermes AI agent, handling sessions, tasks, skills, and file browsing while keeping all compute and data on your own server.