Spaces:
Sleeping
Sleeping
| 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.* |