# SkinTokens (lokales Auto-Rigging)

> Lokales Auto-Rigging: SkinTokens von VAST-AI fügt einem Charakter- oder Kreatur-Mesh (GLB, OBJ oder FBX) ein Skelett und Skin-Gewichte hinzu und schreibt eine geriggte GLB, die die ursprünglichen Materialien und UVs behält. Läuft in Asset Studio auf deiner NVIDIA GPU mit 14 GB VRAM. MIT, kommerzielle Nutzung erlaubt.

- Id: `aigd.model3d-skintokens`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: Werkzeuge
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 1.0.4 (veröffentlicht am 2026-11-22)
- Lizenz: MIT
- Erfordert die AI Game Dev App: `>=0.32.0-beta.6`
- Nativer Code: nein
- Bewertung: noch nicht bewertet
- HTML-Seite: https://ai-game.dev/de/packages/aigd.model3d-skintokens

## Installieren

Mit der gamedev CLI im Projektordner:

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

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.model3d-skintokens` und klicke auf **Add to Project**. Mehr: https://ai-game.dev/docs/wiki/app/packages

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.32.0-beta.6` | neueste |
| 1.0.3 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Beschreibung

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

SkinTokens riggt ein 3D-Modell auf deiner NVIDIA GPU (14 GB VRAM oder mehr) mit [SkinTokens](https://github.com/VAST-AI-Research/SkinTokens) von VAST-AI. Es sagt ein Skelett und Skin-Gewichte für ein Charakter- oder Kreatur-Mesh voraus und schreibt sie in deine Originaldatei, sodass Materialien und UVs erhalten bleiben. Das Ergebnis ist eine geriggte GLB. In AI Game Dev läuft es lokal über die **Local Python models runtime** (`aigd.python`). Es eignet sich für Entwickler, die ein erstes Rig für einen generierten oder handgebauten Charakter brauchen, bevor sie ihn animieren.

## Was du erstellen kannst

- Geriggte Charaktere und Kreaturen aus einem GLB-, OBJ- oder FBX-Mesh, bereit zur Animation in deiner Engine oder deinem DCC-Tool.
- Erste Skelette und Skin-Gewichte für Meshes, die von den lokalen Image-to-3D-Modellen erzeugt wurden.
- Mehrere Rig-Kandidaten für ein Mesh: bei jedem Lauf wird ein neues Skelett gesampelt.

## So verwendest du es

Das Rigging läuft über **Asset Studio**, nicht über den Chat-Agenten:

1. Öffne Asset Studio und wähle **3D → SkinTokens → Rig**.
2. Füge das zu riggende Mesh hinzu: eine GLB-, OBJ- oder FBX-Datei, zum Beispiel `Assets/Models/goblin.glb`.
3. Prüfe die geriggte GLB. Wenn das Skelett nicht zum Modell passt, starte erneut: bei jedem Lauf wird ein neues Skelett gesampelt.

## Highlights

|  |  |
|---|---|
| Modell-ID | `aigd.model3d-skintokens.v1` |
| Operation | ein 3D-Modell riggen (ein Eingabe-Mesh: GLB, OBJ oder FBX) |
| Ausgabe | geriggte GLB mit Skelett und Skin-Gewichten; ursprüngliche Materialien und UVs bleiben erhalten |
| Läuft auf | NVIDIA GPU (CUDA) mit 14 GB VRAM oder mehr |
| Download | etwa 1,6 GB, plus die Python-Umgebung der Runtime (mit Blender als Python-Modul) beim ersten Laden |
| Lizenz | MIT, kommerzielle Nutzung des Modells und seiner Rigs erlaubt |

Meshes zum Riggen können von [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) oder deinen eigenen Tools stammen.

## So läuft es

Dieses Paket enthält nur Daten. Es benötigt die **Local Python models runtime** (`aigd.python`). Beim ersten Laden wird eine private Python-3.11-Umgebung mit PyTorch und Blender als Python-Modul aufgebaut (`bpy` 4.5 LTS, etwa 330 MB). Blender liest und schreibt die Meshes. FlashAttention wird nicht installiert: Die Attention läuft über die in PyTorch eingebauten Kernel. Open3D wird ebenfalls nicht installiert: Das Voxelgitter für die Glättung der Skin-Gewichte wird in NumPy mit derselben Mathematik wie bei Open3D aufgebaut. Die Checkpoints werden nur als Tensoren geladen, nie als Code. Die Modelle laufen offline; ihre Gewichte stammen ausschließlich aus den unten aufgeführten Dateien, die nach deiner Bestätigung von Hugging Face heruntergeladen werden. AI Game Dev hostet sie nicht.

## Was heruntergeladen wird

Etwa 1,6 GB, festgelegt über Hugging Face Revision und sha256:

| Datei | Größe | Lizenz | Quelle |
|---|---|---|---|
| `skin_vae_2_10_32768-last.ckpt` | 0.49 GB | MIT | [Datei](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 | [Datei](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 | [Datei](https://huggingface.co/Qwen/Qwen3-0.6B/resolve/c1899de289a04d12100db370d81485cdf75e47ca/config.json) |

Der Python-Code des Modells (`src/`, `configs/skeleton/`) wird von GitHub beim Commit [`273b691`](https://github.com/VAST-AI-Research/SkinTokens/tree/273b691d35989d71cd17ff2895fdc735097b92d1) heruntergeladen, jede Datei per sha256 geprüft.

## Lizenz

- **Gewichte und Code: MIT**, © 2025 VAST-AI-Research ([Lizenz](https://github.com/VAST-AI-Research/SkinTokens/blob/273b691d35989d71cd17ff2895fdc735097b92d1/LICENSE), [Modellkarte](https://huggingface.co/VAST-AI/SkinTokens/tree/79736cad0fd84de384d5eede659b4ebd24effe33)).
- **Qwen3-0.6B-Konfigurationsdatei**: Apache-2.0, © Alibaba Cloud ([Modellkarte](https://huggingface.co/Qwen/Qwen3-0.6B/tree/c1899de289a04d12100db370d81485cdf75e47ca)). Es wird nur ihre `config.json` heruntergeladen; die Gewichte des Sprachmodells sind Teil von SkinTokens.
- **Blender als Python-Modul** (`bpy` 4.5.16): GPL-3.0-or-later, © Blender Foundation ([PyPI](https://pypi.org/project/bpy/4.5.16/)). Die Runtime installiert es von PyPI in die private Umgebung des Modells, wo der Rigging-Handler der App es importiert, um Meshes zu lesen und zu schreiben. AI Game Dev liefert bpy nicht mit.
- **Der Rigging-Handler** (`skintokens/handler.py` in der Python-Runtime der App): **GPL-3.0-or-later**, weil er bpy importiert. Er läuft als eigenständiges Programm im eigenen Python-Worker-Prozess des Modells, den die App startet und mit dem sie ausschließlich über JSON-Nachrichten über stdio kommuniziert. Sein Quellcode wird mit der App ausgeliefert; siehe `THIRD_PARTY_NOTICES.md`.

Erforderliche Namensnennung: "SkinTokens © 2025 VAST-AI-Research (MIT)".

**Einschränkungen:** Die kommerzielle Nutzung des Modells und der davon erzeugten Rigs ist erlaubt. Eine Weitergabe der Gewichte erfordert den MIT-Copyright-Hinweis.
````
