HermesでOllamaモデルが表示されない：カタログとプロバイダーの確認

Ollama モデルが Hermes のピッカーから消えた場合は、設定を触る前にバージョンを確認してください。この症状を正確に引き起こすネイティブカタログのキャッシュバグは、2026年9月17日に完了としてクローズされ、修正はタグ v2026.9.21（hermes-agent 0.21.4）には含まれていますが、v2026.9.14 には含まれていません。 ただし、クローズされたこの報告がすべてではありません。2026年9月21日時点で、ピッカーから Ollama モデルが欠落する報告がさらに2件オープンしていました。また、表示モデル一覧が一度でもカスタマイズされたプロバイダーで同じ症状を引き起こす Hermes Desktop の仕組みについて、別のオープン Issue が存在し、同じタグの出荷済みソースにもその動作が残っていることを確認しました。4つ目の一般的な原因は、そもそも不具合ではありません。それぞれに異なる手掛かりがあり、このページはその手掛かりを示すためのものです。

まず、検索結果で混同される2つを区別します。Hermes Agent は Nous Research の Python エージェントです（MIT、アーカイブ済みではなく、GitHub API によると最終プッシュは2026年9月21日）。Hermes 3 と Hermes 4 は同じ研究所のオープンウェイト LLM ファミリーであり、まったく別の製品です。また、Hermes という無関係な JavaScript エンジンもあります。これらのバージョン番号はここには適用されません。そして、ローカル Ollama は Ollama Cloud ではありません。Hermes は Custom Endpoint フローを通じてポート 11434 の無料ローカルランタイムに接続します。一方、Ollama Cloud は独自のプロバイダースラッグと独自のキャッシュファイルを持つ、別個の有料製品です。一方でモデルが欠落していても、もう一方については何も分かりません。

3つの層が一致する必要があり、そのうち Ollama なのは1つだけです

「モデルがピッカーにない」というのは3つの層の最後についての発言であり、診断では、最初に一致しない層を見つけます。

# 1. Does Ollama itself list the model? This is the native catalog
#    Hermes reads when the endpoint qualifies for the /api/tags branch.
curl -s http://127.0.0.1:11434/api/tags | jq '.models[].name'

# 2. Does the OpenAI-compatible surface list it too? This is what a
#    generic custom endpoint is probed on.
curl -s http://127.0.0.1:11434/v1/models | jq '.data[].id'

第1層で除外すべき点が1つあります。ollama list には埋め込みモデルも含まれますが、埋め込みモデルはコーディングエージェントが選択できるチャットモデルではありません。Kunavo も埋め込み、音声合成、音声認識モデルを提供していないため、ホスト型ルートで解消できる不足ではありません。

まずバージョンを確認し、注意深く読み取る

Issue #112898 — 「ローカル Ollama モデル一覧がピッカーでちらつく」 — は 完了としてクローズされています。2026年9月16日にオープンし、2026年9月17日にクローズされました。Pull request #113129 が修正をコミット d6d6565 としてマージし、GitHub の比較では、そのコミットがタグ v2026.9.21 に含まれ、v2026.9.14 には含まれないことが示されます。v2026.9.21…d6d6565 の比較は、先行するコミットが0件でステータス behind を返すため、そのコミットがタグの祖先であることを示します。一方、v2026.9.14…d6d6565 の比較は、遅れているコミットが0件でステータス ahead を返すため、タグがコミットの祖先であり、その逆ではないことを示します。投稿者自身の #112900 はまだオープンしていますが、これは修正が main に含まれていないことを示すものではありません。その内容は、作成者情報を保持したまま、マージされたプルリクエストにチェリーピックされています。すべての状態は、2026年9月21日に GitHub API から読み取りました。

ここが落とし穴です。その1つのタグの中に、異なる2つのバージョン番号が含まれています。v2026.9.21 では、pyproject.toml の記載は version = "0.21.4"、apps/desktop/package.json の記載は "version": "0.17.6" です。そのため、「Hermes Desktop 0.17.6」という見出しのバグ報告は、古いビルドではなく現在のビルドについて述べていることになります。このような報告を古いものとして退けると、自分の証拠の時期を誤って判断することになります。バージョン確認の限界にも注意してください。ここで確認したのは、そのコミットが git のタグに含まれているかどうかです。実際にインストールした pip リリース、Homebrew formula、コンテナイメージ、デスクトップ自動更新チャネルにそのコミットが含まれるかどうかは、ここでは検証していません。

5つの原因と、それらを分ける手掛かり

このうち2つについては、それぞれ説明しておく価値があります。デスクトップのモデル一覧が更新されなくなる現象は、キャッシュの問題と最も誤解されやすいものです。タグ v2026.9.21 の apps/desktop/src/store/model-visibility.ts を読むと、プロバイダーに保存済みキーが1つでもある場合、レンダラーはプロバイダーのデフォルト値のマージを完全にスキップするため、後から検出されたモデルがメニューに入ることはありません。問題 #114369 は、discover_models: true を持つカスタムプロバイダーでまさにこれを再現し、修正済みではなく重複としてクローズされました。再現には vLLM エンドポイントが使われているため、この仕組みは Ollama の再現例ではなく、プロバイダーに依存しないものとして扱ってください。さらに2件が未解決のままオープンしています。#89874 はカスタム Ollama プロバイダーでモデルが1つも表示されない問題で、needs-repro ラベルが付いているため、確定した不具合ではなく未確認の報告です。#71169 は Ollama API には存在するモデルがデスクトップのドロップダウンには表示されない問題です。いずれかが #112898 と根本原因を共有しているかどうかは確認されていません。

デスクトップでの症状は、予想よりもはっきりしています。そのタグの model-catalog-menu.tsx では、折りたたまれたファミリー一覧が空のプロバイダーは完全にスキップされます。そのため、通常は「プロバイダーに空の一覧が表示される」ではなく、「プロバイダーが消えた」という不満になります。

通常のピッカー表示で古い一覧が表示される理由

これは、この種類の障害全体の基盤となる仕組みであり、一度理解しておく価値があります。通常のピッカー表示では、現在のカスタムエンドポイントだけがライブでプローブされ、その他の設定済みエンドポイントはすべて $HERMES_HOME/provider_models_cache.json のディスクキャッシュから応答されます。HERMES_HOME のデフォルトは ~/.hermes ですが、上書き可能なのでパスを決めつけないでください。タグ v2026.9.21 の hermes_cli では、再プローブを3つのウィンドウが制御します。

これらは文書化された設定ではなく、内部ソースの定数です。今回の確認では、この3つに対するユーザー向けの設定項目は見つかりませんでした。そのコードには、知っておく価値のある意図的な例外が1つあります。空のネイティブカタログは短い TTL の間だけ権威あるものとして扱われ、古いデータとして提供されることはありません。これは、最初の表示時にモデルがなかった Ollama が、7日間のウィンドウ全体にわたって新しく取得したモデルを隠さないようにするためです。また、キャッシュ行は正規化された URL と、認証情報、API モード、追加ヘッダーのフィンガープリントを組み合わせたキーで管理されます。これは、異なるキーを持つ複数のプロバイダー行が、1つのプロキシ URLを正当に共有できるためです。実際の結果として、キーのローテーション、トランスポートの変更、または extra_headers の編集は、その行のキャッシュエントリを無効にします。そして次のプローブなしの表示では、何かが更新するまで空として表示されます。

確認する順序

1. Ollama に存在することを確認します。上記の2つの curl を実行してください。/api/tags にモデルが一覧表示されない場合、下流のどの層にも表示されません。
2. バージョンを確認します。タグ v2026.9.21 より古いビルドを使用していて、症状が正しい一覧と空の一覧の間でちらつく場合は、すでに修正済みのバグに遭遇しています。デバッグする前にアップグレードしてください。
3. 強制的に更新します。hermes model の --refresh フラグは、モデルピッカーのディスクキャッシュを消去し、すべてのプロバイダーのライブ一覧を再取得すると、そのヘルプテキストで説明されています。1つだけではなく、すべてのプロバイダーのキャッシュが消去される点に注意してください。セッション内では、スラッシュコマンドのリファレンスに /model --refresh がプロバイダーのモデル一覧を再取得すると記載されています。また、デスクトップには新しいカタログを要求する明示的な「Refresh Models」コントロールがありますが、通常の表示では1時間のキャッシュが使われます。
4. エンドポイントに適用されるプローブパスを確認します。ネイティブの /api/tags 分岐は、プロバイダー名が ollama の場合、名前が custom:ollama または -ollama で終わる場合、URL が設定済みの Ollama ベース URL と一致する場合、または曖昧なカスタム URL が ポート 11434 で実際に /api/tags に応答する場合に使われます。別のポートで提供され、単純な custom 名が付いた Ollama は、代わりに汎用の /v1/models プローブにフォールスルーします。これはコードパスがそう動作すると読めるという意味であり、フォールバックが実際に機能することを確認するためにここでは実行していません。
5. 検出自体が問題なら、検出を停止します。 discover_models のデフォルトは true です。false に設定すると、ピッカーにはライブプローブではなく、設定したリストが表示されます。
6. デスクトップメニューだけが正しくない場合、 おそらく #107391 のケースです。更新では解消しません。バックエンドはモデルを返しますが、レンダラーのキュレーション層がそれを除外します。

providers:
  # The published reference documents `api` for a providers entry.
  local-ollama:
    api: http://127.0.0.1:11434/v1
    # No key for local Ollama. Discovery is on by default; turn it off and
    # hand-write the list when the probe is the thing that is failing.
    discover_models: false
    models:
      - qwen3-coder:30b

model:
  default: qwen3-coder:30b
  provider: custom:local-ollama

繰り返し問題になる設定の詳細が1つあるため、ここで整理しておきます。リファレンスでは、api を providers: エントリのベースURLキーとして記載しており、そのエントリのフィールド一覧では base_url と url を使用可能な別名として挙げています。一方、base_url はトップレベルの model: マッピング内で別途使われるキーです。また、以前の設定ではトップレベルの custom_providers: リストで、api の代わりに base_url を使用していたことも記録されています。この形式は引き続き動作し、設定v12での hermes update 時に自動移行されます。トラッカーのバグ報告が両方の書き方で記述されているのは、両方が読み込まれる場合に予想されることです。したがって、反映されない providers: エントリがこのキー名で失敗している可能性は低く、エンドポイントとエントリの他のフィールドを確認してください。

別途、触れておく価値のある詳細があります。Ollama自身のHermesページでは、セットアッププロンプトを「Context length in tokens [leave blank for auto-detect]」として案内しています。一方、Hermesのプロバイダードキュメントでは、エージェント用途に少なくとも 64,000トークン が必要で、それ未満しか提供しないローカルエンドポイントは起動時に拒否されると説明しています。どちらも2026年9月21日に確認済みです。フィールドを空欄にすること自体は誤りではありませんが、小さなコンテキストウィンドウしか提供しないサーバーへの対策にはなりません。そのため、サーバー側でウィンドウを広げるか、Hermesの設定で固定してHermesが要求する数値に合わせてください。また、この失敗では、サーバーが提供するウィンドウの大きさを示す起動拒否が発生し、ピッカーの行が欠落するわけではないことにも注意してください。

確認してから、ローカル利用に価値があるか判断する

変更後は、次の3つを順番に行ってください。--refresh を使わずにピッカーを再度開き、コールド状態で開いたときにモデルが一覧にあることを確認すること、モデルを選択すること、そして生成結果を返す範囲限定のリクエストを1件送信することです。2番目の手順が重要なのは、プローブ直後だけ正しいリストが表示される場合、それが修正ではなくキャッシュのバグの兆候だからです。これらは読者の皆さんが実行するための手順です。このページの執筆にあたって、Hermesのインストール環境、Ollamaのインスタンス、ピッカーはいずれも実際には操作していません。

ローカル利用が今回の作業に見合わないという結論なら、費用の問題は明確に2つに分かれます。ソフトウェアの費用と、モデルの利用費用です。

Ollama CloudのProティアは、年払いの場合は年額$200とも記載されており、各プランには月間利用クレジットが含まれます。Proは$60、Maxは$300、Teamは共有で$1,000です。これらはクラウド製品に関するものであり、修正対象のローカルエンドポイントには適用されません。

従量課金ルートについて、ここでは実測した作業コストでも請求額の上限でもない、説明用のトークン計算を示します。1回のセッションで、キャッシュされていない入力トークンを200,000個送信し、出力トークンを12,000個受け取るものとします。キャッシュ読み取りはなく、外部ツール料金もないものとします。料金は、100万トークンあたりのKunavoカタログの最新価格です。

予算として扱う前に、1日あたりの自分のセッション数に応じて拡大してください。また、掲載料金が最安であることと、作業完了までのコストが最も低いことは別の主張です。3回の試行が必要な安価なモデルは、1回で済むモデルより高くつく場合があります。Kunavoのカタログ金額は上限ではなく請求の下限です。上流プロバイダーが料金を報告した場合、請求額はカタログコストと、適用されるマークアップを掛けた上流コストのうち大きい方になります。請求の詳細を参照してください。

どのルートが優れているかは作業によって異なります。ローカルOllamaは、ハードウェアと64,000トークンの最小要件が実質的な制約となりますが、小規模、プライベート、またはオフラインの作業をリクエストごとの料金なしで行う場合に適しています。ベンダーの直接APIは、1つのベンダーのフラッグシップモデルを中心に使い、その独自のキャッシュ条件やバッチ条件を利用したい場合に適しています。ゲートウェイは、作業ごとにモデルを切り替え、1つのキーと残高を使いたい場合に適しています。サブスクリプションは、トークン単位の従量課金より定額で日々大量に使う方が適している場合に有利です。

Hermesの接続先を変更する

ローカルの隣にホスト型エンドポイントを追加する場合、仕組みは同じカスタムプロバイダーのフローです。ただし、試す前に知っておくべき制約があります。プロバイダーの追加は、セッションの外で hermes model を実行して行います。セッション内の /model は、すでに設定されたプロバイダー間を切り替えるだけで、プロバイダーの追加やキーの受け付けはできません。Hermes AgentのカスタムAPIでは、エントリ形式、トランスポート、ロールバックを詳しく説明しています。Hermes Agentの料金では、4つの別々の請求について説明しています。Kunavoが公開しているのは互換性テストではなく設定リファレンスです。この作業ではHermesをKunavoのエンドポイントに対してランタイムテストしていないため、ここに記載した内容は、Hermesのモデル検出がそのエンドポイントで成功することを立証するものではありません。試す間も、現在動作しているルートは維持してください。OllamaのOpenAI互換APIでは、同じクライアントコードで両方に接続できる理由を説明しています。キーに入金したい場合は、Kunavoアカウントを作成してください。

デバッグではなくクライアント選びを続けていますか？Hermes Agentの代替製品とOpenAI互換APIで、より広い選択肢を説明しています。

よくある質問

2026年9月21日に確認した内容と方法：issueとプルリクエストの状態、両方の修正を含むタグ、最新リリースタグ、リポジトリのライセンスおよびアーカイブ状態は、GitHub APIから取得しました。キャッシュ定数、検出のゲーティング、デスクトップの可視性ストア、--refreshのヘルプ文字列、ドキュメントの引用は、タグv2026.9.21のソースから読み取りました。Ollamaの料金ページ、Ollama独自のHermes統合ページ、Nous Portalのプラン一覧も同日に取得しました。確認していないもの：インストールしたpip、Homebrew、コンテナ、またはデスクトップの自動更新アーティファクトに、いずれかの修正が含まれているかどうか。ここではランタイムテストを一切行っていません。Hermesはインストールせず、Ollamaも起動せず、ピッカーも開いていません。Kunavoのトークン料金は最新カタログから取得しており、ドルの例は実測した作業コストではなく、説明用のトークン計算です。