hermes-webui/hermes-swift-mac

The best way to run Hermes on your Mac!

What it solves

Hermes Agent is a native macOS desktop wrapper for the Hermes Web UI, providing a dedicated application window instead of requiring a web browser. It simplifies access to AI agents via the Hermes Web UI, especially for users who run their AI server on remote machines via SSH tunnels.

How it works

The app is built with Swift and WKWebView, acting as a lightweight native shell. It connects to a running instance of Hermes Web UI (either locally or on a remote server). For remote connections, it manages an SSH tunnel automatically, monitoring the connection state and handling reconnection if the link drops.

Who it’s for

macOS users who want a dedicated desktop experience for Hermes Web UI with native system integration, such as global keyboard shortcuts and system notifications.

Highlights

  • Native macOS Integration: Includes a Dock icon, standard menu bar, and a global shortcut (⁃ℏ H) to bring the app to the front from any other application.
  • Remote Access: Built-in SSH tunnel mode for secure access to remote Hermes Web UI instances without manual terminal configuration.
  • System Features: Supports native macOS notifications for completed AI responses, voice input via microphone permissions, and clipboard integration for text and images.
  • Lightweight Architecture: Built with Swift and WKWebView rather than Electron, ensuring better system performance and lower resource usage.

Related

  • Project
    awizemann/scarf

    A native macOS and iOS GUI for the Hermes AI agent, providing visibility and control over sessions, memory, and configuration via a native Swift interface.

  • Project
    Eynzof/Hermes-CN-Desktop

    A native Windows and macOS desktop client for Hermes Agent, providing an integrated UI and runtime management for AI agents.

  • Project
    uzairansaruzi/hermex

    A native SwiftUI iPhone app that serves as a mobile control plane for self-hosted hermes-webui AI agents, keeping data and compute on the user's own hardware.

  • Project
    basionwang-bot/HermesPet

    A native macOS AI desktop companion that acts as a unified control plane for multiple AI agents and terminals, integrating system diagnostics and cross-device task management.

  • Project
    dataelement/dsh-desktop

    A local-first desktop shell for DeepSeek Harness that packages the agent runtime and Web UI into a cross-platform application for macOS and Windows.