Hermex

What Hermex does

Hermex is a client only. You run a hermes-webui server, an MIT-licensed third-party project, on macOS, Linux or Windows/WSL2 with Python 3.11+, set HERMES_WEBUI_PASSWORD, and enter the server URL and password in the app. The phone acts as the control plane while the agent, its tools and your data stay on your machine. The app is written in SwiftUI for iOS 18+, is free, and has no analytics or tracking.

In the app you chat with the agent using model, reasoning-effort, workspace and profile options, attach files and images, watch responses stream with thinking and tool-call detail, and steer or stop a run mid-flight. Other screens cover sessions with offline caching, model switching, profiles and projects, scheduled cron tasks, skills, a workspace file browser, and read-only memory and usage panels. The README recommends reaching the server over HTTPS through Cloudflare Tunnel or a reverse proxy, or privately with Tailscale Serve. Push notifications are optional and go through a self-hostable relay.

Key features

• Chat with model, reasoning-effort, workspace and profile options, plus file and image attachments
• Streaming responses with thinking and tool-call detail, and the ability to steer or stop a run
• Session browser with search, resume and offline reading of cached sessions
• View and edit scheduled cron jobs, and browse installed skills
• Workspace file browser plus read-only memory and usage insights
• Optional push notifications through a self-hostable relay that never sees message text

When to use it

• Check on a long-running Hermes agent task from your phone
• Stop or steer a run while away from your desk
• Edit a scheduled cron job on the go

Who it is for: Hermes users who self-host their agent and want a native iPhone client for it.

How it fits with Hermes Agent

Built for Hermes agents: it drives a self-hosted hermes-webui server, a separate third-party project, rather than talking to Hermes directly.

Requirements: An iPhone on iOS 18+, a self-hosted hermes-webui server (Python 3.11+, with HERMES_WEBUI_PASSWORD set), and a way to reach it from the phone such as an HTTPS tunnel, reverse proxy or Tailscale Serve

Note: Hermex is a client only and needs your own hermes-webui server, and securing and exposing that server is the user's responsibility.

FAQ