メインコンテンツへ移動
Nowledge MemNowledge Mem

Hermes Agent × Nowledge Mem

Hermes v0.7.0+ 向けのネイティブメモリプロバイダーです。利用可能な場合は起動時にContext Bundleが読み込まれ、毎ターンの前にrelevant knowledgeが表示され、HermesはクリーンアップされたトランスクリプトのターンをMemスレッドに取り込みます。

エージェント向け

この行をエージェントに渡してください。 まずユニバーサルインストールスキルを使用する必要があります。 このページは動作とトラブルシューティングのリファレンスとして残ります:

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Hermes Agent. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.
One-command setup (plugin)
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)
Windows PowerShell
irm https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.ps1 | iex

プラグインネイティブ

Hermes v0.7.0+ はメモリプロバイダーをサポートしています。 一度プラグインをインストールすると、組み込みの動作が有効になります:利用可能な場合はセッション開始時にContext Bundleが読み込まれ、毎ターンの前にrelevant memoriesが表示され、会話の実行中にHermesがクリーンアップされたトランスクリプトのターンをMemスレッドに取り込みます。 SOUL.mdのガイダンスは不要です。

スタンドアロンプロバイダー

Hermesは新しいメモリプロバイダーをコアのhermes-agentリポジトリの外に置いています。 このページのインストーラーはサポートされているNowledge Memのパスです:プロバイダーを~/.hermes/plugins/nowledge-mem/に配置し、Hermesは同じメモリプロバイダーのライフサイクルを通じてそれを読み込みます。

あらゆるツールをまたぐあなたの知識を、すべてのHermesセッションで利用できます。 Claude Codeでの決定、Cursorでの好み、ChatGPTからの洞察:ひとつのナレッジグラフが、いつでも利用可能です。

最初の成功状態

プラグインをインストールし、Hermesを再起動して、新しいセッションを開始してください。 一意のフレーズを含む短いメッセージを1つ送信し、その後クリーンに終了するか、/newを実行するか、/resetを実行してください。 nmem t search "that phrase" --source hermesが取り込まれたHermesスレッドを見つけるはずです。 Memライブラリにすでにメモリがある場合は、「最近どのような決定をしましたか?」と尋ねてみてください。 Hermesは、あなたがツールを指定しなくても、あなたのナレッジグラフを検索するはずです。

古い Hermes セッションがありますか?

プラグインは、実行される新しいHermesセッションを取り込みます。 ~/.hermes/state.dbにすでに存在する会話をインポートするには、Hermesがインストールされているマシンから履歴同期を実行してください:

nmem t sync --from hermes          # preview only
nmem t sync --from hermes --apply  # import into Mem

これはリモートMemにとっても正しい方法です:ノートパソコンがローカルのHermesデータベースを読み取り、正規化されたスレッドをnmem statusで設定されたMemサーバーにアップロードします。

始める前に

  • Nowledge Memがローカルで実行されている(インストール)、または到達可能なリモートサーバー
  • Hermes Agent v0.7.0+ がインストールされている(v0.6.xはMCPモードで動作します)
  • nmem CLIがPATHで利用可能。 デスクトップアプリがこのマシンにある場合は、Settings → Preferences → Developer Tools → Install CLIを使用してください。 リモート専用のマシンでは、pip install nmem-cliでインストールしてください。
nmem status       # Nowledge Mem is running
hermes --version  # Hermes is available

セットアップ

bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)

ネイティブメモリプロバイダープラグインをインストールします。 実行後にHermesを再起動してください。

Windowsでは、ネイティブのPowerShellインストーラーを使用してください。 Git BashやWSLは必要ありません:

irm https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.ps1 | iex

または手動でインストールします:

  1. プラグインファイルを~/.hermes/plugins/nowledge-mem/にコピーします:
    mkdir -p ~/.hermes/plugins/nowledge-mem
    cd ~/.hermes/plugins/nowledge-mem
    for f in plugin.yaml __init__.py provider.py client.py; do
      curl -sLO "https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/$f"
    done
  2. ~/.hermes/config.yamlでプロバイダーを設定します:
    memory:
      provider: "nowledge-mem"
  3. Hermesを再起動します。

MCPモード(Hermes < v0.7.0)

古いバージョンの Hermes を使用している場合、または標準の MCP 接続を希望する場合:

bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcp
Windows PowerShell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.ps1))) -Mcp

これにより、MCP サーバーが config.yaml に追加され、~/.hermes/SOUL.md に動作ガイダンスがインストールされます。ツールは mcp_nowledge_mem_ プレフィックス付きで表示されます。

動作ガイダンスがない場合、MCPモードはHermesにツールを提供しますが、いつ積極的に使用すべきかの指示はありません。 Hermesが想起するだけで保存しない場合、通常はこれが原因です。 プラグインモードでは動作がプロバイダーのライフサイクルに組み込まれているため、ガイダンスは不要です。

確認

まず、空のライブラリでも安全なチェックでスレッドの取り込みを確認します。 Hermesで次を送信してください:

Please reply with: hermes nmem smoke test

その後クリーンに終了するか、/newを実行するか、/resetを実行して、Hermesが最終的なスレッドフラッシュを実行できるようにします。 ターミナルで確認します:

nmem t search "hermes nmem smoke test" --source hermes

Hermesスレッドが表示されるはずです。 その後、Memライブラリにすでにメモリがある場合は、過去の作業に依存することをHermesに尋ねてください:

What decisions have I made recently?

プラグインモードでは、Hermesはnmem_searchを呼び出すはずです。 MCPモードでは、mcp_nowledge_mem_memory_searchを呼び出すはずです。 次に、Hermesに結論を保存するよう依頼するか、会話が永続的な決定に達したときにネイティブのnmem_saveツールを選ぶかどうかを観察してください。

自動的に行われること

プラグインはHermesのメモリプロバイダーのライフサイクルにフックします。 これらには手動のツール呼び出しは不要です:

  • Context Bundleは、利用可能な場合、毎セッションの開始時に読み込まれ、古いCLIではWorking Memoryにフォールバックします
  • Relevant memoriesは毎ターンの前に表示されます(プロアクティブな想起)
  • ユーザープロファイルの事実 がHermesからあなたのクロスツールナレッジグラフに同期されます
  • セッショントランスクリプト はターンが完了するたびにMemスレッドに取り込まれ、Hermesが終了するか、新しいセッションを開始するか、クリーンにリセットするときに最終デルタフラッシュが行われます
  • 圧縮リカバリのヒント は、プロバイダーの圧縮出力を消費するHermesビルドで提供されます

MCPモードでは、これらの動作はSOUL.mdのガイダンスに依存し、保証されません。

HermesメモリとNowledge Mem

Hermesには、Hermesセッションに固有の事実のための組み込みメモリシステムがあります。 Nowledge Memは補完的です:ツールをまたぐ知識を保存します。 両方を使用してください:

  • Hermesメモリ:Hermes固有の好み、環境の詳細、ツールの癖
  • Nowledge Mem:あらゆるツールの将来のセッションが知っておくべき決定、手順、学び

プラグインはHermesからNowledge Memへユーザープロファイルの事実を自動的にミラーリングするため、クロスツールの知識は同期されたままになります。

できること

他のツールからの知識を見つける。「データベースについて何を決めましたか?」と尋ねると、HermesはClaude Codeで行った決定、ChatGPTからの洞察、Cursorからのノートを横断して検索します。

あらゆる場所のために知識を保存する。 Hermesで結論に達すると、それはあなたのナレッジグラフに保存され、次のClaude Codeセッション、Cursorプロジェクト、またはChatGPTの会話でもそれを見つけられます。

過去の会話を検索する。 あらゆるツールを横断して、キーワードで過去の会話を見つけます。 ページネーションで完全なやり取りを取得します。

Hermesセッションを検索可能に保つ。 プロバイダーは、会話の実行中にクリーンアップされたuser / assistantのターンをMemスレッドに取り込みます。 クリーンな終了、/new、または/resetが最終デルタフラッシュを実行します。 各Hermes session_idの最初の書き込みがスレッドをインポートし、同じセッションの以降の書き込みは新しいターンのみを追加します。

古いHermesセッションをバックフィルする。 過去のHermes会話は~/.hermes/state.dbにあります。 nmem t sync --from hermesを実行してプレビューし、次に--applyを追加してインポートします。 このコマンドは再実行しても安全です:Hermesのsession_idをMemスレッドIDとして再利用し、メッセージの重複排除を行いながら追加します。

MCPモードでは、決定がどのように進化したかを追跡し、関連するメモリを発見するためのグラフ探索ツールも利用できます。

ツール

プラグインモードではクリーンなnmem_名を使用します。 MCPモードではmcp_nowledge_mem_プレフィックスを使用します。

プラグインMCPモードのツール名目的
nmem_searchmcp_nowledge_mem_memory_searchメモリを検索する
nmem_savemcp_nowledge_mem_memory_add決定、洞察、学びを保存またはアップサートする
nmem_updatemcp_nowledge_mem_memory_update既存のメモリを改良する
nmem_deletemcp_nowledge_mem_memory_delete1つ以上のメモリを削除する
nmem_thread_searchmcp_nowledge_mem_thread_search過去の会話を検索する
nmem_thread_messagesmcp_nowledge_mem_thread_fetch_messagesスレッドからメッセージを取得する

MCPモードにはlist_memory_labels、memory_neighbors、memory_evolves_chainも含まれます。 これらはnmem CLIがサポートした時点でプラグインに追加されます。

設定

ローカルでの使用には設定は不要です。 プラグインはサーバーURLとAPIキーに共有のnmemクライアント設定を使用します。 通常のメモリ操作はnmemを経由します。 長いトランスクリプトのペイロードはMem APIに直接送信されます。

Nowledge Memデスクトップアプリが同じマシンにある場合、nmemはすでにバンドルされています。 デスクトップアプリのないリモート専用のセットアップの場合:pip install nmem-cli。

リモートアクセス

ローカルのnmemクライアントをリモートサーバーを指すように設定します:

nmem config client set url https://your-server
nmem config client set api-key your-key

これはHermesを実行しているマシンのクライアント側接続設定を更新します。 Memホスト上のサーバー側のAccess AnywhereやLANバインド設定とは別のものです。

プラグイン固有の設定は、~/.hermes/nowledge-mem.jsonのリクエストタイムアウトのみです:

{
  "timeout": 60
}

スペース

Hermesは3つのクリーンなマッピングレベルをサポートしています:

  • space:このHermesプロファイル用の1つの固定レーン
  • space_by_identity:HermesのIDから名前付きスペースへの小さな明示的なマップ
  • space_template:HermesのIDごとに1つの派生レーン、例えばagent-{identity}

これらのいずれも設定されていない場合、HermesはNMEM_SPACEを継承できます。

MCPモードでは、config.yamlでURLを直接更新します:

~/.hermes/config.yaml
mcp_servers:
  nowledge-mem:
    url: "https://your-server/mcp"
    headers:
      Authorization: "Bearer your-key"
    timeout: 120

Access Mem Anywhereを参照してください。

更新

インストールしたのと同じモードを使用してください:

  • プラグインモード(Hermes v0.7.0+ のデフォルト):フラグなしでセットアップコマンドを再実行し、Hermesを再起動します。
  • MCPモード(Hermes v0.6.xまたは意図的な標準MCPセットアップの場合):--mcpを付けてセットアップコマンドを再実行し、Hermesを再起動します。
# Plugin mode
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)

# MCP mode
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcp

MCPツール自体はNowledge Memによって提供され、デスクトップアプリとともに更新されます。 Hermesプラグインファイルはセットアップスクリプトを通じて更新されます。

更新後、スクリプトはHermesが読み込むファイルからバージョンとエンドポイントを出力します:

Installed version: 0.5.18
Thread import endpoint: /threads/import

これらの行がまだ古いバージョンや異なるエンドポイントを示している場合、Hermesは別のHERMES_HOMEを読み込んでいます。 HERMES_HOMEを、Hermesの起動に使用するプロファイルに設定し、セットアップコマンドを再度実行してから、Hermesを再起動してください。

無効化またはロールバック

ファイルを変更する前にHermesを終了してください。

  • プラグインモード:~/.hermes/config.yamlのmemory.providerを以前のプロバイダーに戻すか、以前にHermesメモリを使用していなかった場合はその行を削除します。 次に~/.hermes/plugins/nowledge-memを削除します。 互換性コピーが必要だった古いHermesビルドでは、~/.hermes/hermes-agent/plugins/memory/nowledge-memも削除します。
  • MCPモード:~/.hermes/config.yamlからmcp_servers.nowledge-memブロックを削除します。 動作ガイダンスが不要になった場合は、~/.hermes/SOUL.mdから# Nowledge Mem for Hermesという見出しのセクションを削除します。
  • Hermesを再起動し、hermes --versionとnmem statusを実行して、ホストとMemクライアントがまだ正常であることを確認します。

安全にカスタマイズする

インストールされたプラグインディレクトリではなく、Hermes自身のガイダンスファイルを使用してください:

  • ~/.hermes/SOUL.md:セッションをまたぐ個人的なデフォルト動作
  • HERMES.md:リポジトリ固有のルールのためのプロジェクトルート

~/.hermes/plugins/の下にあるインストール済みのNowledge Memプラグインファイルにパッチを当てないでください。 ホストごとの完全なマップについては、Customize Integration Behaviorを参照してください。

トラブルシューティング

Nowledge Memに接続できません。 nmem statusでサーバーが実行されていることを確認してください。 URLがnmem statusで表示されるアドレスと一致することを確認してください。

Hermesは想起するが、永続的なメモリを決して保存しない(MCPモード)。 動作ガイダンスが欠けています。 セットアップコマンドを実行してから、Hermesを再起動してください。 ガイダンスは~/.hermes/SOUL.md(常に読み込まれる)またはgitルートのHERMES.mdにある必要があります。 プラグインモードでは、想起とトランスクリプトの取り込みはプロバイダーのライフサイクルに組み込まれており、ガイダンスに依存しません。

HermesスレッドがMemに表示されません。 プロバイダーは完了したターンを取り込み、実際のセッション境界でもフラッシュします。 通常の完了したターンでテストし、次にクリーンな終了、/new、または/resetを試してください。 ターンの途中でHermesが突然強制終了された場合、その未完了のターンはプロバイダーに到達しない可能性があります。

エージェントがclient.pyはcommunity/mainと異なると言います。 これは通常、Hermesが古いローカルプラグインコピーを実行していることを意味します。 プラグインのセットアップコマンドを再実行し、Thread import endpoint: /threads/importが出力されることを確認して、Hermesを再起動してください。 ~/.hermes/plugins/nowledge-mem/の下のファイルを編集するのではなく、カスタム動作にはSOUL.mdまたはHERMES.mdを使用してください。

古いHermesセッションがありません。 これは履歴インポートを実行するまで想定される動作です。 デスクトップのウォッチャーはHermesのSQLiteデータベースを読み取りません。 nmem t sync --from hermesを実行して~/.hermes/state.dbから古いセッションをプレビューし、プレビューが正しければnmem t sync --from hermes --applyを実行してください。

ツールが表示されない(プラグイン)。 config.yamlのmemory.provider: "nowledge-mem"と、~/.hermes/plugins/nowledge-mem/にプラグインファイルが存在することを確認してください。 Hermesを再起動してください。

ツールが表示されない(MCP)。 config.yamlのmcp_servers.nowledge-memブロックを確認してください。 Hermesを再起動してください。 YAMLが有効であることを確認してください(正しいインデント、タブなし)。

応答が遅い。 デフォルトのタイムアウトは30秒です。 nowledge-mem.json(プラグイン)またはconfig.yaml(MCP)で増やしてください。 問題が解決しない場合は、サーバーの状態についてnmem statusを確認してください。

このページの内容