AI マスク作成ツール SMART を Mac OS にインストールする

　さて、Windows 版に引き続き SMART の Mac OS でのインストール方法を解説します。Mac OS および Linux では実行バイナリーは提供されておらず、python スクリプトのみです。

----------------

[訂正]

　最初に本記事をアップしたときに、Mac OS では簡単にインストールできると書きましたが、実は色々確認したところ、Homebrew を導入したことにより、意図せず都合よく pyenv 環境がセットアップされていたためでした。pyenv 環境がセットアップしていないと仮想環境のセットアップなどやはり面倒になります。

　また、Homebrew を導入すればどんな場合でも Pyenv 環境が自動的にセットアップされるのではなく、pyenv は Homebrew を通してアプリをインストールしたときの依存環境の一環として導入されるようなので、Homebrew をいつ導入したか、どんなアプリのどんなバージョンをインストールしたかによって変わってくるようです。

　そこで、以下のページに Pyenv 環境のセットアップ方法を書きました。以下の手順で SMART をすんなりインストールできない場合は、先に以下のページを見て明示的に pyenv 環境のセットアップを行ってから、その下の SMART セットアップ手順に進んでください。

yasuo-ssi.hatenablog.com

　なお、$ which python で、.pyenv/shims 以下のインタープリタが表示されるようなら、以下の手順が使えます。

----------------

　なお、以下の過程は Mac OS 15.6 ARM 版で確認しています。Python は明示的にインストールしていませんが、which python で Python の場所を調べてみると、$HOME/.pyenv/shims/python (もしくは $HOME/.pyenv/shims/python3) となる環境です。つまり予めデフォルトで pyenv による仮想環境が有効になっている状態です。どうやら Homebrew を入れ、何かのアプリを入れたときに、依存関係の一つとしてインストールされたもののようです。

　なお、Python がインストールされていなかったり、明示的に Python をインストールしたりした場合、環境が異なる場合がありますので、以下のステップ通りにいかない場合があります。

1. SMART をダウンロードする

　ターミナルから、以下のコマンドで、ホームディレクトリの下の SMART というディレクトリに、SMART をクローンします。

$ git clone https://github.com/artraweditor/SMART/

もしくは

$ git clone https://github.com/artraweditor/SMART/tree/0.2 (明示的に v. 0.2 をクローン)

2. SMART に必要なライブラリを pip でインストールする

　次に、必要なライブラリをインストールします。クローンした SMART ディレクトリにある、requirements.txt ファイルを使って以下のコマンドで必要なライブラリがインストールされるはずです。カレントディレクトリを SMART をクローンしたディレクトリに移し、

$ pip install -r requirements.txt

これでうまく行けば OK です。Linux とは異なり、仮想環境を作れとかは言われませんでした。そこで、pip -V でどこにインストールされるのか調べたところ、インストール先は以下のようです。

$HOME/.pyenv/versions/バージョン番号/lib/pythonバージョン番号/site-packages/pip

デフォルトで .pyenv という仮想環境ができて、通常は Python のバージョンに合わせてその仮想環境がデフォルトで読み込まれるようです。ですので、 Linux のように、仮想環境を作れとか言われないようです。python がバージョンアップされるとインストールし直しが必要になるかもしれません。ちなみに私の環境は Mac OS 15.6.1 の ARM 版で、Python のバージョンは、3.13.7. でした。

3. sam2.1_hiera_base_plus.pt のダウンロード

　以下のページから、sam2.1_hiera_base_plus.pt をダウンロードします。他のモデルも使えますが、自分で json ファイルの編集が必要になります。

github.com4. sam2.1_hiera_base_plus.pt のインストール

　SMART ディレクトリの下の、models ディレクトリに、上でダウンロードしたファイルをコピーします。

5. 初回起動

　カレントディレクトリを SMART の下のscr に変更して、以下のコマンドを起動します

$ python main.py

　すると、初回だけ下記のように json ファイルを作るというメセージが出ますので、それで一旦終了します。