---
title: Forge-3D — Image to Game-Ready 3D Assets
emoji: 🧊
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 6.18.0
app_file: app.py
pinned: true
license: apache-2.0
short_description: Image to 3D models with previews for game assets.
---

# Forge-3D

**Image (+text) → 3D** brick for game assets. Produces clean models + multi-view previews ready for texturing, rigging, and reverse describe flows.

Part of the 9 open **Forge Bricks** — composable Gradio Spaces for a complete AI-native game asset creation system.

## Capabilities
- Image (or image + text) → game-ready 3D (glb/obj)
- Multi-view preview renders (for VLM describe / consistency in other bricks)
- Health-checked cloud fallbacks + strong local ComfyUI / TripoSR path (excellent on 12GB GPUs)
- Rich `manifest.json` output with lineage support

## Quick Start (Local)

```bash
# From forge-bricks root (recommended)
./install.sh
source .venv/bin/activate
cd forge-3d
python app.py
```

Or with uv directly:
```bash
cd forge-3d && uv pip install -r requirements.txt && python app.py
```

## API Endpoint (Daggr / Agents)
- `/generate_3d` — main entry point

Example:
```python
from daggr import GradioNode
model = GradioNode("jkorstad/forge-3d", api_name="/generate_3d", ...)
```

## HF Space & Best Practices
- Optimized for **ZeroGPU** (orchestration + client calls; heavy lifting can be local or dedicated).
- Uses adapter + health monitoring pattern (inspired by 3d-creator-suite) for reliability.
- Always returns structured manifests for the rest of the pipeline.

## Local First (4070 Ti Class)
Primary recommended path: ComfyUI + TripoSR / similar local models for zero cost and no rate limits. The Gradio app runs identically locally.

## Related Bricks
- **forge-visuals** (bidirectional partner — generate concepts then 3D, or 3D renders → text)
- forge-texture, forge-rig, forge-anim, forge-refiner, etc.

See the main Forge Bricks README and approved plan for full daggr composition examples and ForgeDNA integration.

*Open, agent-usable building blocks for creators.*