DEPLOY.md

GameForge Space - HF Spaces Deployment

To deploy this to Hugging Face Spaces:

1. Create a new Space on huggingface.co/new-space

- SDK: Gradio

- Hardware: ZeroGPU (free quota, 3.5 min/day)

2. Push this space/ directory:

huggingface-cli upload jkorstad/gameforge-space ./space/

3. The app will be live at:

https://huggingface.co/spaces/jkorstad/gameforge-space

What you get:

- Custom HTML/JS frontend (not Gradio components)

- gradio.Server backend with FastAPI routes

- ZeroGPU for model inference (free!)

- Queuing and concurrency management

- gradio_client API compatibility

- MCP tool registration

- SSE streaming support

API endpoints (all gradio_client compatible):

- /registry_info - List all models

- /get_route - Get routing for a model

- /list_pipelines - List pipeline definitions

- /format_prompt - Format prompt with templates

- /format_npc - Format NPC dialogue

- /generate_image - Generate image via FLUX (ZeroGPU)

- /generate_3d - Generate 3D mesh via TRELLIS.2 (ZeroGPU)

- /generate_voice - Generate voice via MeloTTS (ZeroGPU)

- /generate_video - Generate video via LTX 2.3 (ZeroGPU)

- /generate_music - Generate music via ACE-Step (ZeroGPU)

- /generate_sfx - Generate SFX via TangoFlux (ZeroGPU)

- /list_assets - Browse generated assets

- /validate_asset - Validate asset quality

- /convert_asset - Convert asset format

MCP tools:

- gameforge_generate - Generate any asset type

- gameforge_list_models - List available models