Spandrel はインストール済みなのにモデルを読み込めない：アーキテクチャの対応状況を確認する

インストールは最初の確認にすぎない

Spandrel は、文書化された PyTorch モデルアーキテクチャの一部を検出して読み込みます。すべての PyTorch チェックポイントに対応するわけではありません。README にはアーキテクチャの一覧があり、spandrel_extra_arches を通じてのみ利用できるものには + が付いています。この追加パッケージには、より制限の厳しいライセンスのアーキテクチャが含まれるため、インストールと意図する用途をそれぞれ確認する必要があります。Spandrel README（英語）

python -c "import sys; print(sys.executable); import spandrel; print(spandrel.__file__)"

ComfyUI の起動に使われるものと同じ Python インタープリターで実行し、呼び出し元のノードのリビジョン、モデルの公開元、元のリリース、正確なファイル、リビジョンを記録します。README には、対応アーキテクチャで使える形式として .pth、一部の .pt と .ckpt、.safetensors が記載されています。拡張子だけではアーキテクチャへの対応は確認できません。対応ファイル形式（英語）

インポートの失敗なら、パッケージとインタープリターを確認します。UnsupportedModelError や state dict が認識されない場合は、正確なアーキテクチャとインストール済みのレジストリをそのリリースに照らして確認します。これはファイルが破損している証拠ではありません。上流のコントリビューションガイドでは、重みのキーからレジストリが検出する仕組みを説明しています。予期しないキーや形状がある場合は、ファイルの特定と構造も確認する必要があります。ファイル名を変えてもアーキテクチャは変わりません。アーキテクチャの検出（英語）

必要なアーキテクチャに + が付いている場合、上流の例では、ModelLoader を使う前に spandrel_extra_arches をインポートし、spandrel_extra_arches.install() を呼び出しています。追加パッケージをインストールしただけでは、呼び出し元のノードがそれを登録するとは限りません。環境を変更する前に、ノードとの連携と、モデルおよびアーキテクチャのライセンスを確認します。選んだリリースが対応する、信頼できる出所のモデルと比較します。インポート、アーキテクチャの認識、モデルの読み込み、出力をそれぞれ分けて記録します。モデル固有の失敗を、すべて再インストールする理由として扱わないでください。追加アーキテクチャの設定（英語）

関連する確認

• Kornia の読み込みエラー：基本パッケージ、Torch、オプションの追加機能を確認する
• safetensors パッケージの不足か、重みファイルの読み込み失敗か：分けて原因を調べる

出典と英語原文の確認日：2026-09-26。パッケージのインストール、モデルの読み込み、ComfyUI の実行、GPU での再現確認はしていません。以下は編集上の確認手順であり、お使いのモデルの診断結果ではありません。