ローカルPythonモデルランタイム
gamedev pkg add aigd.python概要
C++やONNXへの移植版がないローカルモデル(3D生成とリギング)を、モデルごとの専用Python環境で、このコンピューター上のPyTorchを使って実行します。この環境がお使いのPythonに触れることはありません。TripoSG、Hunyuan3D-2.1 Shape、SkinTokensなどのモデルは別パッケージです。
AI Game DevのローカルPythonランタイムです。C++やONNXへの移植版がないモデル(画像から3D、メッシュのリファイン、自動リギングなど)を、PyTorchを使ってこのコンピューター上で実行します。すべてがお使いのコンピューター上で動作し、AI Game Devの利用枠は一切消費しません。コンセプトアートから3D形状を作ったり、自分のGPUでキャラクターをリギングしたりしたいゲーム開発者に適しています。モデル自体は別パッケージです。
できること
- ローカルの画像から3Dへのモデルを使って、1枚のコンセプト画像から3D形状を作れます。たとえばTripoSG 1.5B、Hunyuan3D-2.1 Shape、Step1X-3D Geometryなどです。
- Asset StudioでSkinTokensを使い、キャラクターやクリーチャーのメッシュをリギング(スケルトンとスキンウェイト)できます。
- お使いのPythonインストールには一切手を加えません。モデルごとに専用のプライベート環境が用意されます。
リクエスト例
- 「
Assets/Concepts/goblin.pngを、自分のGPUでTripoSGを使って3D形状にして」 - 「この宝箱の画像から、Hunyuan3D-2.1 Shapeを使ってローカルで3Dモデルを作って」
- 「
Assets/Concepts/crate.pngをStep1X-3D Geometryで3D形状にして」
仕組み
このパッケージはデータのみで(aigd-package.json、コードは含みません)、お使いのコンピューター向けにuvのどのリリースをダウンロードするかをAI Game Devに伝えます。アプリはuvを使ってモデルごとに専用のPython環境を構築します。お使いのPythonには一切触れません。グローバルには何もインストールされず、PATHにも何も追加されず、Windowsレジストリにも何も書き込まれません。すべてはアプリのモデルストア内、python/に置かれます。
モデルは別パッケージです
このパッケージにはモデルは含まれていません。Packagesブラウザからモデルパッケージをインストールし、Modelsパネルからそのファイルをダウンロードしてください。確認なしにダウンロードされることはなく、事前にサイズを確認できます。
モデルを初めて読み込むとき、アプリはそのモデルのPython環境を構築します。Python 3.12とPyTorch、そしてそのモデルの他のライブラリをダウンロードします。CUDAビルドの場合は2〜4 GBになります。これには数分かかることがあります。2回目以降の読み込みではこの環境が再利用されます。ダウンロードが中断された場合、次回の読み込み時にやり直されますが、すでにダウンロード済みのファイルはすべて再利用されます。
ダウンロードされるもの
- uv — アップストリームリリース
0.13.7、sha256で固定。アプリがお使いのコンピューターに合わせて1つのバリアントを選びます。
| バリアント | コンピューター | ダウンロード |
|---|---|---|
win-x64-cuda | Windows、NVIDIA GPU(ドライバー572.61以降、コンピュートケイパビリティ7.0以降) | 15 MB |
win-x64-cpu | サポート対象のNVIDIA GPUがないWindows | 15 MB |
linux-x64-cuda | Linux x64、NVIDIA GPU(ドライバー570.124以降、コンピュートケイパビリティ7.0以降)、glibc 2.28以降 | 17 MB |
linux-x64-cpu | サポート対象のNVIDIA GPUがないLinux x64、glibc 2.28以降 | 17 MB |
darwin-arm64-metal | AppleシリコンのMac、macOS 14以降(PyTorchはMPS経由でGPUを使用) | 14 MB |
Linuxはプレビュー版です。実際のLinux GPUではまだテストされていません。
- Python 3.12.16(モデルのライブラリが要求する場合は3.11.18または3.13.18):python-build-standaloneによるCPythonビルド。uvがダウンロードし、固定されたuvリリースに組み込まれたチェックサムと照合します。
- 各モデルのPythonライブラリ:PyPIとdownload.pytorch.orgから取得するPyTorch 2.11(NVIDIAではCUDA 12.8)と、そのモデル固有のライブラリ。アプリはモデルごとに正確なリストを同梱しており、バージョンとsha256で固定されています。インストールにはwheelのみを使用するため、お使いのコンピューター上でコンパイルは行われません。sha256と一致しないファイルがあるとインストールは中止されます。
モデルはオフラインで動作します。ウェイトは、Modelsパネルでダウンロードしたファイルからのみ取得されます。
要件
- 各モデルパッケージが、それぞれのGPUとビデオメモリの要件を記載しています。
- アプリがドライバーやシステムライブラリをインストールすることはありません。PyTorchがGPUを認識できない場合、モデルは読み込まれず、アプリがNVIDIAドライバーの更新を促します。
- AI Game Dev 0.32.0-beta.6以降。
ライセンス
- このパッケージ — MIT。
- uv — MIT OR Apache-2.0、© Astral Software Inc.(MIT、Apache-2.0)。
- CPython — PSF License 2.0、© Python Software Foundation。python-build-standaloneディストリビューションは、同梱するライブラリ(OpenSSL、SQLite、zlibなど)のライセンスも付帯します。そのビルドスクリプトはMPL-2.0です(ライセンス)。
- PyTorch — BSD-3-Clause、© Meta Platformsおよび貢献者(ライセンス)。
- NVIDIA CUDAライブラリ(cuBLAS、cuDNNなど)。CUDAバリアントのみに含まれます。これらはCUDA版PyTorchのwheelに含まれており、NVIDIA CUDA EULAに基づいて再配布されます。
- 各モデルパッケージは独自のライセンスを記載しています。一部の3Dモデルには地域や商用利用に関する制限があります。Modelsパネルでは、ダウンロード前に制限が表示されます。
必要な表示義務:このパッケージにはありません。モデルパッケージはそれぞれ独自に記載しています。
制限:このパッケージによるものはありません。NVIDIA CUDA EULAは、これらのライブラリをアプリケーションとともに使用することを許可していますが、単独での再配布は許可していません。
すべてのファイルは、各上流の発行元(GitHub、Pythonパッケージインデックス、download.pytorch.org)からダウンロードされます。AI Game Devがホストしているものではありません。
バージョン
| バージョン | リリース日 | アプリが必要 |
|---|---|---|
| 1.0.2最新 | 0.32.0-beta.6 以降 | |
| 1.0.1 | 0.32.0-beta.6 以降 |
インストール
デスクトップアプリで
Packages ウィンドウを開き(ステータスバーのパッケージアイコン)、Browse を選んで aigd.python を検索し、Add to Project をクリックします。
アプリがまだない方は、Windows、macOS、Linux 用の AI Game Dev を無料でダウンロードしてください。
ターミナルから
gamedev CLI を使い、プロジェクトフォルダーで実行します。
gamedev pkg add aigd.python必要条件
- AI Game Dev 0.32.0-beta.6 以降
gamedev pkg add aigd.python