# Lokale Python-Modelllaufzeit

> Führt lokale Modelle, die keinen C++- oder ONNX-Port haben (3D-Generierung und Rigging), mit PyTorch auf diesem Computer aus – in einer privaten Python-Umgebung pro Modell, die dein eigenes Python nie berührt. Modelle wie TripoSG, Hunyuan3D-2.1 Shape und SkinTokens sind separate Pakete.

- Id: `aigd.python`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 1.0.2 (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.python

## Installieren

Mit der gamedev CLI im Projektordner:

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

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

## Versionen

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

## Beschreibung

````markdown
# Lokale Python-Modelllaufzeit (`aigd.python`)

Die lokale Python-Laufzeit von AI Game Dev: Sie führt lokale Modelle auf diesem Computer mit [PyTorch](https://pytorch.org) aus, für Modelle, die keinen C++- oder ONNX-Port haben, etwa Image-to-3D, Mesh-Verfeinerung und Auto-Rigging. Alles läuft auf deinem Computer und verbraucht nichts von deinem AI Game Dev-Kontingent. Sie passt zu Game-Developern, die Concept Art in 3D-Formen verwandeln oder Charaktere auf ihrer eigenen GPU riggen wollen. Die Modelle selbst sind separate Pakete.

## Was du machen kannst

- Verwandle ein einzelnes Concept-Bild mit einem lokalen Image-to-3D-Modell in eine 3D-Form, zum Beispiel [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) oder [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry).
- Rigge ein Charakter- oder Kreatur-Mesh (Skelett und Skin-Weights) mit [SkinTokens](https://ai-game.dev/packages/aigd.model3d-skintokens) im Asset Studio.
- Deine eigene Python-Installation bleibt unangetastet: Jedes Modell bekommt seine eigene private Umgebung.

## Beispielanfragen

- „Verwandle `Assets/Concepts/goblin.png` mit TripoSG auf meiner GPU in eine 3D-Form.“
- „Erstelle lokal mit Hunyuan3D-2.1 Shape ein 3D-Modell aus diesem Schatztruhen-Bild.“
- „Verwandle `Assets/Concepts/crate.png` mit Step1X-3D Geometry in eine 3D-Form.“

## So funktioniert es

Dieses Paket enthält nur Daten (`aigd-package.json`, keinen Code). Es teilt AI Game Dev mit, welche Version von [uv](https://github.com/astral-sh/uv) für deinen Computer heruntergeladen werden soll. Die App nutzt uv, um für jedes Modell eine private Python-Umgebung aufzubauen. **Dein eigenes Python wird nie angefasst.** Nichts wird global installiert, nichts landet in `PATH`, und nichts wird in die Windows-Registrierung geschrieben. Alles liegt im Modellspeicher der App, in `python/`.

## Modelle sind separate Pakete

Dieses Paket enthält kein Modell. Installiere ein Modellpaket aus dem Paket-Browser und lade dann seine Dateien im Modelle-Panel herunter. Nichts wird ohne deine Bestätigung heruntergeladen, und du siehst vorher die Größe.

Beim ersten Laden eines Modells baut die App seine Python-Umgebung auf. Sie lädt Python 3.12 und PyTorch mit den übrigen Bibliotheken des Modells herunter, was bei einem CUDA-Build 2 bis 4 GB sind. Das kann mehrere Minuten dauern. Spätere Ladevorgänge nutzen die Umgebung wieder. Wird ein Download unterbrochen, beginnt der nächste Ladevorgang von vorn und nutzt jede bereits heruntergeladene Datei weiter.

## Was heruntergeladen wird

- **uv** — Upstream-Release [`0.13.7`](https://github.com/astral-sh/uv/releases/tag/0.13.7), per sha256 gepinnt. Die App wählt eine Variante für deinen Computer:

  | Variante | Computer | Download |
  |---|---|---|
  | `win-x64-cuda` | Windows, NVIDIA-GPU (Treiber 572.61 oder neuer, Compute Capability 7.0 oder neuer) | 15 MB |
  | `win-x64-cpu` | Windows ohne unterstützte NVIDIA-GPU | 15 MB |
  | `linux-x64-cuda` | Linux x64, NVIDIA-GPU (Treiber 570.124 oder neuer, Compute Capability 7.0 oder neuer), glibc 2.28 oder neuer | 17 MB |
  | `linux-x64-cpu` | Linux x64 ohne unterstützte NVIDIA-GPU, glibc 2.28 oder neuer | 17 MB |
  | `darwin-arm64-metal` | Mac mit Apple Silicon, macOS 14 oder neuer (PyTorch nutzt die GPU über MPS) | 14 MB |

  **Linux ist eine Vorschau.** Es wurde noch nicht auf einer echten Linux-GPU getestet.
- **Python** 3.12.16 (3.11.18 oder 3.13.18 für ein Modell, dessen Bibliotheken es benötigen): ein CPython-Build aus [python-build-standalone](https://github.com/astral-sh/python-build-standalone). uv lädt es herunter und prüft es gegen die Prüfsummen, die im gepinnten uv-Release hinterlegt sind.
- **Die Python-Bibliotheken jedes Modells**: PyTorch 2.11 (CUDA 12.8 auf NVIDIA) und die eigenen Bibliotheken des Modells, von [PyPI](https://pypi.org) und [download.pytorch.org](https://download.pytorch.org). Die App liefert die exakte Liste für jedes Modell mit, gepinnt nach Version und sha256. Installationen nutzen nur Wheels, es wird also nichts auf deinem Computer kompiliert. Eine Datei, die nicht zu ihrer sha256 passt, bricht die Installation ab.

Modelle laufen offline. Ihre Gewichte stammen ausschließlich aus den Dateien, die du im Modelle-Panel heruntergeladen hast.

## Voraussetzungen

- Jedes Modellpaket nennt seinen eigenen GPU- und Videospeicherbedarf.
- Die App installiert niemals Treiber oder Systembibliotheken. Wenn PyTorch deine GPU nicht sieht, lädt das Modell nicht, und die App fordert dich auf, den NVIDIA-Treiber zu aktualisieren.
- AI Game Dev 0.32.0-beta.6 oder neuer.

## Lizenz

- Dieses Paket — 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. Die python-build-standalone-Distribution trägt außerdem die Lizenzen der Bibliotheken, die sie bündelt (OpenSSL, SQLite, zlib und andere). Ihre Build-Skripte stehen unter MPL-2.0 ([Lizenz](https://github.com/astral-sh/python-build-standalone/blob/main/LICENSE)).
- PyTorch — BSD-3-Clause, © Meta Platforms und Mitwirkende ([Lizenz](https://github.com/pytorch/pytorch/blob/main/LICENSE)).
- NVIDIA-CUDA-Bibliotheken (cuBLAS, cuDNN und andere), nur in den CUDA-Varianten. Sie stecken in den CUDA-PyTorch-Wheels und werden unter der [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) weitergegeben.
- Jedes Modellpaket nennt seine eigene Lizenz. Einige 3D-Modelle haben Einschränkungen beim Gebiet oder bei der kommerziellen Nutzung. Das Modelle-Panel zeigt die Einschränkungen, bevor etwas heruntergeladen wird.

Erforderliche Namensnennung: keine für dieses Paket. Modellpakete nennen ihre eigene.

**Einschränkungen:** keine durch dieses Paket. Die NVIDIA CUDA EULA erlaubt es, diese Bibliotheken zusammen mit der Anwendung zu verwenden, sie aber nicht separat weiterzugeben.

Alle Dateien werden von ihren ursprünglichen Herausgebern heruntergeladen (GitHub, der Python-Paketindex, download.pytorch.org). AI Game Dev hostet sie nicht.
````
