インストール後も Nunchaku が失敗する：ノード、wheel、モデルの組み合わせを確認する

それぞれを別のコンポーネントとして扱う

Nunchaku のバックエンド wheel、ComfyUI-nunchaku プラグイン、量子化モデルファイルは別々のものです。一つのコンポーネントのインストールが成功しても、ほかのコンポーネントをインポート、読み込み、実行できる証明にはなりません。各コンポーネントの該当リリースのドキュメントと、実行中の ComfyUI インスタンスが表示する Python 実行ファイルを確認してください。バックエンドのインストール（英語） プラグインのインストール（英語）

python -m pip show nunchaku torch
python -c "import sys, platform; print(sys.executable, sys.version); print(platform.system(), platform.machine())"
python -m pip debug

既定のシェルインタープリターだけでなく、ComfyUI が実際に使っている Python で実行してください。これらのコマンドで環境情報は確認できますが、ネイティブ拡張機能、GPU、モデルの動作はテストできません。

wheel 名の読み方

公式の例 nunchaku-0.3.1+torch2.7-cp311-cp311-linux_x86_64.whl は一例であり、どの環境にも使えるインストール URL ではありません。標準の wheel 互換性タグは、末尾にある Python、ABI、プラットフォームの各フィールドです（この例では cp311-cp311-linux_x86_64）。+torch2.7 は配布パッケージのバージョンに含まれる情報です。公開元が示す Torch ビルドの手順とは別に照合してください。pip が受け入れた wheel でも、ネイティブ拡張機能の読み込みに失敗する場合があります。pip のタグ確認を回避するために、互換性のないファイル名を変更しないでください。Nunchaku のインストール（英語） wheel 仕様（英語） pip debug（英語）

失敗した段階を切り分ける

1. インストールまたはインポート： 失敗したインタープリター、pip またはインポート時の完全なエラー、選択した wheel を記録します。プラグインは読み込まれるのに No module named nunchaku と表示される場合、バックエンドが ComfyUI の組み込み Python にインストールされているか確認してください。pip が wheel を拒否した場合は、標準タグを確認します。ネイティブライブラリの読み込みエラーには、Torch、CUDA、プラットフォームの詳細とともに、該当する traceback が必要です。

2. プラグインとバックエンド： 両方のバージョンまたはコミットを記録し、それぞれのインストール手順と照合します。プラグインのインストールページでは、プラグインを先に、バックエンドを後にインストールするよう明記されています。同梱の wheel インストール手順は、ドキュメントに記載されたプラグインのバージョンでのみ利用できます。根拠のない wheel の選択や Torch の一括アップグレードは、サポートされる組み合わせの代わりにはなりません。

3. モデルとハードウェア： インポートとノード登録が動作したら、意図した量子化モデル系統と必要な付属ファイルを使う上流のワークフローを実行します。上流の使用ガイドではモデルファイルを区別し、Blackwell には FP4、それ以外の対応 GPU には INT4 を推奨しています。これを普遍的な性能保証として扱わず、選んだリリースとハードウェアに対応するドキュメントを確認してください。モデルファイルや形状のエラーは、wheel の互換性より後の段階で起きます。プラグインの使用方法（英語）

完了の確認と制限

環境のコピーを使い、同じ ComfyUI インタープリターでバックエンドをインストールしてインポートできること、想定したノードが登録されること、対象の量子化モデルが読み込まれること、最小構成の上流ワークフローで生成できることを確認します。それぞれの結果を個別に記録してください。このサイトでは Nunchaku のパッケージ、wheel、モデル、GPU をインストールも実行もしていません。速度やハードウェア互換性についての主張もしていません。

参照した原文資料

• Nunchaku バックエンドのインストール（英語）（確認日：2026-09-26）
• ComfyUI-nunchaku プラグインのインストール（英語）（確認日：2026-09-26）
• ComfyUI-nunchaku の使用方法とモデル設定（英語）（確認日：2026-09-26）
• Python wheel ファイル名の仕様（英語）（確認日：2026-09-26）
• pip debug リファレンス（英語）（確認日：2026-09-26）

資料と英語原文を確認した日付は 2026-09-26 です。ドキュメントのバージョンやリリースの配布物は変更される場合があるため、作業前に選んだバージョンを確認してください。

関連する確認

• llama_cpp の失敗：インストール、ネイティブビルド、モデル読み込みを区別する
• ComfyUI の修復記録を再現可能な形で残し、秘密情報を公開しない