Stability MatrixでインストールしたStable Diffusion WebUI起動エラー解決記 〜お茶目な障害との付き合い方〜

こんにちは、AIイラスト愛好家の皆さん。今日は、Stability Matrixを使っていて遭遇するかもしれない、ちょっとした起動エラーについてお話しします。お茶でも飲みながら、気軽に付き合ってください。

ちなみに、この記事は最後まで無料で読むことができます。
もしこの記事がお役に立てたならちょっとしたお小遣いを頂けるととても励みになります。

使用環境

今回のトラブルシューティングは、以下の環境で行いました。

• マシン: MacBook Pro M3 Max

• Stable Diffusion WebUI バージョン: 1.9.0

なお、使用している環境によって症状や解決方法が異なる場合がありますので、ご了承ください。

思わぬ伏兵

Stable Diffusion WebUIって便利ですよね。
でも、バージョンアップや新しいツールの導入って、なんだかんだで面倒くさくなってしまうもの。そんな時に登場したのが、Stability Matrixという管理ツール。

「全部まとめて管理しちゃいます」なんて、甘い言葉に釣られてインストールしたものの...ここで思わぬ伏兵が現れました。

予想外の挨拶

意気揚々とStability Matrixを起動しようとした瞬間、こんな言葉が画面に浮かび上がったんです。

Python 3.10.11 (main, May  7 2023, 17:32:05) [Clang 16.0.3 ]
Version: v1.9.0
Commit hash: adadb4e3c7382bf3e4f7519126cd6c70f4f8557b
Launching Web UI with arguments: --api --skip-torch-cuda-test --skip-python-version-check --no-half --gradio-allowed-path /Applications/Data/Images
no module 'xformers'. Processing without...
no module 'xformers'. Processing without...
No module 'xformers'. Proceeding without it.
Warning: caught exception 'Torch not compiled with CUDA enabled', memory monitor disabled
Traceback (most recent call last):
  File "/Applications/Data/Packages/Stable Diffusion WebUI/launch.py", line 48, in <module>
    main()
  File "/Applications/Data/Packages/Stable Diffusion WebUI/launch.py", line 44, in main
    start()
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/launch_utils.py", line 465, in start
    import webui
  File "/Applications/Data/Packages/Stable Diffusion WebUI/webui.py", line 13, in <module>
    initialize.imports()
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/initialize.py", line 39, in imports
    from modules import processing, gradio_extensons, ui  # noqa: F401
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/processing.py", line 18, in <module>
    import modules.sd_hijack
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/sd_hijack.py", line 5, in <module>
    from modules import devices, sd_hijack_optimizations, shared, script_callbacks, errors, sd_unet, patches
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/sd_hijack_optimizations.py", line 13, in <module>
    from modules.hypernetworks import hypernetwork
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/hypernetworks/hypernetwork.py", line 8, in <module>
    import modules.textual_inversion.dataset
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/textual_inversion/dataset.py", line 12, in <module>
    from modules import devices, shared, images
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/images.py", line 20, in <module>
    from modules import sd_samplers, shared, script_callbacks, errors
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/sd_samplers.py", line 5, in <module>
    from modules import sd_samplers_kdiffusion, sd_samplers_timesteps, sd_samplers_lcm, shared, sd_samplers_common, sd_schedulers
  File "/Applications/Data/Packages/Stable Diffusion WebUI/modules/sd_samplers_kdiffusion.py", line 3, in <module>
    import k_diffusion.sampling
  File "/Applications/Data/Packages/Stable Diffusion WebUI/repositories/k-diffusion/k_diffusion/__init__.py", line 1, in <module>
    from . import augmentation, config, evaluation, external, gns, layers, models, sampling, utils
  File "/Applications/Data/Packages/Stable Diffusion WebUI/repositories/k-diffusion/k_diffusion/evaluation.py", line 6, in <module>
    import clip
  File "/Applications/Data/Packages/Stable Diffusion WebUI/venv/lib/python3.10/site-packages/clip/__init__.py", line 1, in <module>
    from .clip import *
  File "/Applications/Data/Packages/Stable Diffusion WebUI/venv/lib/python3.10/site-packages/clip/clip.py", line 6, in <module>
    from pkg_resources import packaging
ImportError: cannot import name 'packaging' from 'pkg_resources' (/Applications/Data/Packages/Stable Diffusion WebUI/venv/lib/python3.10/site-packages/pkg_resources/__init__.py)

「はて？これは一体何を言っているんでしょう」と首をひねってしまいますよね。外国語でも難しいものはありますが、プログラム言語はまた一段と難解です。

謎めいたメッセージの正体

長々としたエラーメッセージの中から、重要なのはこの一文。

ImportError: cannot import name 'packaging' from 'pkg_resources'

どうやら、「すみません、packagingが見当たらないんですが」というようなことを言っているらしいんです。

原因究明

犯人は意外にも、setuptoolsというプログラムでした。最近バージョンアップして、調子に乗って古い仲間の`pkg_resources`を置いてきぼりにしてしまったとか。世知辛い世の中になったものです。

より詳しい情報はこちらでご確認いただけます：
https://github.com/aws-neuron/aws-neuron-sdk/issues/893

解決への道

さて、どうすれば良いでしょうか？実は簡単、setuptoolsを少し古いバージョンに戻してあげれば良いんです。

pip install setuptools==69.5.1

...と、ここまでは良いのですが、ちょっとした落とし穴があります。

思わぬ展開

実は、Stability Matrixは自分だけの特別な環境（venv）を使っているんです。だから、普通にinstallコマンドを打っても効果がありません。

じゃあ、どうすれば良いの？ってことで、以下の手順を踏んでみましょう。

1．まずは、venvがあるディレクトリまで移動

cd /Applications/Data/Packages/stable-diffusion-webui/venv/bin/python3.10

2．特別な環境（venv）を有効にする

source activate

3．そして、さっきのコマンドを実行

pip install setuptools==69.5.1

これで、ようやくStability Matrixが起動するはずです。

おまけ

もし複数のStable Diffusion環境があるなら、それぞれで同じ作業が必要です。例えば、1.9.1と1.9.3の両方がある場合、両方とも同じ方法で面倒を見てあげましょう。
何事も平等が大切ですからね。

一息つきましょう

さて、これで一件落着。少し複雑な道のりでしたが、無事にAIイラスト生成の世界に戻ってこられましたね。お疲れ様でした。

次は、どんな素敵な絵を描こうか...そんなことを考えながら、コーヒーでも飲んでリラックスしましょう。

あとがき

さて、長々とお付き合いいただき、ありがとうございました。この記事が皆さんのトラブルシューティングの助けになれば幸いです。

AIの世界は日進月歩。新しいツールや技術が次々と登場し、私も日々新しい情報をお届けできるよう奮闘しています。

もし、この記事が少しでもお役に立ちましたら、カフェでコーヒーをもう一杯注文するような気持ちで、ちょっとした支援をしていただけると嬉しいです。皆さんの「おひねり」が、次の記事を書く原動力になります。

もちろん、ここまで読んでいただいただけでも十分嬉しいです。これからも、AIツールに関する色々な情報をお届けしていきますので、またお付き合いください。

それでは、次回の記事でまたお会いしましょう。