はじめに
Stable Diffusionは無料の画像生成AIですが、ローカルにいれるとなると少し大変な面があります。
今回ご紹介する、M1 / M2のMacbookにStable Diffusionを入れる方法はいくつかありますが、Appleが公式でサポートしている方法が一番綺麗だと思う方が大半でしょう。
しかし、困ったことにここからインストールしている記事は日本語記事はもちろん、私が調べた限りでは英語記事もそう多くはなく、さらにここからインストールしている記事があってもAnacondaを用いた手法が取られています。これは公式に則っている手法なので、正当と言えば正当なのですが、極力最小構成で収めたい人にとってはあまり取りたくない方法でしょうし、そうでない初心者にとっても変なところで躓く原因になりかねません。(そもそも、初心者にとってはcondaコマンドが何の解説もなく書いてあるだけで躓きかねませんが)
そこで本記事では出来るだけシンプルにしつつも、出来るだけ公式のインストールガイドにそったやり方でインストールしていきます。
本記事では、他記事でも多く記載されていて、なおかつ十分に基本的と考えられる内容は省くことがありますが、コマンドの意味に関しては全てに対してざっくりと解説をします。慣れている方には冗長と思われるかもしれませんが、温かい目で見守ってください。
対象読者
- M1 / M2チップ搭載のMacbookを所持している
- OSが最新である (macOS 13.1以上)
- Homebrewがインストールされている (解説記事が星の数ほどあります、もしくは公式サイトを参照してください)
- XCodeが最新である (14.2以上、
xcodebuild -versionで確認できます。インストール方法については上と同じく山ほどある解説記事をあたってください) -
zsh、bash、もしくはPOSIX準拠のシェルを使っている
(何を言っているかわからない方はおそらく問題ありません、fishなどを使っている方はこの手順では少し躓く可能性があります。
POSIX非準拠シェルを使っている方はbashコマンド等で一時的にシェルを切り替えてください。また、どうしても自分のシェルが不安な方は、echo $SHELLで調べられます)
Step.1 リポジトリをクローンしてくる
経験豊富な読者にとっては丁寧すぎるかもしれませんが、まずはリポジトリをクローンするところからです。
ここに関してもHomebrew同様に解説記事が多くありますので詳細は割愛します。エラーが出た場合などは他の解説記事をあたってください。
git clone git@github.com:apple/ml-stable-diffusion.git
正常にインストールできたらcd ml-stable-diffusionでディレクトリを移動しておきましょう。
Step.2 Pythonの環境構築
Pythonのバージョンが3.8であることが推奨されています。今時のMacbookのPythonは3.10であることが多いと思うので明示的に変更する必要があります。
まずは、pythonのバージョンを切り替えることができるツールであるpyenvのインストールです。
brew install pyenv
次に、旧バージョンのPythonをpyenvを用いてダウンロードします。
pyenv install 3.8
さらに、今のディレクトリがml-stable-diffusionであることを確認しつつ、Python3.8の仮想環境を立てます。下のコマンドのlocalはこのバージョン設定がml-stable-diffusion内でのみ適用されるようにするためのものです。
pyenv local 3.8
python -Vでバージョンが3.8であることを確認できたら成功です。
これで、GitHubに記載されているSystem Requirementsは全て満たした状態になっているはずですが、まだ細かいパッケージなどは不足しているので引き続きインストールしていきます。
まずは、パッケージが競合しないように仮想環境を立てておきます。ここでは簡単のためにvenvを用いますが、poetryなど、お好きな仮想環境を立ててもらって大丈夫です。
補足１ Pythonに詳しくない方へ
- 仮想環境ってそもそも何？
→他のものと干渉しないように空間を区切るイメージです。とりあえずやっておいて損はありません。 - 仮想環境が二個あるのはなぜ？
→Pythonのバージョン管理用とパッケージ（拡張機能のようなもの）管理用です。統合することもできますが、一番シンプルなのはこの方法だと思います。
補足２ poetryを使いたい方へ
念の為に捕捉しますが、poetryは内部的に別のPythonバージョンを持っていて少し厄介です。何を言っているのかわからない方は素直にvenvを使うことをおすすめします。
python -m venv .venv
仮想環境を立てた後は、入らなければ意味がないので有効化しておきます。
これでパッケージを入れる用意が整いました。
source .venv/bin/activate
ここまでの準備ができたら以下のコマンドで必要なものをすべてインストールすることができます。
pip install -e .
Step.2 Hugging Faceの利用
Hugging Faceはアメリカの機械学習のコミュニティです。ここから学習済みのモデルを入手する必要があるため、まずは右上のSign Upから会員登録をしてください。画面に沿って登録をすると1分ほどで終わると思います。メールによる認証もあるので、そちらを確認したら会員登録終了です。メール認証を終えていないと次のステップに進めないので注意してください。
会員登録が終わったら次にアカウントトークンを発行します。このトークンはターミナルから自分のアカウントにログインするときに使うものなので、絶対に流出させないでください。
アカウントトークンは、右上のユーザーアイコン > Settings > Access Tokens > New tokenで発行できます。
Nameは(多分)適当で問題ありません。私はStable Diffusionにしました。RoleもREADで問題ないでしょう。
発行できたら、以下の画面のようになると思うのでコピーしておきましょう。
あとは、ターミナルにhuggingface-cli loginと入力して、"Token: "の横に先ほどのアクセストークンを貼り付ければログインできるはずです。(huggingface-cliは先ほどのpip installで既に入っています)
"Add token as git credential? "に対してはYで問題ないでしょう。成功すればLogin successfulと出るはずです。
Step.3 モデルをダウンロードする
注意！ GB単位のデータをダウンロードすることになるため、Wifi環境であることと、ディスク容量が足りているかどうかを確認してください。
Hugging Face上にはたくさんのバージョンのStable Diffusionがあります。2023年2月現在、デフォルトはこのバージョンとなっていますが、環境によって異なる場合があります。
今回は、せっかくなのでバージョン2.0のものをダウンロードしてみようと思います。
(後述しますが、このバージョンのものはおすすめしません。)
バージョンを選んだらいよいよダウンロードすることになります。
次のコマンドは少し長くなりますが、かいつまんで解説してきます。
(下の太字になっている箇所だけでも読むことをお勧めします)
python -m python_coreml_stable_diffusion.torch2coreml --model-version stabilityai/stable-diffusion-2-base --convert-unet --convert-text-encoder --convert-vae-decoder --convert-safety-checker -o ./stable_diffusion_models
-
python -m python_coreml_stable_diffusion.torch2coreml
→コアとなる部分です。python -mはpythonのモジュールを走らせるときに使うものです。 -
--model-version stabilityai/stable-diffusion-2-base
→省略可能です。省略した場合には前述のバージョンが指定されることになります。 -
--convert-text-encoder --convert-vae-decoder --convert-safety-checker
→省略不可です。オプションを加えているものですが、ややこしくなるため詳しい理解は各自の興味に任せたいと思います。 -
-o ./stable_diffusion_models
→省略不可です。出力先のディレクトリを規定します。 コマンドをそのままコピペするとディレクトリが存在しないと怒られるので注意してください。
私はmkdir stable_diffusion_modelsをして、ml-stable-diffusion/stable_diffusion_modelsに格納することにしましたが、ベストプラクティスかは不明です。
上のコマンドを走らせると、上で言及したエラーが出ない限りはダウンロードが始まると思います。そこそこ時間がかかるため気長に待ちましょう。
補足 SwiftやiOSでも走らせたい場合
簡単のためにいくつか必須でないフラグを抜いていますが、SwiftやiOSでも走らせたい場合は追加のオプションが必要になってきます。
Swift: --bundle-resources-for-swift-cli
iOS/iPadOS: –chunk-unet
それぞれ、末尾に付け加えてください。
Step.4 Stable Diffusionを実際に走らせてみる
お疲れ様でした。ここまで来ればあとはコマンドを一つ打つだけです。
また長いですが、かいつまんで解説します。
python -m python_coreml_stable_diffusion.pipeline --prompt "a photo of an astronaut riding a horse on mars" --model-version stabilityai/stable-diffusion-2-base -i ./stable_diffusion_models -o ./output_images --compute-unit ALL --seed 93
-
python -m python_coreml_stable_diffusion.pipeline
→前のコマンドと同様、コアとなる部分です。 -
--prompt "a photo of an astronaut riding a horse on mars"
→実際に条件を与える部分です。 好きな言葉を" "の中に入力してみてください。 -
--model-version stabilityai/stable-diffusion-2-base
→省略可ですが、前章でバージョンを指定した場合は必須です。 前章で指定した通りに指定してください。 -
-i ./stable_diffusion_models
→省略不可です。先ほど指定したディレクトリを指定します。 -
-o ./output_images
→省略不可です。実際に画像を出力する先を規定します。 前章同様、コマンドをそのままコピペするとディレクトリが存在しないと怒られるので注意してください。
これも同様に、私はmkdir output_imagesをして、ml-stable-diffusion/output_imagesに格納することにしました。 -
--compute-unit ALL --seed 93
→省略可です。--compute-unitはどこで演算するかを規定します。CPU_AND_GPUやCPU_AND_NEにするとALLより早くなる可能性があります。また、--seedではシード値を固定していて、同じシード値であれば同じ乱数が用いられるために結果も同じものとなります。
こちらが私の環境で得られた結果です。如何でしたか？
おわりに
結構とっつきにくい印象のある、ローカルでのStable Diffusionの実行でしたが、どうでしたか？
「わりと簡単だったな」と思っていただければ幸いです。
最後に、デフォルトのバージョン(CompVis/stable-diffusion-v1-4)での結果を載せておきます。
(stabilityai/stable-diffusion-2-baseをさらに発展させた、stabilityai/stable-diffusion-2は相性が良くないのか、自分の環境ではエラーを吐いてしまいました。)
ここまでお付き合いいただき、ありがとうございました！
