GGUF ファイルを読み込めない：アーキテクチャと専用ローダーを一致させる
GGUF はコンテナー形式です。任意のチャットモデルファイルが、特定の ComfyUI ノードで拡散モデルやテキストエンコーダーとして使えるとは限りません。
症状と対象範囲
GGUF はコンテナー形式です。任意のチャットモデルファイルが、特定の ComfyUI ノードで拡散モデルやテキストエンコーダーとして使えるとは限りません。
検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。
UnetLoaderGGUF
gguf
unsupported model
出典から確認できること
ComfyUI-GGUF の資料には、対応するネイティブモデルの量子化方法、本体の前提条件、専用の UNet／テキストエンコーダーローダーが記載されています。あらゆる GGUF を画像生成用に変換する汎用ツールではありません。出典 1（英語） 出典 2（英語）
区別すべき状況
1. ファイルに専用 GGUF ノードが必要なのに、通常のチェックポイント／UNET ローダーを使っている。
2. 拡張機能またはその gguf 依存関係が、現在の環境で読み込まれていない。
3. ファイルのアーキテクチャ、量子化、本体のバージョンが、拡張機能の対応する組み合わせの範囲外である。
確認手順
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. 配布元、元のモデル、量子化の種類、ローダークラスを記録します。出典にベースモデルが記載されていない場合は推測しないでください。
手順 2. README で拡張機能のインストール方法とディレクトリのルールを確認します。拡張子を safetensors に変更しても、形式は変換されません。
手順 3. 対応する VAE を維持しながら、拡散モデルとテキストエンコーダーの読み込み経路を個別に確認します。デバイスを強制指定する不要なノードの追加は避けてください。
手順 4. 拡張機能の作者が対応を示している例を使います。本体、拡張機能、gguf のバージョンを比較し、README の macOS Sequoia／M1 バッファーに関する注記は、該当するプラットフォームとエラーが一致する場合に限って適用します。これは Torch 全般の要件ではありません。
完了の確認
対応するアーキテクチャを正しいノードが読み込み、最小限のタスクが完了することを確認します。ファイルサイズが小さいだけでは、速度や品質について確かなことは分かりません。
制限と注意点
一部の機能はまだ実験段階にあるか、開発中です。量子化の影響やハードウェアの性能は、このサイトではテストしていません。
参照した原文資料
- ComfyUI-GGUF README（英語）（再確認日：2026-09-26）
- ComfyUI のモデルのトラブルシューティング（英語）（再確認日：2026-09-26）
出典と英語の表現の確認日：2026-09-26。上流の参照先は再確認済みです。このサイトでモデルを読み込んだり、GPU で実行したり、最小メモリを測定したりしたとは主張していません。実行時の保証もありません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- ComfyUI でノードが見つからない：パッケージの欠落・読み込み失敗・クラス未登録を区別する
Missing Node Types読み込んだワークフローに未解決のノードがあるときは、まずワークフローのコピーと入手元を保存します。ノードの不足表示だけで、そのファイルがコンピューター上にないとは判断できません。 - Float8 は MPS で未対応：保存された重みと計算時の dtype を区別する
Float8_e4m3fn重みの読み込み、逆量子化、演算のどの段階で失敗するかを特定します。ファイルに FP8 と記載されているだけでは、考えられる量子化の実行経路すべてを説明できません。
この記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に、ComfyUI-GGUF の README と ComfyUI のモデルに関するトラブルシューティング資料を再確認しました。このサイトでモデルの読み込み、ワークフローの実行、GPU での実行、最小メモリをテストしたとは主張していません。
01ComfyUI-GGUF README（英語）出典の確認日: 2026-09-2602ComfyUI のモデルのトラブルシューティング（英語）出典の確認日: 2026-09-26問題を報告 · 3935e2ef-76b3-57c8-aab4-5e0cdab20ce9
関連記事
編集者がこのページに関連づけた記事です。
モデル名は、複数の重みをまとめたチェックポイント、分割された重み、量子化版、テキストエンコーダー、VAE を指すことがあります。ワークフローで実際に使った成果物を特定できるよう、十分な識別情報を残します。