このページは英語から機械翻訳されています。英語の原文を読む。

ローカルPythonモデルランタイム

公式3Dv1.0.2aigd.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-cudaWindows、NVIDIA GPU(ドライバー572.61以降、コンピュートケイパビリティ7.0以降)15 MB
win-x64-cpuサポート対象のNVIDIA GPUがないWindows15 MB
linux-x64-cudaLinux 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-metalAppleシリコンの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がホストしているものではありません。

バージョン

ローカルPythonモデルランタイムのリリース
バージョンリリース日アプリが必要
1.0.2最新0.32.0-beta.6 以降
1.0.10.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