Hermes Agent for macOS

A native macOS desktop app for Hermes WebUI — built with Swift and WKWebView, no Electron, no heavy dependencies. Just a clean, native window for your Hermes Agent on macOS 12+.

UI & Workspaces415Added
View on GitHub
hermes-swift-mac
Hermes Agent for macOS

What Is It

Hermes Agent for macOS (hermes-swift-mac) is a native macOS desktop app that wraps Hermes WebUI in a proper Mac window. It’s built with Swift and WKWebView — no Electron, no JavaScript runtime, no dependencies beyond Xcode Command Line Tools. Created by @redsparklabs.

The app itself is a lightweight shell: it needs a running Hermes WebUI instance (local or remote) to be useful. What you get in return is a native-feeling Mac app — proper window management, native rendering, and a fraction of the memory footprint of Electron-based alternatives.

Key Details

Detail Value
Tech Swift + WKWebView, no Electron
Requires Hermes WebUI running locally or on a remote server
Remote support Optional SSH key auth for remote servers
macOS 12 (Monterey) or later
Install Download Hermes-Agent-vX.X.X.dmg from Releases

Getting Started

Path 1 — new to Hermes, everything local:

# 1. Get Hermes WebUI running
git clone https://github.com/nesquena/hermes-webui.git ~/hermes-webui-public
cd ~/hermes-webui-public
bash start.sh          # starts server at http://localhost:8787

# 2. Install the Mac app
# Download the latest .dmg from the Releases page and drag it to Applications

Path 2 — remote server: configure SSH key auth for the server running Hermes WebUI, and point the app at it. You get a native Mac front-end for a Hermes agent that lives on your VPS.

Why It Matters for Hermes Users

If you use Hermes on a Mac, this is the most native way to interact with it: a real macOS app instead of a browser tab or an Electron wrapper. It pairs with the broader Hermes WebUI ecosystem (Android client, desktop Rust client, extensions) so you can have a first-class native surface on every device.

← Back to Ecosystem