Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Lokale Python-Modelllaufzeit

Offiziell3Dv1.0.2aigd.python
Oder im Terminal
gamedev pkg add aigd.python

Übersicht

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.

Die lokale Python-Laufzeit von AI Game Dev: Sie führt lokale Modelle auf diesem Computer mit PyTorch 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, Hunyuan3D-2.1 Shape oder Step1X-3D Geometry.
  • Rigge ein Charakter- oder Kreatur-Mesh (Skelett und Skin-Weights) mit 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 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, per sha256 gepinnt. Die App wählt eine Variante für deinen Computer:
VarianteComputerDownload
win-x64-cudaWindows, NVIDIA-GPU (Treiber 572.61 oder neuer, Compute Capability 7.0 oder neuer)15 MB
win-x64-cpuWindows ohne unterstützte NVIDIA-GPU15 MB
linux-x64-cudaLinux x64, NVIDIA-GPU (Treiber 570.124 oder neuer, Compute Capability 7.0 oder neuer), glibc 2.28 oder neuer17 MB
linux-x64-cpuLinux x64 ohne unterstützte NVIDIA-GPU, glibc 2.28 oder neuer17 MB
darwin-arm64-metalMac 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. 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 und 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, Apache-2.0).
  • CPython — PSF License 2.0, © 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).
  • PyTorch — BSD-3-Clause, © Meta Platforms und Mitwirkende (Lizenz).
  • 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 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.

Versionen

Releases von Lokale Python-Modelllaufzeit
VersionVeröffentlichtBenötigt die App
1.0.2Neueste0.32.0-beta.6 oder neuer
1.0.10.32.0-beta.6 oder neuer

Installieren

In der Desktop-App

Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle Browse, suche aigd.python und klicke auf Add to Project.

Noch keine App? Lade AI Game Dev kostenlos herunter für Windows, macOS oder Linux.

Im Terminal

Mit der gamedev CLI in deinem Projektordner:

gamedev pkg add aigd.python

Voraussetzungen

  • AI Game Dev 0.32.0-beta.6 oder neuer

Mehr zu Packages

Installieren
gamedev pkg add aigd.python