Spatial9/GravityLLM
0
1---2title: GravityLLM Studio3emoji: 🌌4colorFrom: blue5colorTo: indigo6sdk: gradio7sdk_version: 6.8.08python_version: "3.10"9app_file: app.py10fullWidth: true11header: default12suggested_hardware: cpu-basic13short_description: Spatial9 immersive scene generation with branded GravityLLM UI, schema validation, and spatial preview.14tags:15- gravityllm16- spatial-audio17- immersive-audio18- spatial919- iamf20- gradio21- json22- demo23- music-tech24---25 2627 28# GravityLLM Studio29 30A branded Hugging Face Space for **constraint-conditioned immersive scene generation**.31 32This Space accepts a **music-constraint payload** and returns a **Spatial9Scene JSON** scene. It includes:33 34- a polished GravityLLM studio UI35- your Spatial9 logo in the hero section36- remote inference through Hugging Face `InferenceClient`37- optional JSON-schema grammar constraints38- built-in validation against `schemas/scene.schema.json`39- a live top-down spatial preview40- a deterministic fallback rules engine so the demo still works before the trained model is online41 42## How to connect your model43 44Set the following Space secrets or variables:45 46- `GRAVITYLLM_MODEL_ID` → your model repo id, for example `your-org/GravityLLM-AutoPosition`47- `HF_TOKEN` → only required if the model is gated or private48- `GRAVITYLLM_BACKEND` → optional default: `hybrid`, `remote-model`, or `rules-engine demo`49 50## Files51 52- `app.py` — the Gradio app53- `schemas/scene.schema.json` — the contract used for validation and optional grammar guidance54- `examples/` — ready-to-run sample payloads55- `assets/` — logo and banner assets56- `utils/scene_tools.py` — validation, heuristics, JSON extraction, plotting57 58## Recommended workflow59 601. Upload your GravityLLM **Model repo**612. Train and push the final weights623. Upload this **Space repo**634. Set `GRAVITYLLM_MODEL_ID`645. Launch the Space65 66## Notes67 68This Space is designed to be usable in two states:69- **before model launch** → rules-engine fallback70- **after model launch** → remote GravityLLM inference71