hermex  by uzairansaruzi

Mobile cockpit for self-hosted AI agents

Created 1 week ago

New!

725 stars

Top 46.7% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Hermex offers a native SwiftUI iPhone app for controlling self-hosted hermes-webui AI agents. It provides a private, secure mobile cockpit, ensuring agent computation, tools, and data remain on user-controlled hardware, free from middlemen or tracking. This enables users to manage their AI agents privately and efficiently on the go.

How It Works

As a client-only application, Hermex connects securely to a user-managed hermes-webui backend. Built with native SwiftUI for iOS 18+, it prioritizes performance and a seamless user experience. The architecture enforces data locality, with the iPhone acting solely as the control plane, preserving user privacy and control over AI agent operations.

Quick Start & Requirements

  • Installation: App Store download.
  • Server: Requires separate hermes-webui server (Python 3.11+ on macOS, Linux, or Windows/WSL2).
  • Prerequisites: iOS 18+. For source builds: Xcode 26+ (iOS 18 SDK).
  • Connectivity: Server reachable via HTTPS (recommended, e.g., Cloudflare Tunnel) or Tailscale.
  • Setup Time: ~15 minutes for server setup.
  • Docs: hermexapp.com

Highlighted Details

  • Real-time agent response streaming with detailed thinking/tool-call info.
  • Full session management: browse, search, resume conversations; offline cached sessions.
  • Flexible model/provider selection with recents/favorites.
  • Management of agent profiles, projects, scheduled tasks, and skills.
  • Integrated workspace browser for server file system exploration.
  • Read-only access to agent memory and usage analytics.

Maintenance & Community

Maintained by uzairansaruzi. Support via GitHub Issues. Updates on X (@uzairansar).

Licensing & Compatibility

Released under the permissive MIT License. Functions as an independent client, not affiliated with upstream hermes-webui.

Limitations & Caveats

Hermex is client-only, requiring a separate hermes-webui server. Functionality depends on the upstream server's API, which lacks guaranteed stability, potentially causing feature breakage with version skew. Users are responsible for server hosting, security, and accessibility. Requires iOS 18+.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
53
Issues (30d)
45
Star History
726 stars in the last 9 days

Explore Similar Projects

Feedback? Help us improve.