---
title: Forge-Visuals — Game Asset Concepts & Editing
emoji: 🎨
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 6.18.0
app_file: app.py
pinned: true
license: apache-2.0
short_description: Text-to-image, edit, describe and sprite prep for games.
---

# Forge-Visuals

**Versatile game asset visual brick** — the foundation for concepting, iteration, and 2D prep in the full AI-native game asset creation system.

This is one of 9 open, composable Gradio Spaces (Forge Bricks) designed to be chained with [daggr](https://huggingface.co/docs/hub/spaces#daggr) and integrated into ForgeDNA / Aetherium workflows.

## Capabilities
- Text → high-quality game-styled concept images (with style references + variants)
- Image refine / edit (img2img + strength control)
- Reverse describe (image or 3D render → rich text prompt for bidirectional loops)
- Sprite prep (background removal + clean game-ready sprites)

## Quick Start (Local)

```bash
# Recommended (fast uv setup from parent dir)
cd dev/forge-bricks
./install.sh
source .venv/bin/activate
cd forge-visuals
python app.py
```

Or standalone:
```bash
pip install -r requirements.txt
python app.py
```

## API Endpoints (for Daggr / Agents / ForgeDNA)
- `/generate_concept` — main T2I + variants
- `/refine_edit` — iterative editing
- `/describe_asset` — reverse text description
- `/prep_sprite` — background removal & cleanup

Example with `gradio_client` or daggr `GradioNode`:
```python
from daggr import GradioNode
visuals = GradioNode("jkorstad/forge-visuals", api_name="/generate_concept", ...)
```

## HF Space Best Practices
- Runs on **ZeroGPU** (lightweight image generation + client calls).
- Always returns rich `manifest.json` with `parent_id` for lineage/editing tracking.
- Health monitoring + fallbacks for robustness (inspired by 3d-creator-suite patterns).

## Local 4070 Ti / Zero-Cost Path
Excellent local experience via ComfyUI workflows (concept art, background removal, VLM describe). The same Gradio app runs locally.

## License & Commercial Use
Outputs follow the license of the underlying model (primarily Apache 2.0 via FLUX.1-schnell when using the primary path). Each generated manifest surfaces `commercial_ok`.

## Part of the Forge Bricks System
These 9 bricks (visuals, 3D, audio with Qwen TTS, texture, shader/VFX, props/env/UI, rig, anim, refiner) are designed to stack together for a complete open-source game asset pipeline.

See the parent [forge-bricks README](https://huggingface.co/spaces/jkorstad/forge-visuals) (or the repo) and the approved build plan for the full vision, daggr composition examples, and integration with ForgeDNA.

**Related bricks on this account:**
- forge-3d, forge-audio (Qwen voice), forge-texture, forge-shader-vfx, forge-props-env-ui, forge-rig, forge-anim, forge-refiner

---

*Built as part of an open, agent-native game creation system. Feedback and contributions welcome.*