Stable Diffusionのインストール中にCLIPライブラリのビルドエラーが発生するケースがあります。特にWindows環境で、pipやsetuptoolsのバージョンを更新しても解決しない場合があります。ここでは、一般的な原因と対策を整理します。
1. エラーの原因
表示されるエラーは「Failed to build CLIP」とあり、pipがソースからホイールを作成できないことを示しています。主な原因は以下の通りです。
- Pythonのバージョンや環境の不整合
- セットアップツール(setuptools)やビルドツール(wheel)のバージョン問題
- Windows向けの依存ライブラリ不足
- Git経由でソースを取得する際の権限やパスの問題
2. 推奨される環境設定
Windowsでの安定動作を確保するために以下を確認します。
- Python 3.10 64bit を使用していること
- pip、setuptools、wheelを最新バージョンにアップグレード
- Visual Studio Build Toolsがインストールされていること（C++コンパイラが必要）
- Gitのパスが通っていること
3. CLIPインストール手順の改善例
既存のコマンドでうまくいかない場合は以下の順序で試します。
- venv環境の有効化:
venv\Scripts\activate - pip, setuptools, wheel更新:
python -m pip install --upgrade pip setuptools wheel - 依存ライブラリの先行インストール:
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 - CLIPをビルドアイソレーションなしでインストール:
pip install git+https://github.com/openai/CLIP.git --no-build-isolation
また、問題が解決しない場合は、公式に配布されている事前ビルドホイールを利用する方法もあります。GitHubのリリースページや、PyPIで公開されている安定版を参照してください。
4. 追加の対策
それでもエラーが続く場合。
- Pythonの仮想環境を作り直す
- 別のPythonバージョン（例：3.11）で試す
- Windowsの管理者権限でコマンドプロンプトを実行
まとめ
WindowsでのStable Diffusionインストール時のCLIPビルドエラーは、Python環境やビルドツール、依存ライブラリの不整合が主な原因です。pipやsetuptoolsの最新化、Visual Studio Build Toolsの導入、no-build-isolationオプションの利用で多くの場合解決します。必要に応じて仮想環境やPythonバージョンの変更も検討してください。
コメント