README.md

metadata

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 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)

# 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:

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:

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 (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.