explaingit

uzairansaruzi/hermex

Analysis updated 2026-05-18

898SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A native iPhone app that lets you chat with and manage a self hosted Hermes AI agent server that you control yourself.

Mindmap

mindmap
  root((Hermex))
    What it does
      Controls self hosted agent
      Streams chat responses
      Manages tasks and skills
    Tech stack
      Swift
      SwiftUI
      iOS 18 plus
    Use cases
      Remote agent chat
      Scheduled task management
      Offline session browsing
    Setup
      Run hermes-webui server
      Expose via tunnel or Tailscale
      Connect with URL and password

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with a self hosted AI agent from an iPhone while all data stays on the user's own server.

USE CASE 2

View, edit, and manage the agent's scheduled cron jobs and installed skills from a phone.

USE CASE 3

Browse and resume past agent sessions, including cached offline reading of previous conversations.

What is it built with?

SwiftSwiftUIiOS

How does it compare?

uzairansaruzi/hermexnickustinov/itsyhome-macosapple/coreai-models
Stars898896881
LanguageSwiftSwiftSwift
Setup difficultymoderateeasy
Complexity3/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires running a separate self hosted hermes-webui server first and exposing it securely to the phone.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Hermex is a native iPhone app for controlling a self hosted Hermes agent server, called hermes-webui, that runs on a computer the user owns and controls. The phone acts only as a remote control, sending commands and displaying responses, while the actual AI agent, its tools, and all of the user's data stay on their own hardware rather than on any company's servers. The app itself is free with no subscriptions or in app purchases, does not collect analytics or use any third party relay, and only talks directly to the user's own server. From the app, a user can chat with their agent and see responses stream in as they are generated, attach files and images, stop or redirect a response mid way through, and browse and resume past conversations even when offline since sessions are cached. It also lets someone switch between whichever AI models or providers their server is set up to use, switch between different agent profiles and projects, view and edit the agent's scheduled recurring jobs, search the skills installed on the agent, browse the server's file system, and view read only panels showing the agent's memory and usage statistics. Hermex is only a client. It does not include, host, or set up the actual agent server, so a user first has to install and run the separate open source hermes-webui project themselves on macOS, Linux, or Windows with WSL2, set a password for it, and then make that server reachable from their phone, for example through a tunnel with real HTTPS, a reverse proxy, or a private network tool like Tailscale. Once the server is reachable, connecting the app is just a matter of entering its address and password. Building the app from source requires Xcode 26 or newer and an iPhone or simulator running iOS 18 or later, with dependencies resolved automatically through Swift Package Manager, though most users are expected to just download the finished app from the App Store instead. The project notes it is tested against a specific pinned version of the hermes-webui server and that using a different server version may break some features. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through setting up hermes-webui on my own machine and connecting Hermex to it from my iPhone.
Prompt 2
Explain the different ways to make my hermes-webui server reachable from my phone, like Tailscale versus a reverse proxy.
Prompt 3
Help me troubleshoot why Hermex cannot connect to my hermes-webui server.
Prompt 4
Show me how to build the Hermex app from source in Xcode for a specific iPhone simulator.

Frequently asked questions

What is hermex?

A native iPhone app that lets you chat with and manage a self hosted Hermes AI agent server that you control yourself.

What language is hermex written in?

Mainly Swift. The stack also includes Swift, SwiftUI, iOS.

What license does hermex use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is hermex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hermex for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.