# SkinTokens（ローカル自動リギング）

> ローカル自動リギング：VAST-AI の SkinTokens は、キャラクターやクリーチャーのメッシュ（GLB、OBJ、FBX）にスケルトンとスキンウェイトを付与し、元のマテリアルと UV を保持したままリグ済み GLB を書き出します。Asset Studio から、お使いの NVIDIA GPU（VRAM 14 GB）で実行されます。MIT、商用利用可。

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

## インストール

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

```bash
gamedev pkg add aigd.model3d-skintokens
```

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

## バージョン

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

## 説明

````markdown
# SkinTokens (`aigd.model3d-skintokens`)

SkinTokens は、VAST-AI の [SkinTokens](https://github.com/VAST-AI-Research/SkinTokens) を使って、お使いの NVIDIA GPU（VRAM 14 GB 以上）上で 3D モデルをリギングします。キャラクターやクリーチャーのメッシュに対してスケルトンとスキンウェイトを予測し、元のファイルに書き込むため、マテリアルと UV が保持されます。結果はリグ済みの GLB です。AI Game Dev では、**ローカル Python モデルランタイム**（`aigd.python`）を通じてローカルで実行されます。生成したキャラクターや手作業で作ったキャラクターをアニメーションさせる前に、最初のリグが必要な開発者に適しています。

## 作成できるもの

- GLB、OBJ、FBX メッシュから作るリグ済みのキャラクターやクリーチャー。エンジンや DCC ツールでそのままアニメーションできます。
- ローカルの image-to-3D モデルが生成したメッシュに対する初期スケルトンとスキンウェイト。
- 1 つのメッシュに対する複数のリグ候補：実行するたびに新しいスケルトンがサンプリングされます。

## 使い方

リギングはチャットエージェントからではなく、**Asset Studio** から実行します：

1. Asset Studio を開き、**3D → SkinTokens → Rig** を選択します。
2. リグ対象のメッシュを追加します：GLB、OBJ、FBX ファイル（`Assets/Models/goblin.glb` など）。
3. リグ済みの GLB を確認します。スケルトンがモデルに合わない場合は、もう一度実行してください。実行するたびに新しいスケルトンがサンプリングされます。

## ハイライト

|  |  |
|---|---|
| モデル ID | `aigd.model3d-skintokens.v1` |
| 操作 | 3D モデルのリギング（入力メッシュ 1 つ：GLB、OBJ、FBX） |
| 出力 | スケルトンとスキンウェイトを含むリグ済み GLB。元のマテリアルと UV は保持されます |
| 実行環境 | VRAM 14 GB 以上の NVIDIA GPU（CUDA） |
| ダウンロード | 約 1.6 GB。加えて初回ロード時に、ランタイムの Python 環境（Python モジュール版 Blender を含む） |
| ライセンス | MIT。モデルおよび生成したリグの商用利用が可能 |

リグ対象のメッシュは、[TripoSG](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)、[TRELLIS.2](https://ai-game.dev/packages/aigd.model3d-trellis2-4b)、または独自のツールから用意できます。

## 実行の仕組み

このパッケージはデータのみで構成されています。**ローカル Python モデルランタイム**（`aigd.python`）が必要です。初回ロード時に、PyTorch と Python モジュール版 Blender（`bpy` 4.5 LTS、約 330 MB）を含む専用の Python 3.11 環境を構築します。メッシュの読み書きは Blender が行います。FlashAttention はインストールされません。アテンションは PyTorch 組み込みのカーネルで実行されます。Open3D もインストールされません。スキンウェイトのスムージングに使うボクセルグリッドは、Open3D と同じ計算方法で NumPy 上に構築されます。チェックポイントはテンソルとしてのみ読み込まれ、コードとして読み込まれることはありません。モデルはオフラインで動作し、その重みは以下に挙げるファイルのみに由来します。これらのファイルは、確認後に Hugging Face からダウンロードされます。AI Game Dev はこれらをホスティングしていません。

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

約 1.6 GB。Hugging Face のリビジョンと sha256 で固定されています：

| ファイル | サイズ | ライセンス | ソース |
|---|---|---|---|
| `skin_vae_2_10_32768-last.ckpt` | 0.49 GB | MIT | [ファイル](https://huggingface.co/VAST-AI/SkinTokens/resolve/79736cad0fd84de384d5eede659b4ebd24effe33/experiments/skin_vae_2_10_32768/last.ckpt) |
| `articulation_xl_quantization_256_token_4-grpo_1400.ckpt` | 1.13 GB | MIT | [ファイル](https://huggingface.co/VAST-AI/SkinTokens/resolve/79736cad0fd84de384d5eede659b4ebd24effe33/experiments/articulation_xl_quantization_256_token_4/grpo_1400.ckpt) |
| `Qwen3-0.6B-config.json` | 0.00 GB | Apache-2.0 | [ファイル](https://huggingface.co/Qwen/Qwen3-0.6B/resolve/c1899de289a04d12100db370d81485cdf75e47ca/config.json) |

モデルの Python コード（`src/`、`configs/skeleton/`）は、GitHub のコミット [`273b691`](https://github.com/VAST-AI-Research/SkinTokens/tree/273b691d35989d71cd17ff2895fdc735097b92d1) からダウンロードされ、各ファイルは sha256 で検証されます。

## ライセンス

- **重みとコード：MIT**、© 2025 VAST-AI-Research（[ライセンス](https://github.com/VAST-AI-Research/SkinTokens/blob/273b691d35989d71cd17ff2895fdc735097b92d1/LICENSE)、[モデルカード](https://huggingface.co/VAST-AI/SkinTokens/tree/79736cad0fd84de384d5eede659b4ebd24effe33)）。
- **Qwen3-0.6B 設定ファイル**：Apache-2.0、© Alibaba Cloud（[モデルカード](https://huggingface.co/Qwen/Qwen3-0.6B/tree/c1899de289a04d12100db370d81485cdf75e47ca)）。ダウンロードされるのはその `config.json` のみで、言語モデルの重みは SkinTokens に含まれています。
- **Python モジュール版 Blender**（`bpy` 4.5.16）：GPL-3.0-or-later、© Blender Foundation（[PyPI](https://pypi.org/project/bpy/4.5.16/)）。ランタイムはこれを PyPI からモデル専用の環境にインストールし、アプリのリギングハンドラーがそこからインポートしてメッシュの読み書きを行います。AI Game Dev は bpy を同梱していません。
- **リギングハンドラー**（アプリの Python ランタイム内の `skintokens/handler.py`）：bpy をインポートするため **GPL-3.0-or-later** です。これは独立したプログラムとして、モデル自身の Python ワーカープロセス内で動作します。アプリはそのプロセスを起動し、stdio 経由の JSON メッセージだけでやり取りします。ソースコードはアプリに同梱されています。`THIRD_PARTY_NOTICES.md` を参照してください。

必要な表示："SkinTokens © 2025 VAST-AI-Research (MIT)"。

**制限事項：** モデルおよび生成したリグの商用利用は許可されています。重みを再配布する場合は、MIT の著作権表示が必要です。
````
