Transformers のエラー：読み込み、API 変更、モデルのダウンロードを切り分ける

最初に失敗した段階を特定する

Transformers の資料では、インストール、モデルのキャッシュ、オフラインでの使用は別の事項として説明されています。from_pretrained() の処理ではリポジトリのファイルを取得する場合があるため、パッケージの読み込みに成功しても、特定のモデルリビジョンがローカルにあるとは限りません。インストールとキャッシュ（英語）

python -c "import sys; print(sys.executable); import transformers, huggingface_hub; print(transformers.__version__, huggingface_hub.__version__)"

確認には、ComfyUI を起動する実際の Python 実行ファイルを使います。traceback 全体とノードが宣言する依存バージョンを残します。モジュールが見つからない場合は、まず Python の実行ファイルやパッケージの検出を確認します。cannot import name の場合は、自動的にアップグレードするのではなく、要求されたシンボル、インストール済みパッケージのバージョン、ノードの API を比較します。モデルの読み込み中に失敗した場合は、リポジトリ ID、正確なリビジョン、要求されたファイル名、キャッシュの場所、HTTP または認証のエラーを記録します。Hub のダウンロード API では、ファイルとリビジョンを別々に選択します。Hub のダウンロードガイド（英語）

ダウンロードに失敗したという理由だけで、新しいメジャーバージョンへアップグレードしないでください。オフラインで使う場合は、どのモデルファイルがすでにキャッシュされているか、また呼び出しに HF_HUB_OFFLINE=1 と local_files_only=True がそれぞれ使われているかを記録します。後者は from_pretrained() のオプションであり、すべてのノードやプラグインがオフラインのまま動作する保証ではありません。最初の調査としてキャッシュ全体を削除することは避けてください。オフライン利用の手順（英語）

制御された変更を一つだけ行い、同じモデルの識別情報と小さな入力で再テストします。読み込み、ファイル取得、モデル初期化、推論をそれぞれ個別に記録します。trust_remote_code=True を使う経路では、リポジトリが提供するカスタムモデルコードを読み込みます。読み込みやダウンロードのエラーに対する汎用的な修正として扱わず、有効にする前に公開元とコードを確認してください。カスタムモデル（英語）

関連する確認

• aiohttp と requests：ライブラリ不足は接続失敗ではない
• safetensors パッケージの不足か、重みファイルの読み込み失敗か：分けて原因を調べる

出典と英語原文を確認した日付は 2026-09-26 です。パッケージ、モデル、GPU の実行や、ダウンロード・認証のテストは行っていません。各段階は編集上の案内であり、お使いの環境の診断ではありません。