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

> C++やONNXへの移植版がないローカルモデル（3D生成とリギング）を、モデルごとの専用Python環境で、このコンピューター上のPyTorchを使って実行します。この環境がお使いのPythonに触れることはありません。TripoSG、Hunyuan3D-2.1 Shape、SkinTokensなどのモデルは別パッケージです。

- ID: `aigd.python`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: 3D
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 1.0.2 (公開日 2026-11-22)
- ライセンス: MIT
- AI Game Dev アプリが必要です: `>=0.32.0-beta.6`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.python

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.python
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.python` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 説明

````markdown
# ローカルPythonモデルランタイム（`aigd.python`）

AI Game DevのローカルPythonランタイムです。C++やONNXへの移植版がないモデル（画像から3D、メッシュのリファイン、自動リギングなど）を、[PyTorch](https://pytorch.org)を使ってこのコンピューター上で実行します。すべてがお使いのコンピューター上で動作し、AI Game Devの利用枠は一切消費しません。コンセプトアートから3D形状を作ったり、自分のGPUでキャラクターをリギングしたりしたいゲーム開発者に適しています。モデル自体は別パッケージです。

## できること

- ローカルの画像から3Dへのモデルを使って、1枚のコンセプト画像から3D形状を作れます。たとえば[TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg)、[Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)、[Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)などです。
- Asset Studioで[SkinTokens](https://ai-game.dev/packages/aigd.model3d-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](https://github.com/astral-sh/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`](https://github.com/astral-sh/uv/releases/tag/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](https://github.com/astral-sh/python-build-standalone)によるCPythonビルド。uvがダウンロードし、固定されたuvリリースに組み込まれたチェックサムと照合します。
- **各モデルのPythonライブラリ**:[PyPI](https://pypi.org)と[download.pytorch.org](https://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](https://github.com/astral-sh/uv/blob/0.13.7/LICENSE-MIT)、[Apache-2.0](https://github.com/astral-sh/uv/blob/0.13.7/LICENSE-APACHE)）。
- CPython — [PSF License 2.0](https://docs.python.org/3/license.html)、© Python Software Foundation。python-build-standaloneディストリビューションは、同梱するライブラリ（OpenSSL、SQLite、zlibなど）のライセンスも付帯します。そのビルドスクリプトはMPL-2.0です（[ライセンス](https://github.com/astral-sh/python-build-standalone/blob/main/LICENSE)）。
- PyTorch — BSD-3-Clause、© Meta Platformsおよび貢献者（[ライセンス](https://github.com/pytorch/pytorch/blob/main/LICENSE)）。
- NVIDIA CUDAライブラリ（cuBLAS、cuDNNなど）。CUDAバリアントのみに含まれます。これらはCUDA版PyTorchのwheelに含まれており、[NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/)に基づいて再配布されます。
- 各モデルパッケージは独自のライセンスを記載しています。一部の3Dモデルには地域や商用利用に関する制限があります。Modelsパネルでは、ダウンロード前に制限が表示されます。

必要な表示義務:このパッケージにはありません。モデルパッケージはそれぞれ独自に記載しています。

**制限:**このパッケージによるものはありません。NVIDIA CUDA EULAは、これらのライブラリをアプリケーションとともに使用することを許可していますが、単独での再配布は許可していません。

すべてのファイルは、各上流の発行元（GitHub、Pythonパッケージインデックス、download.pytorch.org）からダウンロードされます。AI Game Devがホストしているものではありません。
````
