【要約】Apple Silicon環境でStable Diffusion（AUTOMATIC1111）をローカル構築する手順【2026年版】 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
Apple Silicon搭載Macで、NVIDIA前提の公式手順を用いると、環境特有の課題に直面する。公式手順はNVIDIA GPUを前提としており、Mac環境ではそのまま動作しない。また、外部リポジトリの状況変化も影響する。
- CUDA非搭載のため、標準の起動プロセスではエラーが発生する。
- 2025年12月以降、依存リポジトリが404エラーとなり、GitHubの認証ループに陥る問題がある。
- Pythonをpyenvでビルドする際、xzがないと_lzmaモジュールが欠落し、起動に失敗する。
- CUDA非搭載のため、標準の起動プロセスではエラーが発生する。
- 2025年12月以降、依存リポジトリが404エラーとなり、GitHubの認証ループに陥る問題がある。
- Pythonをpyenvでビルドする際、xzがないと_lzmaモジュールが欠落し、起動に失敗する。
// Approach
著者は、環境固有の依存関係とリポジトリの変更に対応するため、以下の手順で環境を構築した。依存関係の不備を解消し、Macのハードウェア特性に合わせた設定を施している。これにより、環境構築の失敗を防ぐ。また、トラブルを未然に回避する構成をとっている。
- Homebrewでcmakeやxzなどのビルドツールを事前に導入。
- LDFLAGS等を用いて、pyenvで_lzmaを含むPython 3.10をビルド。
- webui-user.shにApple Silicon向けの起動オプションを記述。
- STABLE_DIFFUSION_REPO環境変数で、取得先リポジトリを有志のフォークへ差し替え。
- Homebrewでcmakeやxzなどのビルドツールを事前に導入。
- LDFLAGS等を用いて、pyenvで_lzmaを含むPython 3.10をビルド。
- webui-user.shにApple Silicon向けの起動オプションを記述。
- STABLE_DIFFUSION_REPO環境変数で、取得先リポジトリを有志のフォークへ差し替え。
// Result
著者は、適切な設定を行うことで、Apple Silicon Mac上でのStable Diffusionの動作を実現した。これにより、Macユーザーでもローカルでの画像生成が可能となった。
- 512×512ピクセル、20ステップ程度の画像生成を実用的な速度で実行可能。
- 依存リポジトリの404問題やPythonのモジュールエラーを完全に回避。
- 外部サービスを利用せず、ローカル環境で自由な画像生成が可能となった。
- 生成コストを抑え、研究開発的な試行錯誤が容易になった。
- 512×512ピクセル、20ステップ程度の画像生成を実用的な速度で実行可能。
- 依存リポジトリの404問題やPythonのモジュールエラーを完全に回避。
- 外部サービスを利用せず、ローカル環境で自由な画像生成が可能となった。
- 生成コストを抑え、研究開発的な試行錯誤が容易になった。
Senior Engineer Insight
> 本記事は、環境依存のトラブルシューティングに深く踏み込んでいる。特に、リポジトリの404問題やPythonのビルド設定といった、抽象的なエラーへの具体的回避策が示されている。ただし、Apple SiliconにおけるMPSの最適化は発展途上だ。大規模な学習には依然として制約が多い。実運用では、生成速度とメモリ消費のトレードオフを常に意識すべきである。