参考資料

No module named hydra：hydra-core を確認し、次に設定検索パスを確認する

Hydra の一般的な配布パッケージ名は、インポート名と異なります。モジュール不足と設定不足には、それぞれ別の修復が必要です。

更新日 2026-10-01公開版: 3参照元の版: 7

対象範囲と症状

Hydra の一般的な配布パッケージ名は、インポート名と異なります。モジュール不足と設定不足には、それぞれ別の修復が必要です。

検索の手掛かりとなる断片です。表現や状況は環境によって異なります。

No module named 'hydra'
MissingConfigException

Hydra の導入ガイドでは、hydra-core 配布パッケージをインストールし、hydra をインポートします。設定システムにはアプリケーション固有のエントリーポイントと検索パスがあり、パッケージをインストールしただけでは検証されません。V04-HYDRA（英語）

1. 同じ名前の無関係な配布パッケージがインストールされている。または、目的のインタープリターに hydra-core がない。

2. インポートは成功するが、設定された検索パスが別の場所を指している。@hydra.main(config_path=...) は定義元のスクリプトを基準とし、相対パスの file:// 検索パス項目はプロセスの作業ディレクトリを基準とする。

3. 設定は存在するが、存在しないグループやオーバーライド、別のアプリケーションリビジョンを参照している。

以下は編集上の案内であり、お使いのマシンの診断ではありません。

1. ノードが宣言している依存関係と、実際の環境にある hydra-core のメタデータを確認します。ModuleNotFoundError と設定例外を区別します。

2. インポートが実際に失敗している場合は、サポートされている配布パッケージをインストールします。削除する前に環境を記録し、同名パッケージの競合は推測で決めつけず、実際に確認します。

3. 設定の失敗では、検索されたパスと見つからない名前を記録します。リポジトリが完全か、リビジョンが一致しているかを確認します。起動ディレクトリを変更する前に、実際の Hydra エントリーポイントに従って各パスを解決します。

4. 最小限のテストには、ノード作者がサポートする設定エントリーポイントを使い、その後オーバーライドを一つずつ戻します。別のプロジェクトの YAML ファイルは、互換性のある代替品ではありません。

目的の設定と必要なグループが解決され、最小限の操作が完了することを確認します。hydra をインポートできても、設定の連鎖が検証されたことにはなりません。

デプロイ上の問題を隠すような、根拠のないグローバルな PYTHONPATH や作業ディレクトリの変更は避けてください。設定ログを共有する前に、秘密情報を伏せてください。

出典の確認日：2026-09-27。インストール、GPU 推論、お使いの環境の修復は行っていません。

同じ症状にも異なる原因があります。関連する記事を順に確認してください。

パッケージを導入したのに ComfyUI で ModuleNotFoundError が出るModuleNotFoundErrorターミナルでのインストール成功だけでは、ComfyUI が同じ Python を使っているとは分かりません。読み込み名、配布パッケージ名、実行中の Python を分けて確認します。

匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。

出典に基づく編集上の草稿であり、実行時の検証は行っていません。バージョンに関する記述は対象範囲を限定し、ラッパーが特定できない場合はその旨を明記しています。