DiffusersをmacOSにインストールする手順

Tadashi Shigeoka ·  Sat, January 18, 2025

DiffusersをmacOSにインストールする手順をご紹介します。

Diffusersとは、Hugging Faceが開発した拡散モデル(Diffusion Model)を利用した画像や音声、さらには分子の3D構造を生成するためのライブラリです。このライブラリは、シンプルな生成ソリューションから独自の拡散モデルをトレーニングするまで、幅広い用途に対応しています。

動作環境

  • macOS 15.3.1 (Apple Silicon M1 Max)
  • Python 3.12.9
    • Python 3.13 では動かなかったので 3.12 を利用

Diffusersのインストール手順

1. Python仮想環境の作成 (推奨)

プロジェクトごとに独立した環境を構築するため、Pythonの仮想環境を作成することを強く推奨します。これにより、異なるプロジェクト間でライブラリのバージョン競合を防ぐことができます。

# asdf を利用している場合 (オプション)
asdf local python 3.12.9
 
# 仮想環境の作成 (.env という名前のディレクトリが作成されます)
python -m venv .env
 
# 仮想環境のアクティベート
source .env/bin/activate
 
# (仮想環境から抜ける場合は `deactivate` コマンドを実行)

2. 必要なライブラリのインストール

Diffusersを使用するためには、いくつかの依存ライブラリをインストールする必要があります。

# PyTorchのインストール (macOS用の最新版をインストール)
pip install torch
 
# Transformers (Diffusersが依存しているため)
pip install transformers
 
# Accelerate (効率的な学習や推論に利用)
pip install accelerate
 
# その他の必要なライブラリ (無いとエラーが出るため)
pip install protobuf sentencepiece

3. Diffusersのインストール

pip install diffusers

以上、DiffusersをmacOSへインストールした、現場からお送りしました。