gameforge / DEPLOY.md
jkorstad's picture
GameForge v0.2.0 - gradio.Server with custom frontend + ZeroGPU
a185655 verified
# 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