生成AIの導入は、技術的の一定のハードルがあり、Pythonや様々なパッケージの依存関係の解決が必要になる場合もあります。
こちらの記事で紹介している Stability Matrix はそうした手間を解決する便利なツールですが、それでもうまくいかない場合があります。
記事の執筆中も、Stable Diffusion をインストールする際、とあるパッケージの依存関係でインストールが中断されました。
多くの場合、同様の問題や解決策は、ユーザコミュニティ等で共有され、検索で見つけることができます。また、ある程度の知識や経験があれば、エラーメッセージから解決することもできるでしょう。
それでも、普段はアプリストアやインストーラーを利用しているカジュアルユーザーには敷居が高いのが現実です。 今回は、技術的な知識や経験がなくても問題解決が可能か、ChatGPTへの相談を試してみました。
Stable Diffusion WebUI Forgeのインストール
今回は、Stability Matrix の利用でインストールがうまくいかないケースを題材にします。 ※環境に依存する内容のため、問題が起こらずインストールできる場合もあります。
オプション指定が可能ですが、デフォルトのままインストールをクリックします。
エラー表示が出てインストールが中断しました。 英語と技術的なエラーで焦りますが、ここで ChatGPT の出番。
特に切り取りなどは行わず、⌘+Aでテキスト全文を選択、コピーしてChatGPTに渡します。 念の為、スクリーンショットも渡しました。ごく簡単なプロンプトとして一文を添えます。
Stability MaxでStable Diffusion WebUI Forgeをインストールしたら途中でエラーが起きた。
-----
(ログ全文+添付ファイル)ChatGPT からは下記の返答です。文章の例示のため、Markdownタグは一部省略しています。
これは Stability Matrix 本体のバグというより「pycairo のビルドに必要なネイティブライブラリが mac に入っていない」ことが原因です。
エラーのポイントだけ抜き出すと：
- Failed to build pycairo==1.29.0
- Did not find pkg-config by name 'pkg-config'
- Run-time dependency cairo found: NO
- Dependency lookup for cairo with method 'pkgconfig' failed
つまり、
1. pkg-config コマンドが見つからない
2. それ経由で探すべき cairo ライブラリも見つからない
→ そのせいで pycairo のビルドに失敗 → 連鎖して stable-diffusion-webui-forge のインストールが失敗
という流れです。
---
対処手順（Mac / Apple Silicon 前提）
1. Xcode コマンドラインツールを入れる（まだなら）
ターミナルを開いて：
xcode-select --install
すでに入っている場合は「すでにインストール済み」と出るだけなので、そのまま次へ進んでOKです。
---
2. Homebrew で cairo / pkg-config / cmake を入れる
同じくターミナルで：
# Homebrew 未導入なら（/opt/homebrew に入るはず）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
インストール済みならスキップして構いません。
そのうえで、依存パッケージを入れます：
brew update
brew install cairo pkg-config cmake
確認用に：
pkg-config --modversion cairo
と打ってバージョン番号が出てくれば OK です。
---
Stability Matrix で再インストール
1. Stability Matrix をいったん終了 → 再起動
2. 「Stable Diffusion WebUI Forge」のパッケージ画面で、
- もし「アンインストール」や「削除」ができるなら一度消す
- その後、もう一度「インストール」を実行
今度は pycairo のビルド時に pkg-config と cairo が見つかるので、先ほどのエラーは出ないはずです。
---
もしまだ失敗するようなら
- もう一度エラーメッセージの末尾（新しいログ部分）だけを貼ってもらえれば、
次の原因を一緒に追いかけます。
- 特に pkg-config や cairo のパスが見つからない系のメッセージが残っているかどうかを確認したいです。
まずは上の brew install cairo pkg-config cmake まで試してみてください。知識がないと説明の理解は難しいのですが、具体的な指示があるのでそのとおりやってみます。
% xcode-select --install
xcode-select: note: Command line tools are already installed. Use "Software Update" in System Settings or the softwareupdate command line interface to install updatesとインストール済みでした。実際はxcodeがインストール済みであることは事前にわかっていましたが、知識無しで進められるかを試すためそのまま実行しています。英語が難しい場合は、これもコピペでChatGPTに聞いてもOKです。
次の手順に進みます。
% /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
**==>** **Checking for `sudo` access (which may request your password)...**
Password:sudoでパスワード入力が必要になりました。 ここでもChatGPTに聞いてもOKです。
**==>** **This script will install:**
/opt/homebrew/bin/brew
/opt/homebrew/share/doc/homebrew
/opt/homebrew/share/man/man1/brew.1
/opt/homebrew/share/zsh/site-functions/_brew
/opt/homebrew/etc/bash_completion.d/brew
/opt/homebrew
/etc/paths.d/homebrew
Press **RETURN**/**ENTER** to continue or any other key to abort:確認でEnterを求められます。実際はhomebrewはインストール済みですがこのまま進めてみます。 ここもChatGPTに聞いてもOKです。
**==>** **/usr/bin/sudo /usr/sbin/chown -R fjwrk:admin /opt/homebrew**
**==>** **Downloading and installing Homebrew...**
remote: Enumerating objects: 1008, done.
remote: Counting objects: 100% (457/457), done.
remote: Compressing objects: 100% (66/66), done.
remote: Total 1008 (delta 411), reused 391 (delta 391), pack-reused 551 (from 2
**==>** **/usr/bin/sudo /bin/mkdir -p /etc/paths.d**
**==>** **/usr/bin/sudo tee /etc/paths.d/homebrew**
/opt/homebrew/bin
**==>** **/usr/bin/sudo /usr/sbin/chown root:wheel /etc/paths.d/homebrew**
**==>** **/usr/bin/sudo /bin/chmod a+r /etc/paths.d/homebrew**
==> **Updating Homebrew...**
Updated 2 taps (homebrew/core and homebrew/cask).
**==>** **Installation successful!**
**==>** **Homebrew has enabled anonymous aggregate formulae and cask analytics.**
**Read the analytics documentation (and how to opt-out) here:**
**https://docs.brew.sh/Analytics**
No analytics data has been sent yet (nor will any be during this **install** run).
**==>** **Homebrew is run entirely by unpaid volunteers. Please consider donating:**
https://github.com/Homebrew/brew#donations
**==>** **Next steps:**
- Run these commands in your terminal to add Homebrew to your **PATH**:
echo >> /Users/fjwrk/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/fjwrk/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
- Run **brew help** to get started
- Further documentation:
https://docs.brew.sh
fjwrk@kagunomi ~ % brew update
brew install cairo pkg-config cmake
==> **Updating Homebrew...**
Already up-to-date.
Warning: cairo 1.18.4 is already installed and up-to-date.
To reinstall 1.18.4, run:
brew reinstall cairo
Warning: pkgconf 2.5.1 is already installed and up-to-date.
To reinstall 2.5.1, run:
brew reinstall pkgconf
==> **Fetching downloads for:** **cmake**
✔︎ Bottle Manifest cmake (4.2.0) [Downloaded 11.3KB/ 11.3KB]
✔︎ Bottle cmake (4.2.0) [Downloaded 18.6MB/ 18.6MB]
==> **Pouring cmake--4.2.0.arm64_tahoe.bottle.tar.gz**
==> **Caveats**
To install the CMake documentation, run:
brew install cmake-docs
==> **Summary**
🍺 /opt/homebrew/Cellar/cmake/4.2.0: 4,016 files, 63.2MB
==> **Running `brew cleanup cmake`...**
Disable this behaviour by setting `HOMEBREW_NO_INSTALL_CLEANUP=1`.
Hide these hints with `HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> **Caveats**
Emacs Lisp files have been installed to:
/opt/homebrew/share/emacs/site-lisp/cmakeカジュアルユーザーには厳しい表示内容ですが、エラーなどの問題はなさそうなので次の手順に進みます。ここもChatGPTに聞いてもOKです。
% pkg-config --modversion cairo
1.18.4バージョン番号が出たので、Stability Matrix側で再度試すと、また似たようなエラーが出ます。
これも同じように、ログ全文をChatGPTに渡して相談します。
まだ pkg-config と cairo を見つけられていない状態のままなので、同じところでこけていますね。
Did not find pkg-config by name ‘pkg-config’
Found pkg-config: NO
Run-time dependency cairo found: NO (tried framework)
ここさえ通れば pycairo のビルドは進むはずです。
---
① Homebrew 側で必要パッケージが入っているか確認
まずターミナルで：
brew list pkg-config cairo cmake
- もし「Not installed」等が出るものがあれば、入れてください：
brew install pkg-config cairo cmake
確認：
which pkg-config
pkg-config --modversion cairo
ここで
- which pkg-config → /opt/homebrew/bin/pkg-config（Apple Silicon想定）
- pkg-config --modversion cairo → 1.18.0 などのバージョン番号
が出ていれば Homebrew 側はOKです。
---
② Stability Matrix から
pkg-config
が見えていない問題
GUIアプリを Dock / Finder から起動すると、PATH に /opt/homebrew/bin が入っておらず、
Stability Matrix 内の Python から pkg-config が見えないままになっている可能性が高いです。
A案：ターミナルから Stability Matrix を起動する（お手軽回避）
1. Stability Matrix を完全に終了する。
2. ターミナルで次を実行：
open -a "Stability Matrix"
または
/Applications/Stability\ Matrix.app/Contents/MacOS/Stability\ Matrix
3. 起動した Stability Matrix で、もう一度 Stable Diffusion WebUI Forge のインストールを実行。
ターミナルから起動すると、ターミナルの PATH を引き継ぐので
/opt/homebrew/bin が見える → pkg-config も見える → cairo も解決、という流れが期待できます。
---
B案：Homebrew のパスをシステム全体に通す（恒久対策）
もう少し根本的に直すなら、/opt/homebrew/bin をシステム PATH に追加します。
echo '/opt/homebrew/bin' | sudo tee /etc/paths.d/homebrew
その後、macOSに再ログイン（or 再起動）すると、
- GUIアプリも含めた全体の PATH に /opt/homebrew/bin が入るようになります。
再ログイン後に Stability Matrix を普通に起動して、再インストールを試してください。
---
③ それでもダメだったら
上をやってもまだ同じ
Did not find pkg-config by name ‘pkg-config’
が出るようなら、
which pkg-config
ls -l /usr/local/bin/pkg-config
ls -l /opt/homebrew/bin/pkg-config
の結果を貼ってもらえれば、次の手を考えます
（/usr/local/bin/pkg-config へのシンボリックリンクを張る手もあります）。
---
まずは
1. brew install pkg-config cairo cmake が完了しているか確認
2. ターミナルから open -a "Stability Matrix" で起動して再トライ
この順でやってみてもらえると、一番早く解決まで持っていけると思います。丁寧な説明で、ある程度知識があればPATHの問題と当たりをつけられるでしょう。
ここでも、あえて何も考えず、提案された手順を実行してみます。
1つ目のbrew installを確認すると成功しているようなので、ターミナルからopenで起動する手順を試すと、あっさりStable Diffusionのインストールが完了しました。
ChatGPTへの相談で、機械的な手順のみでインストールが完了できました。
知識なしでは読むだけでも時間はかかりますし、気分も乗らないとは思いますが、ChatGPTの具体的な指示の精度には驚きます。
インストールの残骸の撤去
上記手順では省略していますが、パッケージのインストールが途中で失敗したため、いわゆる「ゴミ」が残っていました。無視しても良いですが、容量も取りますのでパッケージ表示の右上の「⋮」から削除します。この手順もAIに相談してもよいでしょう。
ちょっと怖そうな案内が表示されますですが、入力欄に確認のため”Stable Diffusion WebUI Forge”と入力すれば無事に消えます。なお、インストールの進み具合でパッケージ名の認識が異なるようで、手順は同じですが、もう1つ残骸では違う文字列の入力を求められました。
これで心置きなく使えます。
なお今回のケースについては、ChatGPTが恒久対応となるGUIアプリ向けのpkg-configへのPATH設定も提案してくれているため、実行しておきました。
注意事項
このケースでは、ChatGPTは極めてうまく機能しました。 ただ、日常のすべてのケースでこのようにうまくいくわけではありません。 体感的には、ここまでスムーズに解決できるケースは稀です。
経験上、下記のような質問を折々挟むことで、少なくとも大きな問題に発展することは防ぐことができます。どうしてもカットオフの問題で最新のソリューションは情報が不足していたり、自身の知識を優先してハルシネーションが起こるためです。
- 公式やユーザコミュニティで報告のある問題か。解決策には実績があるか。
- Webで調べた内容と比べて事実と言えるか。
- 自身の推測を交えていないか。
なお、必要以上に追求しても、ChatGPTや生成AIは、理由を適切に答えてくれない場合があります。構造的に、その回答自体もカットオフやハルシネーションのリスクを含みます。
完全に人間の理解や知識無しでは、ChatGPTでの軌道修正は限界があり、割り切って違うツールを使うことになります。 そのツールにこだわる場合は、ある程度自分で調べ、理解しながら試行錯誤するのがおすすめです。
