Upload folder using huggingface_hub

IMPLEMENTATION.md

@@ -239,8 +239,27 @@ These are communication channels, not reward. Keeping them out of the training s
 cd landscapeforge
 uv sync                                # installs deps
 uv run python tests/test_episode.py    # 3 scripted episodes
+
+# Local dev server with Gradio at /web:
+uv run uvicorn landscapeforge.server.app:app --host 127.0.0.1 --port 8000
+# → http://localhost:8000/web  (Gradio demo)
+# → http://localhost:8000/schema  (OpenEnv schema)
 ```
 
+### Pushing to HF Spaces
+
+Use `--no-interface` — our custom Gradio mount at `/web` replaces OpenEnv's
+built-in UI (the built-in passes `theme=` to `gr.mount_gradio_app`, which
+Gradio 5.x dropped):
+
+```bash
+openenv push . --exclude .hfignore --no-interface
+```
+
+Without `--no-interface`, `openenv push` injects `ENV ENABLE_WEB_INTERFACE=true`
+into the Dockerfile → OpenEnv's `create_app` routes through
+`create_web_interface_app` → crashes on Gradio 5 incompatibility.
+
 Expected output: three `✓ PASSED` lines, final line `All tests passed.`
 
 In-process usage (no server needed):

server/app.py

@@ -56,11 +56,28 @@ app = create_app(
     max_concurrent_envs=4,
 )
 
-# Mount Gradio demo at /web
+# Mount Gradio demo at /web.
+# SSR mode is disabled because Gradio's Node sidecar tends to 502 under HF
+# Spaces' Docker proxy; client-side rendering is more reliable. root_path is
+# set so relative asset URLs resolve correctly when HF iframes /web.
 try:
     import gradio as gr
     _demo = _build_demo_ui()
-    app = gr.mount_gradio_app(app, _demo, path="/web")
+    app = gr.mount_gradio_app(
+        app, _demo,
+        path="/web",
+        root_path="/web",
+        ssr_mode=False,
+    )
+
+    # Redirect root and /web (no trailing slash) to /web/ so the HF Space
+    # iframe works whether base_path is set or not.
+    from fastapi.responses import RedirectResponse
+
+    @app.get("/")
+    def _root_redirect():
+        return RedirectResponse(url="/web/")
+
 except Exception as _e:  # pragma: no cover
     import logging
     logging.getLogger(__name__).warning(