For the complete documentation index, see llms.txt. This page is also available as Markdown.

Blackwell、RTX 50シリーズとUnslothでLLMをファインチューニング

NVIDIAのBlackwell RTX 50シリーズとB200 GPUでLLMをファインチューニングする方法を、ステップバイステップガイドで学びましょう。

Unsloth は現在、NVIDIA の Blackwell アーキテクチャ GPU をサポートしています。これには、RTX 50 シリーズ GPU(5060〜5090)、RTX PRO 6000、そして B200、B40、GB100、GB102 などの GPU が含まれます!公式の NVIDIA のブログ記事はこちら.

Unsloth は現在、2018 年以降のすべての NVIDIA GPU と互換性があります。 DGX Spark.

新しい Docker イメージ は Blackwell をサポートしています。Docker イメージを実行して、トレーニングを始めましょう! ガイド

Pip インストール

Unsloth をそのままインストールしてください:

pip install unsloth

問題が見られる場合は、別の分離された環境を作成する方法もあります:

python -m venv unsloth
source unsloth/bin/activate
pip install unsloth

なお、これは pip3 または pip3.13 である場合もあり、同様に python3 または python3.13

Xformers にいくつか問題が発生することがあります。その場合は、ソースからビルドしてください:

# まず、以前のライブラリによってインストールされた xformers をアンインストールします
pip uninstall xformers -y

# クローンしてビルド
pip install ninja
export TORCH_CUDA_ARCH_LIST="12.0"
git clone --depth=1 https://github.com/facebookresearch/xformers --recursive
cd xformers && python setup.py install && cd ..

Docker

unsloth/unsloth は Unsloth の唯一の Docker イメージです。Blackwell および 50 シリーズ GPU では、この同じイメージを使用してください。別のイメージは不要です。

インストール手順については、こちらの Unsloth Docker ガイド.

uv

uv(上級者向け)

インストール順序は重要です。というのも、バンドルされた依存関係を特定のバージョン(つまり、 xformers および triton).

  1. 私は uv よりも pip を使う方が好きです。なぜなら、より高速で依存関係の解決にも優れているからです。特に、 torch に依存しているが、このシナリオでは特定の CUDA バージョンが必要なライブラリに対して有効です。

    インストール uv

    プロジェクトディレクトリと venv を作成:

  2. インストール vllm

    指定する必要があることに注意してください cu128。そうしないと vllm がインストールされます torch==2.7.0 ですが cu126.

  3. インストール unsloth の依存関係になります

    Xformers が原因でおかしな解決問題が見られる場合は、Xformers なしでソースから Unsloth をインストールすることもできます:

  4. ダウンロードしてビルド xformers (任意)

    Xformers は任意ですが、確実に高速でメモリ使用量も少なくなります。Xformers を使わない場合は、PyTorch のネイティブ SDPA を使用します。Xformers をソースからビルドするのは時間がかかることがあるので注意してください!

    明示的に TORCH_CUDA_ARCH_LIST=12.0.

  5. transformers 任意の transformers バージョンをインストールできますが、最新を取得するのが最善です。

Conda または mamba(上級者向け)

  1. インストール conda/mamba

    インストールスクリプトを実行

    conda または mamba の環境を作成

    新しく作成した環境をアクティブ化

  2. インストール vllm

    アクティブ化された conda/mamba 環境の中にいることを確認してください。ターミナルのシェルの先頭に、次のように環境名が表示されるはずです (unsloth-blackwell)user@machine:

    指定する必要があることに注意してください cu128。そうしないと vllm がインストールされます torch==2.7.0 ですが cu126.

  3. インストール unsloth の依存関係になります

    アクティブ化された conda/mamba 環境の中にいることを確認してください。ターミナルのシェルの先頭に、次のように環境名が表示されるはずです (unsloth-blackwell)user@machine:

  4. ダウンロードしてビルド xformers (任意)

    Xformers は任意ですが、確実に高速でメモリ使用量も少なくなります。Xformers を使わない場合は、PyTorch のネイティブ SDPA を使用します。Xformers をソースからビルドするのは時間がかかることがあるので注意してください!

    ターミナルのシェルの先頭に、次のように環境名が表示されるはずです (unsloth-blackwell)user@machine:

    明示的に TORCH_CUDA_ARCH_LIST=12.0.

  5. 更新 triton

    アクティブ化された conda/mamba 環境の中にいることを確認してください。ターミナルのシェルの先頭に、次のように環境名が表示されるはずです (unsloth-blackwell)user@machine:

    triton>=3.3.1Blackwell のサポートに必要です。

  6. Transformers 任意の transformers バージョンをインストールできますが、最新を取得するのが最善です。

mamba をパッケージマネージャーとして使っている場合は、上記のすべてのコマンドで conda を mamba に置き換えてください。

WSL 固有の注意事項

WSL(Windows Subsystem for Linux)を使用していて、xformers のコンパイル中に問題が発生した場合(注意:Xformers は任意ですが、トレーニングではより高速です)、以下の追加手順に従ってください:

  1. WSL のメモリ制限を増やす WSL の設定ファイルを作成または編集します:

    これらの変更を行った後、WSL を再起動します:

  2. xformers をインストール WSL 用に最適化されたコンパイルで xformers をインストールするには、次のコマンドを使用してください:

    この --no-build-isolation フラグは、WSL 環境で起こりうるビルド問題の回避に役立ちます。

最終更新

役に立ちましたか?