safetensors パッケージの不足か、重みファイルの読み込み失敗か：分けて原因を調べる

ファイル拡張子は Python のインストール状態を示さない

Safetensors は Python パッケージとファイル読み込み用のインターフェースを公開しています。インポートの失敗は、特定の重みファイルを解析する前に起こります。その後の SafetensorError は読み込みや形式の問題を示しますが、クラス名だけではダウンロードの破損を証明できません。上流には、無効なヘッダー、サイズ上限、オフセット、不完全なバッファーについて、それぞれ異なるエラーもあります。Safetensors のドキュメント（英語） 読み込みエラーの定義（英語）

python -c "import sys; print(sys.executable); import safetensors; print(safetensors.__version__)"

このコマンドは ComfyUI の起動に使う Python 実行ファイルで実行します。別のインタープリターにパッケージがインストールされていても、現在のインポート失敗は解決しません。インポートに成功した場合は、例外の全文と失敗したパスを保存します。ファイル読み込みエラーの場合は、ダウンロードが未完了なのか、ファイル形式が未対応なのか、選択したファイルが間違っているのかを判断する前に、リポジトリ、リビジョン、パス、実際のバイトサイズ、配布元が提示する整合性確認用の値を記録します。モデル系統の名前だけでは、ファイルを特定できません。

推奨する置き換え手順では、元のファイルを残します。別の候補をダウンロードして比較し、その後でアクティブなファイルと置き換えるか判断します。検証エラーを回避するために拡張子を変更したり、ヘッダーを書き換えたりしないでください。

ライブラリのインポート、単独でのファイル読み込み、ワークフローの読み込みを別々に記録します。ドキュメントに記載された safetensors.torch.load_file は、指定したファイルからテンソルを読み込みます。読み込みに成功しても、そのキーやアーキテクチャが ComfyUI のローダーに適合するとは限りません。Torch API（英語） ローカルで計算したハッシュ値は、ローカルにある 2 つのコピーを比較できます。信頼できる配布元の値と照合した場合に限り、配布元のファイルと一致することを確認できます。

関連する確認

• Spandrel はインストール済みなのにモデルを読み込めない：アーキテクチャの対応状況を確認する
• Transformers のエラー：読み込み、API 変更、モデルのダウンロードを切り分ける

出典と英語本文を確認した日付は 2026-09-26 です。パッケージのインストール、ローカルファイルの読み込み、ComfyUI の実行、GPU での再現は行っていません。以下の手順は編集上の案内であり、ファイルの診断結果ではありません。