# Step1X-3D Geometry (lokales 3D-Modell)

> Lokales Image-to-3D: StepFuns Step1X-3D Geometry 1.3B verwandelt ein Bild in ein untexturiertes 3D-Mesh (GLB) für Game-Props und Charaktere – auf deiner NVIDIA GPU mit 16 GB VRAM. Läuft offline in der Local Python models runtime. Apache-2.0, kommerzielle Nutzung erlaubt.

- Id: `aigd.model3d-step1x-3d-geometry`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 1.0.4 (veröffentlicht am 2026-11-22)
- Lizenz: Apache-2.0
- 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-step1x-3d-geometry

## Installieren

Mit der gamedev CLI im Projektordner:

```bash
gamedev pkg add aigd.model3d-step1x-3d-geometry
```

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.model3d-step1x-3d-geometry` 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
# Step1X-3D Geometry 1.3B (`aigd.model3d-step1x-3d-geometry`)

Step1X-3D Geometry 1.3B verwandelt ein Bild auf deiner NVIDIA GPU (16 GB VRAM oder mehr) in eine 3D-Form – mit dem Geometriemodell von [Step1X-3D](https://github.com/stepfun-ai/Step1X-3D) von StepFun. Das Ergebnis ist ein untexturiertes GLB. In AI Game Dev läuft es lokal über die **Local Python models runtime** (`aigd.python`). Gewichte und Code stehen unter Apache-2.0, ohne territoriale Beschränkung und ohne Nutzerobergrenze, deshalb eignet es sich für kommerzielle Spiele überall.

## Was du erstellen kannst

- Untexturierte Meshes von Props, Gebäuden, Fahrzeugen, Kreaturen und Charakteren aus einem einzigen Bild.
- Basis-Meshes, die du später texturieren, retopologisieren oder riggen kannst.
- 3D-Blockouts aus Concept Art.

## Beispielanfragen

- „Verwandle `Concepts/barrel.png` mit Step1X-3D in ein 3D-Modell.“
- „Erstelle ein Mesh aus dem Drachen-Konzept.“
- „Generiere die 3D-Form aus diesem Haus-Bild.“

## Highlights

|  |  |
|---|---|
| Modell-ID | `aigd.model3d-step1x-3d-geometry.v1` |
| Vorgang | Bild zu 3D (ein Eingabebild mit transparentem Hintergrund) |
| Ausgabe | untexturiertes GLB, Flächen standardmäßig auf 200.000 reduziert |
| Schritte | standardmäßig 50 |
| Läuft auf | NVIDIA GPU (CUDA) mit 16 GB VRAM oder mehr |
| Download | etwa 7,2 GB, dazu die Python-Umgebung der Runtime beim ersten Laden |
| Lizenz | Apache-2.0, kommerzielle Nutzung erlaubt |

## Weitere lokale Image-to-3D-Modelle

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): untexturiert, 8 GB VRAM.
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape): untexturiert, 10 GB VRAM.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) und [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d): texturiertes GLB mit PBR-Materialien, 16 GB auf einer NVIDIA- oder Vulkan-GPU.

## So läuft es

**Das Texturmodell von Step1X-3D ist nicht enthalten.** Es benötigt `nvdiffrast` (NVIDIA Source Code License, nicht kommerziell) und `pytorch3d` (keine vorgebauten Pakete), deshalb kann es nicht in der Runtime der App laufen. Verwende ein Bild mit einem einzelnen Objekt auf transparentem Hintergrund: Die App schneidet es auf das Objekt zu. Flächen werden standardmäßig auf 200.000 reduziert.

Die Ausgabe kann kleine abgetrennte Teile enthalten: In GPU-Prüfungen von TripoSG, Step1X-3D und Hunyuan3D umfasste die Hauptkomponente 97,5–99,2 % der Flächen.

Dieses Paket enthält nur Daten. Es benötigt die **Local Python models runtime** (`aigd.python`), die beim ersten Laden eine private Python-Umgebung für das Modell einrichtet (einige GB PyTorch und Bibliotheken, siehe README des Pakets). 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 7,2 GB, festgelegt über Hugging Face Revision und sha256:

| Datei | Größe | Lizenz | Quelle |
|---|---|---|---|
| `model_index.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/model_index.json) |
| `scheduler-scheduler_config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/scheduler/scheduler_config.json) |
| `transformer-config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/config.json) |
| `transformer-diffusion_pytorch_model.safetensors` | 5.27 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/diffusion_pytorch_model.safetensors) |
| `vae-config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/config.json) |
| `vae-diffusion_pytorch_model.safetensors` | 0.77 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/diffusion_pytorch_model.safetensors) |
| `visual_eature_extractor-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_eature_extractor/preprocessor_config.json) |
| `visual_encoder-config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/config.json) |
| `visual_encoder-diffusion_pytorch_model.safetensors` | 1.22 GB | Apache-2.0 | [Datei](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/diffusion_pytorch_model.safetensors) |
| `dinov2-with-registers-large-config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/config.json) |
| `dinov2-with-registers-large-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [Datei](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/preprocessor_config.json) |

Der Python-Code des Modells wird vom festgeschriebenen Commit auf GitHub heruntergeladen, jede Datei per sha256 geprüft.

## Lizenz

- **Gewichte: Apache-2.0**, © StepFun ([Modellkarte](https://huggingface.co/stepfun-ai/Step1X-3D/tree/bf7084495b3a72222f36549b7942948aa4d9daa7)).
- **Inferenzcode** (`step1x3d_geometry/`, von GitHub beim Commit [`cb5ac94`](https://github.com/stepfun-ai/Step1X-3D/tree/cb5ac944709c6c913109070c7b90c3447f57f3d4)): Apache-2.0 ([Lizenz](https://github.com/stepfun-ai/Step1X-3D/blob/cb5ac944709c6c913109070c7b90c3447f57f3d4/LICENSE)).
- **Konfigurationsdatei von DINOv2 with registers (large)**: Apache-2.0, © Meta Platforms ([Modellkarte](https://huggingface.co/facebook/dinov2-with-registers-large/tree/e4c89a4e05589de9b3e188688a303d0f3c04d0f3)). Davon werden nur `config.json` und `preprocessor_config.json` heruntergeladen; die Encoder-Gewichte sind Teil von Step1X-3D.

Erforderliche Namensnennung: "Step1X-3D © StepFun (Apache-2.0)".

**Einschränkungen:** Kommerzielle Nutzung ist erlaubt. Eine Weitergabe der Gewichte erfordert den Apache-2.0-Lizenztext und die Hinweise von StepFun.
````
