uzairansaruzi/hermex

Hermex – 自己ホストした Hermes AIエージェント用 iPhone クライアント

何であるか – Hermex は、あなた自身が運用する hermes‑webui サーバーを操作できるネイティブ iOS 18+ SwiftUI アプリです。このサーバーは、AIエージェント（通常は大規模言語モデルをバックエンドに持つチャットボット）とそのツール、メモリ、スケジュールされたタスクをホストします。Hermex はあくまで 制御プレーン にすぎません：コマンドを送信し、チャットをストリーミング表示するだけであり、すべてのモデル推論とデータはあなたのマシン上に留まります。

なぜ重要か – プライバシーを最優先するユーザーが、第三者のリレー、分析、サブスクリプション料金なしに、スマートフォンから自分の LLM ベースのエージェントとやり取りできる手段を提供します。このアプリはオープンソースで、MIT ライセンスのもと、実際の SwiftUI（Webラッパーなし）で構築されています。

コア機能（README に記載）

機能	実行可能な操作
チャット	メッセージを送信、モデル/プロバイダーを選択、推論効率を設定、ワークスペースとプロファイルを指定；ファイル/画像を添付；ツールコールの詳細を含むストリーミングレスポンスを確認。
実行の制御	生成中でも一時停止、再開、または中止が可能。
セッション	サーバーに保存された任意の会話を閲覧・検索・再開；セッションはローカルにキャッシュされ、オフラインでも読める。
モデル選択	サーバーが設定している任意のモデルに切り替え可能；お気に入りや最近使用したモデルは保存。
プロファイルとプロジェクト	エージェントのプロファイル（例：システムプロンプト）を変更し、会話をプロジェクトにグループ化。
タスク	スマートフォンから直接、エージェントの cron 形式のスケジュールジョブを表示・編集。
スキル	サーバーにインストールされた「スキル」（ツールプラグイン）の一覧を閲覧・検索。
ワークスペースブラウザ	アプリからサーバーのファイルシステムを探索。
メモリとインサイト	エージェントのメモリストアと使用状況分析を読み取り専用で表示。

はじめ方（ユーザー側）

hermes‑webui サーバーを実行：あなたが管理できる任意のマシン（macOS、Linux、Windows/WSL2）で。Python 3.11+ と環境変数 HERMES_WEBUI_PASSWORD が必要。
iPhone にサーバーを公開：以下の推奨方法のいずれかを使用：
- HTTPSトンネルまたはリバースプロキシ（例：Cloudflare Tunnel）– 推奨。
- Tailscale Serve を使用したプライベート HTTPS。
- ローカルテストのみの場合、サーバーが同じ Mac 上で動作している場合は http://localhost:8787。
Hermex を App Store からインストール（またはソースからビルド）し、サーバーの URL とパスワードを入力。
アプリは /health エンドポイントを検証後、チャット開始、タスク管理などを行えるようになります。

自分でアプリをビルドする方法

要件 – Xcode 26（iOS 18 SDK）以上、iPhone または iOS 18+ シミュレータ。
手順 – リポジトリをクローンし、HermesMobile.xcodeproj を開き、HermesMobile スキームを実行。依存関係は Swift Package Manager で自動取得。
CLI ビルドの例：

xcodebuild -project HermesMobile.xcodeproj \
  -scheme HermesMobile \
  -destination 'platform=iOS Simulator,name=iPhone 17' build

テストも同様に xcodebuild test で実行可能。

互換性に関する注意点

アプリは特定の hermes-webui コミット（UPSTREAM_TESTED_SHA に記録）に対してテスト済みです。上流の API はまだ不安定なため、新しいまたは古いサーバー版では一部の機能が動作しなくなる可能性があります。アプリは未知の JSON フィールドを許容し、サーバーが異なるリリースを報告した場合、「未検証の Hermes バージョン」という警告を表示します。
別の「ボットモード」接続では、ピンされた hermes-agent バージョン（HERMES_AGENT_TESTED_SHA）が使用されます。

コントリビューションとコミュニティ

ガイドライン – コーディング契約、依存関係ルール、PRワークフローについては CONTRIBUTING.md と AGENTS.md を参照。
バグ報告 – リポジトリにイシューを開く。脆弱性の報告には SECURITY.md も利用可能。
サポート – プロジェクトは無料ですが、スター、X 上でのフォロー、コーヒーの寄付を歓迎します。

ライセンス

MIT ライセンス（LICENSE を参照）。
アイコン資産は Apache‑2.0 および MIT ライセンスのサードパーティアイコンセットを使用。

TL;DR

Hermex はプライバシーを重視した iOS クライアントで、自己ホストした Hermes AI エージェントとチャットしたり、制御したり、管理したりできます。オープンソースの hermes‑webui サーバーを自分で実行し、HTTPS（または Tailscale）経由で接続する必要があります。アプリは無料、オープンソース、iOS 18+ のネイティブ SwiftUI で構築されています。