fix: disable gradio experimental ssr

app.py

@@ -7409,6 +7409,10 @@ if __name__ == "__main__":
     else:
         print("ℹ️  AOT compilation skipped (HF Space / MPS / testing mode)\n")
 
-    demo.launch(share=False, mcp_server=True)
+    demo.launch(
+        share=False,
+        mcp_server=True,
+        ssr_mode=False,
+    )
     # Note: Automatic file cleanup via delete_cache not available in Gradio 5.49.1
     # Files will be cleaned up when the server is restarted

tests-unit/test_gradio_launch_config.py

@@ -0,0 +1,26 @@
+import ast
+from pathlib import Path
+
+
+APP_PATH = Path(__file__).parents[1] / "app.py"
+
+
+def test_gradio_launch_disables_experimental_ssr():
+    tree = ast.parse(APP_PATH.read_text(encoding="utf-8"))
+    launches = [
+        node
+        for node in ast.walk(tree)
+        if isinstance(node, ast.Call)
+        and isinstance(node.func, ast.Attribute)
+        and node.func.attr == "launch"
+    ]
+
+    assert launches, "app.py must contain a Gradio launch call"
+    ssr_values = {
+        keyword.value.value
+        for launch in launches
+        for keyword in launch.keywords
+        if keyword.arg == "ssr_mode"
+        and isinstance(keyword.value, ast.Constant)
+    }
+    assert ssr_values == {False}