どのような問題が発生しましたか？

Stable Diffusion Web UI（Automatic1111）を起動しようとした際に、以下のようなエラーに遭遇ことはありませんか？

「ERROR: failed to build CLIP」というエラーが表示される
「No module named ‘pkg_resources’」という警告が繰り返し出る
「No module ‘xformers’」というメッセージが出て起動しない
起動しようとしても一瞬で落ちてしまう

これらのエラーは、Web UIが起動時に必要なパッケージ（特にCLIPモデルや関連ライブラリ）をビルド・管理しようとしたときに発生します。今回はこのような起動失敗エラーの原因と具体的な解決法を解説します。

結論：最も効率的な解決策

launch_utils.pyのCLIPパッケージURLを修正することで、多くの起動エラーが解決します。特に「pkg_resources」関連のエラーやCLIPビルドエラーに効果的です。また、環境変数や起動オプションの適切な設定も重要です。

具体的な解決手順

手順1：CLIPパッケージのURLを修正する（最も重要）

この方法で多くのユーザーが解決しています。

# 修正対象のファイル
webuimoduleslaunch_utils.py

ファイル内の以下の記述を探して修正します：

# 変更前（問題の発生するURL）
clip_package = os.environ.get('CLIP_PACKAGE', "https://github.com/openai/CLIP/archive/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1.zip")
openclip_package = os.environ.get('OPENCLIP_PACKAGE', "https://github.com/mlfoundations/open_clip/archive/bb6e834e9c70d9c27d0dc3ecedeebeaeb1ffad6b.zip")

# 変更後（安定したバージョン）
clip_package = os.environ.get('CLIP_PACKAGE', "https://github.com/openai/CLIP/archive/aa0c4708d5edf4061ed13815567c8143eb2c542a.zip")
openclip_package = os.environ.get('OPENCLIP_PACKAGE', None)

手順2：xformersエラーの解決

「No module ‘xformers’」エラーが出る場合は、以下の対処法を試してください。

方法A：xformersをインストールする

# Web UIのディレクトリで実行
pip install xformers

方法B：起動時にxformersを無効化する

# webui-user.bat（Windows）または webui-user.sh（Linux）を編集
set COMMANDLINE_ARGS=--disable-xformers

手順3：NVIDIA 16XX/10XX シリーズの対応

古いGPU（GTX 16XX/10XXシリーズ）を使用している場合、以下の起動オプションを追加することで安定動作します。

# webui-user.bat の COMMANDLINE_ARGS に追加
set COMMANDLINE_ARGS=--upcast-sampling --xformers --no-half-vae

オプションの説明：

--upcast-sampling：演算をFP32にアップキャストして互換性を確保
--xformers：高速化ライブラリを使用（インストール済みの場合は効果的）
--no-half-vae：VAEをFP32で実行し、問題が起きる可能性を低減

手順4：完全なクリーンインストール（上記で解決しない場合）

それでも解決しない場合は、Web UIを最初からインストールし直すのが一番の近道です。

# 1. 現在のインストールを削除（venv以外を削除）
rm -rf stable-diffusion-webui

# 2. リポジトリをクローン
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git

# 3. 再起動
./webui.sh

補足・注意点

Pythonバージョンの確認

Stable Diffusion Web UIはPython 3.10.6での動作が確認されています。異なるバージョン（3.11以上など）を使用すると、予期しないエラーが発生する場合があります。

# バージョンの確認
python --version

CUDA/CuDNNの互換性

エラーが解決しない場合は、CUDAバージョンの確認も重要です。

# CUDAバージョンの確認
nvidia-smi

仮想環境（venv）の問題

既存のvenvに問題がある場合、新規作成すると解決することがあります。

# venvを削除して再作成
rm -rf venv
python -m venv venv

Windowsでの特別な注意

Windows環境では、webui-user.batをメモ帳ではなく必ずテキストエディタで編集してください。また、PATHに日本語が含まれていると問題が発生しやすいので、英数字のパスにインストールすることをお勧めします。

まとめ

Stable Diffusion Web UIの起動エラーは、CLIPパッケージのURL変更ほとんど場合解決します。特に「pkg_resources」や「CLIP build」関連のエラーは、この方法で高い確率で解決可能です。古いGPUを使用している場合は、起動オプションの追加も効果的です。

もしこれらの方法で解決しない場合は、Web UIのバージョンが古くなっている可能性があるため、最新版に更新するか、クリーンインストールを試してください。

【Stable Diffusion Web UI】CLIPビルドエラーや起動失敗の完全解決法