Blender ウォッチング
1枚の画像から3Dモデルを生成できる「TripoSR」をローカルに構築する方法を解説
2024年4月23日 06:55
本連載では、無料の高機能3Dモデリングツール「Blender」の使い方や関連情報を幅広くお伝えします。
少し間が開いてしまいましたが、今回は以前にご紹介した一枚の画像から3Dモデルを生成する「TripoSR」を、ローカルのWindows環境にインストールする方法を解説したいと思います。
「Blender」関連の注目記事一覧
「TripoSR」とは
「TripoSR」は、Tripo AIとStability AIが共同で開発した、画像から3Dモデルデータを高速・低リソースで生成する、高速3Dオブジェクト再構築モデルです。
高速に生成するには「ビデオメモリが6GBの、CUDA対応(NVIDIAの)ビデオカード」が必要とのことですが、速度にさえ目をつむればCPUでも生成可能です(CPUでは空きメモリが同程度必要)。
- ⇨TripoSRのご紹介:単一画像からの高速3Dオブジェクト生成 — Stability AI Japan
- https://ja.stability.ai/blog/triposr-3d-generation
「TripoSR」導入に必要なツールについて
ローカル環境での利用には、以下をインストールする必要があります(今回は上から4つのみ導入)。本記事では導入にWindows 10 64ビット版を使用しています。
- 「Git」
- 「Visual Studio Build Tools」、「Windows10 SDK」
- 「Python」v3.8~3.11
- 「CUDA Toolkit」(NVIDIAのビデオカードがある場合)
- 「TripoSR」(本体)
- 「pytorch」
- その他依存パッケージ(自動インストール)
多数のツールや設定が必要になり、トラブルも多岐に渡るため、「コマンドプロンプト(CUI)が使用できること」「自力で検索・問題解決できること」を前提とし、ツールの使用方法などの一部の説明を割愛させていただきます。ご了承ください。
また、導入は自己責任でお願いいたします。
「Git」のインストール
依存ライブラリの取得とビルドに必要な「Git for Windows」をインストールします。
- ⇨Git for Windows
- https://gitforwindows.org/
すべてデフォルトの設定でOKです。今回の導入では[Git from the command line and also from 3rd-party software]が最重要オプションですが、これもデフォルトで有効になっていますので、何も考えずインストーラーの[Next]をクリックしていけばいいでしょう。
「Build Tools」、「Windows SDK」のインストール
「TripoSR」は「Python」のみで書かれていますが、利用する「torchmcubes」のコンパイルに「x64 Native Tools Command Prompt for VS2022(または2019)」がインストールされている必要があります。
「Unity」などのツール導入時に既にインストール済みの場合も「Windows 10 SDK」が必要です。
- ⇨Microsoft C++ Build Tools - Visual Studio
- https://visualstudio.microsoft.com/ja/visual-cpp-build-tools/
インストーラー(vs_BuildTools.exe)を開いたら、ワークロードの[C++によるデスクトップ開発]を有効化し、オプションの[Windows 10 SDK]を有効化して[インストール]します。Windows 10 SDKのバージョンは2つありますが、どちらでもかまいません。
既存の「Visual Studio」や「Build Tools」を利用する場合でも、同様にそれぞれのインストーラーを開き、[変更]から上記のワークロードとオプションを有効化し[変更]してください。
「Python」環境のインストール
執筆時点では後述の「Pytorch」がv3.12に対応しておらず、また「pip」(後述)を使用するため「installer」版を使用してください。本記事では「3.11.9」の「Windows installer (64-bit)」を使用しました。
インストールせず、既存の「Python」環境を使用する場合は、後述の囲みをお読みください。ちなみに「Blender」にも「Python」実行環境は入っていますが、「pip」がないため素直に新規インストールしましょう。
- ⇨Python Releases for Windows | Python.org
- https://www.python.org/downloads/windows/
ダウンロードが終わればインストーラーを起動し、インストールします。
インストール場所の設定などは割愛するとして、今回重要なのは次の2つのオプションです。
Python.exeをPATH環境変数に追加するオプション
インストール開始前、ダイアログの一番下に[Add python.exe to PATH]というオプションがあります。デフォルトでは無効化されていますので、有効化してから[Install Now]でインストールしてください。
忘れてクリックした場合は、後述の囲み内を参照するか、インストーラーを再実行し[Repair]からこのオプションを設定してください。
Windowsの「ロングファイルパス」の有効化オプション
インストール最後の [Close]をクリックする前に 、その上の[Disable Path length limit]をクリックし、Windowsのロングファイルパスを有効化してください。
これはデフォルトのWindowsでは、パスの長さが制限されているため、ライブラリのインストールに失敗することがあるためです。
間違って[Close]で閉じちゃった場合は、下の囲み内を参照してください。
Python環境を新規インストールしない場合は、下記を確認し、できていない場合は自力で設定してください。
環境変数「PATH」に以下の2つが追加されているかをチェックし、なければ追加してください。下記は「Python3.11」デフォルトのインストール設定の場合ですので、インストール場所を変更した場合は適宜編集してください。
C:Users(ユーザー名)AppDataLocalProgramsPythonPython311
C:\Users\(ユーザー名)\AppData\Local\Programs\Python\Python311\Scripts
使用中のWindowsが「ロングファイルネーム」に未対応の場合は、「Regedit」で以下のレジストリ値を「1」にしてください。
HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥Control¥FileSystem¥LongPathsEnabled
「CUDA Toolkit」のインストール
使用するPCに「NVIDIAのビデオカード」があり、利用したい場合は、グラフィックドライバーのバージョンを確認し、この表からv11.xとv12.xのどちらに適合しているか確認し、対応する方をインストールします。ドライバーのバージョン番号の確認方法は割愛します。
なお、インストールせず、CPU版として利用することも可能です。
- ⇨CUDA Toolkit Archive | NVIDIA Developer
- https://developer.nvidia.com/cuda-toolkit-archive
終わりに
今回はここまでです。ほぼダウンロードとインストールのみで終わってしまいましたが、次回はコマンドプロンプトを使用していきます。お楽しみ(?)に。
ではまた。