# Local 3D generation

> Local 3D generationランタイム: Microsoft TRELLIS.2 の C++ ポートである trellis.cpp が、1 枚の画像からテクスチャ付き 3D モデル（PBR マテリアル付き GLB）を、お使いの NVIDIA または Vulkan GPU 上で、モデルごとの費用なしに生成します。別途インストールする TRELLIS.2 4B および Pixal3D モデルパッケージを実行します。Windows 対応、Linux はプレビューです。

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

## インストール

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

```bash
gamedev pkg add aigd.trellis
```

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

## バージョン

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

## 説明

````markdown
# Local 3D generation (`aigd.trellis`)

Local 3D generationは、Microsoft TRELLIS.2 の C++/GGML ポートである [trellis.cpp](https://github.com/pwilkin/trellis.cpp) を使って、1 枚の画像からテクスチャ付き 3D モデル（PBR マテリアル付き GLB）をこのコンピューター上で、お使いの GPU で生成するランタイムです。すべてがお使いのコンピューター上で作られ、作成に費用はかかりません。このパッケージ自体にはモデルは含まれておらず、3D モデルパッケージの [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) と [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d) を実行します。クラウドサービスを使わずにテクスチャ付き 3D アセットを手に入れたい、NVIDIA または Vulkan GPU を搭載した開発者に適しています。

## 作成できるもの

モデルパッケージをインストールすると、次のことができます。

- 1 枚の画像から、テクスチャ付きで PBR 対応のプロップ、武器、家具、車両、キャラクターを作成。
- コンセプトアートや実在の物体の写真を 3D 化。
- テキストから 3D へは 2 ステップで行います。まずローカルまたはクラウドの画像モデルで画像を作り、それを 3D 化します。

## リクエストの例

- 「`Concepts/crate.png` をテクスチャ付き 3D モデルにしてください」
- 「木製の市場の屋台の画像を作り、それを 3D モデルにしてください」
- 「この写真から Pixal3D で解像度 1024 の 3D モデルを生成してください」

## ハイライト

|  |  |
|---|---|
| ランタイム | trellis.cpp v0.8.1 (MIT) |
| 動作 | 画像からテクスチャ付き 3D へ（GLB、PBR マテリアル） |
| モデル | 別個のパッケージ: TRELLIS.2 4B（約 16.5 GB）、Pixal3D（約 14.5 GB） |
| Windows | NVIDIA GPU（CUDA 13）または AMD / Intel / その他の GPU（Vulkan） |
| Linux | x64、NVIDIA（CUDA 13）または Vulkan、プレビュー |
| macOS | 提供なし（上流ビルドなし） |
| ダウンロード | 14–16 MB（Vulkan）または 715 MB（CUDA、NVIDIA ランタイムを含む） |
| ライセンス | MIT。各モデルパッケージは独自のライセンスを明記しています |

## 動作の仕組み

このパッケージはデータのみで（`aigd-package.json`、コードは含みません）、お使いのコンピューターに合わせてどの trellis.cpp リリースをダウンロードすべきかを AI Game Dev に伝えます。アプリがプログラム自体をダウンロードし、検証して実行します。**3D Gen** スイッチは、オンにするまでオフです。

3D モデルは、ローカルの画像・クリップ・音声と 1 つのローカル GPU キューを共有します。同時に実行されるモデルは 1 つだけで、3D ジョブは前に並んでいる画像やクリップの完了を待ちます（その逆も同様です）。3D ジョブには数分かかりますが、いつでも停止できます。

## モデルは別個のパッケージです

このパッケージにはモデルが含まれていません。パッケージブラウザーからモデルパッケージをインストールし、モデルパネルからそのファイルをダウンロードしてください。確認なしにダウンロードされることはなく、事前にサイズが表示されます。

- `aigd.model3d-trellis2-4b` — TRELLIS.2 4B（Microsoft）、約 16.5 GB。
- `aigd.model3d-pixal3d` — Pixal3D（Tencent ARC）、約 14.5 GB。TRELLIS.2 と 3.5 GB のファイルを共有するため、両方合わせて約 27 GB になります。

すべてのモデルはテクスチャ付きです。trellis.cpp v0.8.1 はテクスチャリング時のみメッシュを簡略化し、ジオメトリのみの生のメッシュ（数百万面）はアプリの GLB 制限を超えるため、ジオメトリのみの実行は提供されていません。

テキストから 3D（まず画像モデルを使い、次に画像から 3D へ）はまだ組み込まれていません。ローカルまたはクラウドの画像モデルで画像を作り、それを 3D 化してください。

## ダウンロードされるもの

タグで固定され、sha256 で検証される上流のリリース: `pwilkin/trellis.cpp` [`v0.8.1`](https://github.com/pwilkin/trellis.cpp/releases/tag/v0.8.1)（コミット `c0bed38`）。アプリがお使いのコンピューターに合わせて 1 つのバリアントを選びます。

| バリアント | コンピューター | ダウンロード |
|---|---|---|
| `win-x64-cuda13` | Windows、NVIDIA GPU（ドライバー 580.88 以降、コンピュートケイパビリティ 7.5 以降。RTX 20 シリーズ以降） | 715 MB（プログラム + NVIDIA CUDA 13 ランタイム） |
| `win-x64-vulkan` | Windows、AMD / Intel / その他の GPU | 14 MB |
| `linux-x64-cuda13` | Linux x64、NVIDIA GPU（ドライバー 580.65 以降）、glibc 2.34 および libstdc++ `GLIBCXX_3.4.30` 以降（Ubuntu 22.04+）、`libgomp.so.1` | 715 MB |
| `linux-x64-vulkan` | Vulkan GPU を搭載した Linux x64、glibc 2.34 および libstdc++ `GLIBCXX_3.4.30` 以降（Ubuntu 22.04+）、`libgomp.so.1` および `libvulkan.so.1` | 16 MB |

**Linux はプレビューです**。実際の Linux GPU ではまだテストされていません。

提供されていないもの:

- **macOS。** trellis.cpp は Apple silicon で動作します（Metal。上流では 24 GB の M5 で res-512 モデルを 9:21 で計測）が、上流は macOS ビルドを公開していません。ソースからのビルドが必要です。
- **ROCm** ビルド（上流は実験的と位置づけ、1 つの APU（gfx1151）を対象としています）と、Pascal/Volta GPU（コンピュートケイパビリティ 6–7）向けの `cuda12` ビルド。AMD GPU は Vulkan を使用します。

Windows ビルドには Microsoft Visual C++ 2015–2022 ランタイム（`MSVCP140.dll`、`VCRUNTIME140_1.dll`）が必要です。ほとんどの Windows PC には既にインストールされていますが、アーカイブには同梱されていません。

アプリがドライバーやシステムライブラリをインストールすることはありません。不足しているものがあれば、何をインストールすべきかを知らせます。

## ライセンス

- trellis.cpp — MIT、© Piotr Wilkin（[ライセンス](https://github.com/pwilkin/trellis.cpp/blob/v0.8.1/LICENSE)）。
- 同梱のサードパーティコード（すべてリリースバイナリに組み込まれています）: ggml（MIT）、xatlas（MIT）、meshoptimizer（MIT）、Fast Quadric Mesh Simplification（MIT）、cpp-httplib（MIT）、stb（MIT またはパブリックドメイン）、libwebp（[BSD-3-Clause](https://github.com/webmproject/libwebp/blob/v1.5.0/COPYING)）。
- NVIDIA CUDA ランタイム（cudart、cuBLAS）。CUDA バリアントのみに含まれ、上流によって [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) の下で再配布されています。
- 本パッケージ — MIT。各モデルパッケージは独自のライセンスを明記しています。

必要な表示義務: プログラムの使用についてはありません。リリースアーカイブにはライセンス文が含まれていません。バイナリを再配布する場合は、通知を自身で含めてください。上流の [LICENSE](https://github.com/pwilkin/trellis.cpp/blob/v0.8.1/LICENSE)、[`thirdparty/`](https://github.com/pwilkin/trellis.cpp/tree/v0.8.1/thirdparty) にあるライセンス、libwebp の BSD 通知、そして CUDA バリアントの場合は NVIDIA CUDA EULA です。

制限: ランタイムによるものはありません。モデルパッケージには独自の制限があります（それぞれを参照してください）。

すべてのファイルは上流の GitHub リリースからダウンロードされます。AI Game Dev はそれらをホストしていません。
````
