Add ZeroGPU startup probe

app.py

@@ -11,10 +11,31 @@ from typing import Any
 
 import gradio as gr
 
+try:
+    import spaces
+except ImportError:
+
+    class _SpacesFallback:
+        @staticmethod
+        def GPU(  # pylint: disable=invalid-name
+            *_args: object, **_kwargs: object
+        ) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+            def decorator(func: Callable[..., Any]) -> Callable[..., Any]:
+                return func
+
+            return decorator
+
+    spaces = _SpacesFallback()
+
 APP_TITLE = "HearthNet"
 APP_SUBTITLE = "Phase 1 browser-mesh coordination, resilient AI assistance, and traceable local-first workflows."
 
 
+@spaces.GPU(duration=1)
+def zero_gpu_startup_probe() -> str:
+    return "HearthNet ZeroGPU probe ready"
+
+
 @dataclass
 class CoreAdapter:
     name: str

pyproject.toml

@@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "gradio>=6.16.0,<7.0",
+    "spaces>=0.30.0",
 ]
 
 [tool.ruff]
@@ -48,6 +49,9 @@ ignore = [
 "hearthnet/types.py" = [
     "A005",
 ]
+"app.py" = [
+    "N802",
+]
 
 [tool.ruff.format]
 quote-style = "double"

requirements.txt

@@ -1 +1,2 @@
 gradio>=6.16.0,<7.0
+spaces>=0.30.0