Add ZeroGPU Gradio Space app

README.md

@@ -1,15 +1,48 @@
 ---
 title: Cosmos Sentinel
-emoji: 🌖
+emoji: 🚦
 colorFrom: blue
-colorTo: gray
+colorTo: indigo
 sdk: gradio
 sdk_version: 6.8.0
 python_version: '3.12'
 app_file: app.py
 pinned: false
 license: apache-2.0
-short_description: Submission for Nvidia Cosmos Cookoff.
+short_description: BADAS + Cosmos Reason 2 ZeroGPU demo.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Cosmos Sentinel
+
+Cosmos Sentinel is a traffic-safety demo built around:
+
+- **BADAS** for predictive collision gating
+- **Cosmos Reason 2** for causal incident narration and severity labeling
+- **Cosmos Predict 2.5** for optional future continuation rollouts in the full project repo
+
+This Hugging Face Space is implemented as a **Gradio app** so it is compatible with **ZeroGPU**.
+
+## What this Space includes
+
+- a polished overview of the project
+- sample run artifacts from Cosmos Sentinel
+- a lightweight ZeroGPU-compatible diagnostic action
+- supplementary links to the main papers, repos, and official docs
+
+## Full project repository
+
+- GitHub: https://github.com/Ryukijano/Nvidia-Cosmos-Cookoff
+
+## Supplementary materials
+
+- NVIDIA Cosmos overview: https://docs.nvidia.com/cosmos/latest/introduction.html
+- Cosmos Reason 2 docs: https://docs.nvidia.com/cosmos/latest/reason2/index.html
+- Cosmos Reason 2 repo: https://github.com/nvidia-cosmos/cosmos-reason2
+- Cosmos Predict 2.5 repo: https://github.com/nvidia-cosmos/cosmos-predict2.5
+- Cosmos Cookbook: https://nvidia-cosmos.github.io/cosmos-cookbook/index.html
+- BADAS paper: https://arxiv.org/abs/2510.14876
+- Nexar dataset paper: https://openaccess.thecvf.com/content/CVPR2025W/WAD/papers/Moura_Nexar_Dashcam_Collision_Prediction_Dataset_and_Challenge_CVPRW_2025_paper.pdf
+
+## Note
+
+The full local Streamlit dashboard and heavier pipeline workflow remain in the GitHub repo. This Space is the lightweight Gradio presentation layer tailored for Hugging Face Spaces and ZeroGPU deployment.

app.py

@@ -0,0 +1,92 @@
+from pathlib import Path
+import time
+
+import gradio as gr
+
+try:
+    import spaces
+except ImportError:
+    class _SpacesFallback:
+        @staticmethod
+        def GPU(fn=None, **_kwargs):
+            if fn is None:
+                def decorator(inner):
+                    return inner
+                return decorator
+            return fn
+    spaces = _SpacesFallback()
+
+ROOT = Path(__file__).resolve().parent
+GITHUB_REPO_URL = "https://github.com/Ryukijano/Nvidia-Cosmos-Cookoff"
+GITHUB_ASSET_LINKS = {
+    "Sample input video": f"{GITHUB_REPO_URL}/blob/main/1_first.mp4",
+    "BADAS-focused clip": f"{GITHUB_REPO_URL}/blob/main/extracted_clip.mp4",
+    "BADAS gradient saliency": f"{GITHUB_REPO_URL}/blob/main/badas_gradient_saliency.png",
+    "BADAS frame strip": f"{GITHUB_REPO_URL}/blob/main/badas_frame_strip.png",
+    "Reason frame strip": f"{GITHUB_REPO_URL}/blob/main/reason_frame_strip.png",
+    "Reason bounding-box visualization": f"{GITHUB_REPO_URL}/blob/main/bboxes_visualization.png",
+    "Reason risk visualization": f"{GITHUB_REPO_URL}/blob/main/risk_visualization.png",
+}
+
+SUPPLEMENTARY_MARKDOWN = """
+## Supplementary Materials
+
+- [Project repository](https://github.com/Ryukijano/Nvidia-Cosmos-Cookoff)
+- [NVIDIA Cosmos overview](https://docs.nvidia.com/cosmos/latest/introduction.html)
+- [Cosmos Reason 2 docs](https://docs.nvidia.com/cosmos/latest/reason2/index.html)
+- [Cosmos Reason 2 repo](https://github.com/nvidia-cosmos/cosmos-reason2)
+- [Cosmos Predict 2.5 repo](https://github.com/nvidia-cosmos/cosmos-predict2.5)
+- [Cosmos Cookbook](https://nvidia-cosmos.github.io/cosmos-cookbook/index.html)
+- [BADAS paper](https://arxiv.org/abs/2510.14876)
+- [Nexar dataset and challenge paper](https://openaccess.thecvf.com/content/CVPR2025W/WAD/papers/Moura_Nexar_Dashcam_Collision_Prediction_Dataset_and_Challenge_CVPRW_2025_paper.pdf)
+"""
+@spaces.GPU
+def zero_gpu_diagnostic():
+    started_at = time.strftime("%Y-%m-%d %H:%M:%S UTC", time.gmtime())
+    return (
+        "ZeroGPU diagnostic executed successfully.\n\n"
+        f"Timestamp: {started_at}\n"
+        "This Space uses the Gradio SDK and a ZeroGPU-compatible decorated function."
+    )
+
+
+with gr.Blocks(theme=gr.themes.Soft(), title="Cosmos Sentinel") as demo:
+    gr.Markdown("# 🚦 Cosmos Sentinel")
+    gr.Markdown(
+        "A BADAS + Cosmos Reason 2 traffic-safety demo adapted for Hugging Face Spaces. "
+        "The full local project includes a Streamlit dashboard; this Space is the lightweight Gradio presentation version for ZeroGPU compatibility."
+    )
+
+    with gr.Tabs():
+        with gr.Tab("Overview"):
+            gr.Markdown(
+                """
+## Pipeline
+
+1. **BADAS** scans the traffic video for developing collision risk.
+2. **Clip extraction** isolates the highest-risk temporal window.
+3. **Cosmos Reason 2** analyzes the scene and explains the likely incident and severity.
+4. **Cosmos Predict 2.5** can optionally simulate observed or prevented continuations in the full project repo.
+
+## Why this Space is Gradio-based
+
+Hugging Face **ZeroGPU** is officially supported for **Gradio Spaces**, not Streamlit Spaces. This app is therefore the Space-native presentation layer for the project.
+                """
+            )
+
+        with gr.Tab("Sample Run Artifacts"):
+            artifact_lines = ["Example artifacts from a local sample run of Cosmos Sentinel are hosted in the GitHub repository:"]
+            artifact_lines.extend([f"- [{label}]({url})" for label, url in GITHUB_ASSET_LINKS.items()])
+            gr.Markdown("\n".join(artifact_lines))
+
+        with gr.Tab("ZeroGPU Check"):
+            gr.Markdown("Click the button below to run a lightweight function through the ZeroGPU-compatible execution path.")
+            check_button = gr.Button("Run ZeroGPU diagnostic", variant="primary")
+            check_output = gr.Textbox(label="Diagnostic output", lines=6)
+            check_button.click(fn=zero_gpu_diagnostic, inputs=None, outputs=check_output)
+
+        with gr.Tab("Supplementary Materials"):
+            gr.Markdown(SUPPLEMENTARY_MARKDOWN)
+
+
+demo.launch()

requirements.txt

@@ -0,0 +1,2 @@
+gradio>=5.0.0
+spaces