Hermes エージェント☤ 入門 : ユーザガイド – デスクトップ App

Posted on by Masashi Okumura

Hermes デスクトップアプリは、CLI やゲートウェイから取得できるエージェントと同じものをベースに構築されたネイティブアプリです – 設定、API キー、セッション、スキル、メモリなど、すべて同じものが使われています。
これは独立した製品でも軽量クローンでもありません。Hermes エージェントのコアと設定をそのまま使用し、モダン & 洗練された UI を通して操作します。

Hermes エージェント☤ 入門 : ユーザガイド – デスクトップ App

作成 : Masashi Okumura (@classcat.com)
作成日時 : 07/11/2026
バージョン : Hermes Agent v0.18.2 (2026.7.7.2)

* 本記事は hermes-agent.nousresearch.com/docs の以下のページを参考にしています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。

 

 

Hermes エージェント☤ 入門 : ユーザガイド – デスクトップ App

Hermes デスクトップアプリは、CLI やゲートウェイから取得できるエージェントと同じものをベースに構築されたネイティブアプリです – 設定、API キー、セッション、スキル、メモリなど、すべて同じものが使われています。これは独立した製品でも軽量クローンでもありません; Hermes エージェントのコアと設定をそのまま使用し、モダン & 洗練された UI を通して操作します。ターミナルで Hermes を使ったことがあるユーザなら、そこで設定した内容はすべてデスクトップアプリにも反映され、デスクトップアプリで行った操作もすべてそれらに反映されます。

It runs on macOS, Windows, and Linux.

 
💡 Which interface is which?

Hermesには、すべて同じエージェントと通信する複数のフロントエンドがあります :

  • デスクトップ App (このページ) – チャット、設定、管理専用の UI を備えたネイティブアプリケーションです。

  • CLI (`hermes`) と TUI (`hermes –tui`) — ターミナルインターフェースです。

  • Web ダッシュボード（`hermes dashboard`）— ブラウザベースの管理パネルです; オプションのチャットタブでは、擬似ターミナルを介して TUI が組み込まれています。

 

インストール

Hermes Desktop のインストール手順 に従ってください。

既に Hermes がインストールされている場合は、単に以下を実行してください :

hermes desktop

That uses your current config, keys, sessions, and skills.

 

What’s in the app

デスクトップ app は、ナビゲーション用の左側のサイドバーを備えたチャット・ファースト・ウィンドウとして構成されています。これは、複数のエージェントの同時会話の管理、メッセージング・プロバイダーの構成、アーティファクトの作成、プロジェクトのフォルダー構造のブラウズ、そして複数のプロジェクトの同時作業を可能にするように構築されています。

 

チャット

アプリの中心となる機能です。以下の機能が利用できます :

  • エージェントの作業中に、リアルタイムのツールアクティビティと構造化されたツール呼び出しサマリーを含む ストリーミングレスポンス が表示されます。

  • 他のすべての Hermes インターフェースと 同じ会話履歴 – ここで開始したセッションは CLI/TUI で再開でき、その逆も可能です。

  • チャットエリア内の任意の場所に ファイルをドラッグ＆ドロップ して、次のメッセージに添付できます。

  • 右側のプレビューレール では – チャットを続けながら Web ページ、ファイル、ツール出力を並べてレンダリングできます。

  • コンポーザー履歴とキュー編集 – 空のメッセージ作成画面で上下矢印キーを押すと、以前のプロンプトを呼び出して再利用したり、送信前にキューに追加したメッセージを編集したりできます。

 
ステータスバー

チャット画面下部のバーには、セッションのリアルタイム状態が表示され、設定画面を開くことなしにクイックコントロールを公開しています :

  • セッションごとの YOLO 切り替え — このセッションのみ YOLO をオンまたはオフに切り替えます (TUI に一致)。YOLO は危険なコマンドの承認プロンプトをスキップするため、オフにする内容をよく理解してください — see Security → YOLO Mode.

バンドルされているローカルバックエンドではなく、別のマシン上の Hermes インスタンスとチャットしていますか？後述の Connecting to a remote backend をご覧ください – また、リモートホスト型ダッシュボード接続の仕組み (認証ゲート、/api/ws チャットソケット、WebSocket クローズコードトリアージ）の詳細については、Web Dashboard → Connecting Hermes Desktop to a remote backend をご覧ください。

 
モデルの選択

モデル選択ツールは コンポーザー 内のマイクアイコンのすぐ左にあります。クリックすると、ドロップダウンメニューからモデル、推論負荷、高速モードを切り替えることができます。

  • コンポーザー・ピッカーは永続的な (sticky) UI 状態で、デフォルト設定には一切変更を加えません。(デバイスごとに) ローカルに記憶され、新しいチャットや再起動時にも 引き継がれ、デフォルト設定に戻ることはありません – モデルを一度選択すれば、次回 Cmd/Ctrl+N を押すとそのモデル上で開きます。ライブチャット中は、モデルの切り替えは 現在のチャット のみに適用されます; いずれの場合も、セッションの作成/切り替え時に選択内容は引き継がれ、プロファイルのデフォルト設定には書き込まれません。(プロファイルを切り替えると、そのプロファイルのデフォルト設定に戻ります。)

  • デフォルト設定は `Settings → Model` で行います。”main” モデルは、プロファイルごとのグローバルデフォルト設定 です – 新しいチャット、cron ジョブ、サブエージェント、補助タスクは、このモデルを基に開始され、このモデルにのみ書き込みが行われます。各プロファイルは独自のデフォルト設定を保持します。

  • モデルごとの推論負荷 (effort)/高速モードのプリセット。各モデルはデスクトップアプリ内で自身の推論負荷と高速モードの選択を記憶し、そのモデルを選択するたびにセッションに再適用されます。これらのプリセットはデスクトップの利便性を高めるためのものであり、cron ジョブやサブエージェントには影響しません。

  • チャット中に切り替えると、プロンプトのキャッシュがリセットされます。ライブチャット中にモデルを切り替えることは、次のメッセージが完全な入力価格で会話全体を再読み取りすることを意味します (プロバイダー・プロンプト・キャッシュはモデルにキー設定されます)。場合によっては大丈夫です; 長いチャットでは、新しいモデルで新しいチャットをしたほうが、何度もやり取りするよりもコストがかからないことがよくあります。

 

ファイルブラウザ

アプリを離れないで作業ディレクトリを探索・プレビューできます – エージェントがファイルの読み書きや編集を行う様子を追跡するのに便利です。初期プロジェクトディレクトリは、`hermes desktop –cwd <path>` (または環境変数 `HERMES_DESKTOP_CWD`) で設定できます。

 

音声

Hermesに話しかけると、その声が返ってきます、他所と同様の音声モードです。macOSでは、マイクへのアクセスを許可するよう一度だけ求められます。

 

設定とオンボーディング

YAML を編集するのではなく、実際の UI からプロバイダー、モデル、ツール、認証情報を管理できます。初回起動時のオンボーディングは、数秒で最初のメッセージを表示します。設定パネルでは、プロバイダー/キー、モデル選択、ツールセット構成、MCP サーバー、ゲートウェイ、セッション管理を網羅しています。

  • プロバイダー設定パネル – 推論プロバイダーを管理するための専用エリアで、プロバイダーごとにサインインと認証情報の保存を行うためのアカウント / APIキーのユーザーインターフェースを備えています。

  • メニュー内のすべてのプロバイダーとモデル – GUI にはプロバイダーの全リストと `hermes model` が認識しているすべてのモデルが表示されるため、(厳選されたサブセットではなく) CLI が認識するのと同じカタログから選択できます。

  • xAI Grok OAuth — Grok はランチャーにおけるファーストクラスの OAuth プロバイダーです; 他の OAuth プロバイダーと同様に、ブラウザフローを通じてサインインできます。

  • GUI からのツールバックエンドのインストール — ツールバックエンドのセットアップ後のインストール・ステップを、ターミナルに切り替えることなく、アプリから直接実行できます。

  • 補助モデルに関する警告 — メインモデルを新しいプロバイダーに切り替えた際に、補助タスク (タイトル付け、要約、その他類似のヘルパー) が別のプロバイダーに固定されている場合、アプリは警告を表示し、意図せず 2 つのプロバイダーに作業が分散してしまうことを防ぎます。

初回起動時のオンボーディングは、統一されたオーバーレイ・デザインシステムに基づいて再設計されており、Choose provider later を選択することで、プロバイダーの設定をスキップしてまずはアプリを起動できます。

 

アップデート

アプリはバックグラウンドでアップデートを確認し、アップデートが準備でき次第、ワンクリックでアップデートできます。

手動アップデートも GUI から操作可能です。

 

アンインストール

`設定 → 情報 (About) → Danger zone` を開き、どれだけ削除するかを選択してください :

  • チャット GUI のみをアンインストール — デスクトップアプリとそのデータが削除されます; Hermes エージェント、設定ファイル、チャット履歴は残ります。(`hermes uninstall –gui` と同じです。)

  • GUI + エージェントをアンインストールし、データは保持する —
    アプリとエージェントは削除されますが、設定、チャット、およびシークレットは将来の再インストールのために保持されます。(`hermes uninstall` と同じ。)

  • すべてをアンインストール – アプリ、エージェント、およびすべてのユーザーデータが削除されます。(`hermes uninstall –full` と同じ。)

 

以上