fix: auto-detect Jupyter kernel to avoid blank trame renders

CONTRIBUTORS.md

@@ -7,6 +7,7 @@
 ## Individual Contributors
 
 * [Abhishek Chitwar](https://github.com/abhishekchitwar)
+* [Dipin](https://github.com/dipinknair)
 * [German](https://github.com/germa89)
 * [Jorge Martínez](https://github.com/jorgepiloto)
 * [Kathy Pippert](https://github.com/PipKat)

doc/changelog.d/548.fixed.md

@@ -0,0 +1 @@
+Fix: auto-detect Jupyter kernel to avoid blank trame renders

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "ansys-tools-visualization-interface"
-version = "0.8.dev0"
+version = "0.13.dev0"
 description = "A Python visualization interface for PyAnsys libraries"
 readme = "README.rst"
 requires-python = ">=3.10,<4"

src/ansys/tools/visualization_interface/backends/pyvista/pyvista_interface.py

@@ -465,6 +465,19 @@ def show(
         # Override Jupyter backend if building docs
         if viz_interface.USE_HTML_BACKEND:
             jupyter_backend = "html"
+        elif jupyter_backend is None:
+            # Auto-detect a Jupyter kernel and fall back to a safe html backend.
+            # Without this, PyVista defaults to "trame" (after installing
+            # pyvista[jupyter]), which spawns a local server and renders blank
+            # in VS Code / Spyder embedded notebooks.
+            try:
+                from IPython import get_ipython
+
+                _ip = get_ipython()
+                if _ip is not None and "IPKernelApp" in _ip.config:
+                    jupyter_backend = "html"
+            except Exception:
+                pass
 
         # Enabling anti-aliasing by default on scene
         self.scene.enable_anti_aliasing("ssaa")