still initial commit

app.py

@@ -22,6 +22,25 @@ status_color = "🟢" if voxel_backend is not None else "🔴"
 status_text  = "Connected" if voxel_backend is not None else "Offline"
 
 
+# ── WebRTC Configuration Fallback ───────────────────────────────────────────
+def get_safe_rtc_configuration():
+    """
+    Prevents startup crashes if Cloudflare or HF tokens are missing from the environment.
+    Falls back gracefully to standard public Google STUN routing if name resolution drops out.
+    """
+    has_hf = bool(os.environ.get("HF_TOKEN"))
+    has_cf = bool(os.environ.get("CLOUDFLARE_TURN_KEY_ID") and os.environ.get("CLOUDFLARE_TURN_KEY_API_TOKEN"))
+    
+    if has_hf or has_cf:
+        try:
+            return get_cloudflare_turn_credentials()
+        except Exception as e:
+            print(f"⚠️ Failed to fetch Cloudflare TURN credentials: {e}")
+            
+    print("ℹ️ Missing credentials for Cloudflare TURN. Falling back to public Google STUN server.")
+    return {"iceServers": [{"urls": ["stun:stun.l.google.com:19302"]}]}
+
+
 # ── Helpers ─────────────────────────────────────────────────────────────────
 def _offline_frame(frame: np.ndarray, message: str) -> np.ndarray:
     """Generates a styled placeholder frame when backend is offline."""
@@ -38,7 +57,6 @@ def _run_voxel_backend(frame: np.ndarray) -> np.ndarray:
     if not success:
         return frame
     try:
-        # Prompt and strength arguments have been fully stripped here
         processed_bytes = voxel_backend.remote(encoded.tobytes())
         result = cv2.imdecode(np.frombuffer(processed_bytes, dtype=np.uint8), cv2.IMREAD_COLOR)
         return result if result is not None else frame
@@ -50,10 +68,10 @@ def _run_voxel_backend(frame: np.ndarray) -> np.ndarray:
 
 
 # ── Unified Core Stream Handler ─────────────────────────────────────────────
-def process_video_stream(frame: np.ndarray, mode: str) -> np.ndarray:
+def process_video_stream(frame: np.ndarray, mode: str, _status=None) -> np.ndarray:
     """
     Unified real-time handler mapping directly to FastRTC's stream pipeline.
-    Accepts incoming frame along with the UI's selected operating mode.
+    Accepts incoming frame, mode dropdown, and a placeholder for the Markdown element.
     """
     if frame is None:
         return None
@@ -89,7 +107,7 @@ stream = Stream(
     handler=process_video_stream,
     modality="video",
     mode="send-receive",
-    rtc_configuration=get_cloudflare_turn_credentials(),
+    rtc_configuration=get_safe_rtc_configuration(),
     additional_inputs=[
         gr.Dropdown(
             choices=["Minecraft Filter", "Streaming Demo"],