【ComfyUI】Windows Portable版のPythonバージョン非対応エラーとhuggingface_hubの修正手順

この記事では、ComfyUI Portable版でPythonバージョンの非対応エラーや、huggingface_hubのインポートエラー（cached_download）が発生する問題について解説します。

1. どんな問題（エラー）が発生したか？

• 発生した環境やツール： Windows、ComfyUI Portable版、GTX 1060
• エラーメッセージ： ImportError: cannot import name 'cached_download' from 'huggingface_hub'
• 症状： 起動時に「Unsupported Python version」の警告が表示され、一部のカスタムノードが読み込めない

2. 結論（解決策）

huggingface_hubのバージョンアップで cached_download 関数が削除されたことが原因です。diffusersとhuggingface_hubを最新版に更新することで解決します。

3. 具体的な手順

Step 1: 影響パッケージのアップグレード

cd ComfyUI_windows_portable
.\python_embeded\python.exe -m pip install --upgrade diffusers huggingface_hub transformers

Step 2: ComfyUI本体の更新

# update_comfyui.bat を実行
# または手動でgit pull
cd ComfyUI
git pull origin master

Step 3: カスタムノードの依存関係更新

ComfyUI Manager経由でカスタムノードの依存関係を一括更新できます：

1. ComfyUIを起動してManager画面を開く
2. 「Update All Custom Nodes」を実行
3. ComfyUIを再起動

4. 補足・注意点

• Python 3.9〜3.12の使用が推奨されています。3.13以降はまだ多くのカスタムノードが対応していません
• cached_downloadはhuggingface_hub v0.26で完全に削除されました。古いカスタムノードが依存している場合はノード側の更新が必要です
• Portable版ではシステムのPythonとは別の環境を使っているため、python_embededフォルダ内のPythonでパッケージ管理を行ってください

5.
👉 【RunPod】1時間数十円から使える高性能クラウドGPU

参考元

• 本記事は以下のディスカッションを要約・再構成したものです。
• Source: Noob Needs Help – Unsupported Python Version · Issue #5731 · ComfyUI