Add jupyter-dark-detect for automatic matplotlib dark mode theming.

brycelelbach · brycelelbach · commit b21aedf3554c · 2026-03-11T17:14:06.000-04:00
Detects whether the browser is in dark mode via jupyter-dark-detect and
sets the matplotlib style accordingly. Replaces hardcoded color constants
in nvmath-python visualization cells with a COLOR1-COLOR6 palette that
adapts to light/dark mode.
diff --git a/brev/entrypoint.bash b/brev/entrypoint.bash
@@ -68,7 +68,6 @@ if [ "$(id -u)" = "0" ]; then
     if [ ! -e "${HOME}/.ipython/profile_default/startup/00-add-cwd-to-path.py" ]; then
         gosu "${TARGET_USER}" ln -sf /accelerated-computing-hub/brev/ipython-startup-add-cwd-to-path.py "${HOME}/.ipython/profile_default/startup/00-add-cwd-to-path.py"
     fi
-
     # Setup Git safe directory (run as target user)
     gosu "${TARGET_USER}" git config --global --add safe.directory "/accelerated-computing-hub" 2>/dev/null || true
 
diff --git a/tutorials/accelerated-python/brev/requirements.txt b/tutorials/accelerated-python/brev/requirements.txt
@@ -6,6 +6,9 @@ scipy == 1.17.1
 matplotlib == 3.10.8
 opencv-python-headless == 4.13.0.92
 
+# Dark mode detection
+jupyter-dark-detect == 0.1.0
+
 # Jupyter
 jupyter == 1.1.1
 jupyter-server-proxy == 4.4.0
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/02__numpy_linear_algebra__svd_reconstruction.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/02__numpy_linear_algebra__svd_reconstruction.ipynb
@@ -26,10 +26,12 @@
    "outputs": [],
    "source": [
     "import numpy as np\n",
-    "import matplotlib.pyplot as plt\n",
     "import cv2\n",
     "import urllib.request\n",
-    "import os"
+    "import os\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/03__numpy_to_cupy__ndarray_basics.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/03__numpy_to_cupy__ndarray_basics.ipynb
@@ -41,7 +41,9 @@
     "import numpy as np\n",
     "import cupy as cp\n",
     "import cupyx as cpx\n",
+    "from jupyter_dark_detect import is_dark\n",
     "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')\n",
     "\n",
     "# Helper to display benchmark results concisely.\n",
     "def print_benchmark(result):\n",
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/04__numpy_to_cupy__svd_reconstruction.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/04__numpy_to_cupy__svd_reconstruction.ipynb
@@ -30,9 +30,11 @@
    "outputs": [],
    "source": [
     "import numpy as xp\n",
-    "import matplotlib.pyplot as plt\n",
     "import cv2\n",
-    "import urllib.request"
+    "import urllib.request\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/solutions/02__numpy_linear_algebra__svd_reconstruction__SOLUTION.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/solutions/02__numpy_linear_algebra__svd_reconstruction__SOLUTION.ipynb
@@ -26,10 +26,12 @@
    "outputs": [],
    "source": [
     "import numpy as np\n",
-    "import matplotlib.pyplot as plt\n",
     "import cv2\n",
     "import urllib.request\n",
-    "import os"
+    "import os\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/solutions/03__numpy_to_cupy__ndarray_basics__SOLUTION.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/solutions/03__numpy_to_cupy__ndarray_basics__SOLUTION.ipynb
@@ -49,7 +49,9 @@
     "import numpy as np\n",
     "import cupy as cp\n",
     "import cupyx as cpx\n",
+    "from jupyter_dark_detect import is_dark\n",
     "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')\n",
     "\n",
     "# Helper to display benchmark results concisely.\n",
     "def print_benchmark(result):\n",
@@ -888,8 +890,11 @@
     "# Plot 2: Speedup ratio\n",
     "speedups = [cpu / gpu for cpu, gpu in zip(cpu_times, gpu_times)]\n",
     "colors = ['green' if s > 1 else 'red' for s in speedups]\n",
-    "ax2.bar(range(len(sizes)), speedups, color=colors, alpha=0.7, edgecolor='black')\n",
-    "ax2.axhline(y=1.0, color='black', linestyle='--', linewidth=2, label='Break-even')\n",
+    "_dark = is_dark()\n",
+    "COLOR5 = \"#FFFFFF\" if _dark else \"#000000\"\n",
+    "\n",
+    "ax2.bar(range(len(sizes)), speedups, color=colors, alpha=0.7, edgecolor=COLOR5)\n",
+    "ax2.axhline(y=1.0, color=COLOR5, linestyle='--', linewidth=2, label='Break-even')\n",
     "ax2.set_xticks(range(len(sizes)))\n",
     "ax2.set_xticklabels([f'{s:,}' for s in sizes], rotation=45, ha='right', fontsize=9)\n",
     "ax2.set_xlabel('Array Size (elements)', fontsize=12)\n",
diff --git a/tutorials/accelerated-python/notebooks/fundamentals/solutions/04__numpy_to_cupy__svd_reconstruction__SOLUTION.ipynb b/tutorials/accelerated-python/notebooks/fundamentals/solutions/04__numpy_to_cupy__svd_reconstruction__SOLUTION.ipynb
@@ -30,9 +30,11 @@
    "outputs": [],
    "source": [
     "import cupy as xp\n",
-    "import matplotlib.pyplot as plt\n",
     "import cv2\n",
-    "import urllib.request"
+    "import urllib.request\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/kernels/41__kernel_authoring__book_histogram.ipynb b/tutorials/accelerated-python/notebooks/kernels/41__kernel_authoring__book_histogram.ipynb
@@ -52,8 +52,10 @@
     "\n",
     "import numpy as np\n",
     "import nsightful\n",
+    "import urllib.request\n",
+    "from jupyter_dark_detect import is_dark\n",
     "import matplotlib.pyplot as plt\n",
-    "import urllib.request"
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/kernels/42__kernel_authoring__gaussian_blur.ipynb b/tutorials/accelerated-python/notebooks/kernels/42__kernel_authoring__gaussian_blur.ipynb
@@ -30,13 +30,14 @@
     "  open(\"/accelerated-computing-hub-installed\", \"a\").close()\n",
     "  print(\"All packages installed.\")\n",
     "\n",
-    "import matplotlib as mpl\n",
-    "import matplotlib.pyplot as plt\n",
     "from numba import cuda\n",
     "import numpy as np\n",
     "import math\n",
     "import urllib.request\n",
     "import cv2\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')\n",
     "\n",
     "plt.rcParams[\"figure.figsize\"] = (30, 4)"
    ]
diff --git a/tutorials/accelerated-python/notebooks/kernels/43__kernel_authoring__black_and_white.ipynb b/tutorials/accelerated-python/notebooks/kernels/43__kernel_authoring__black_and_white.ipynb
@@ -32,13 +32,14 @@
     "  open(\"/accelerated-computing-hub-installed\", \"a\").close()\n",
     "  print(\"All packages installed.\")\n",
     "\n",
-    "import matplotlib as mpl\n",
-    "import matplotlib.pyplot as plt\n",
     "from numba import cuda\n",
     "import numpy as np\n",
     "import math\n",
     "import urllib.request\n",
     "import cv2\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')\n",
     "\n",
     "plt.rcParams[\"figure.figsize\"] = (30, 4)"
    ]
diff --git a/tutorials/accelerated-python/notebooks/kernels/solutions/41__kernel_authoring__book_histogram__SOLUTION.ipynb b/tutorials/accelerated-python/notebooks/kernels/solutions/41__kernel_authoring__book_histogram__SOLUTION.ipynb
@@ -59,8 +59,10 @@
     "\n",
     "import numpy as np\n",
     "import nsightful\n",
+    "import urllib.request\n",
+    "from jupyter_dark_detect import is_dark\n",
     "import matplotlib.pyplot as plt\n",
-    "import urllib.request"
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/accelerated-python/notebooks/kernels/solutions/43__kernel_authoring__black_and_white__SOLUTION.ipynb b/tutorials/accelerated-python/notebooks/kernels/solutions/43__kernel_authoring__black_and_white__SOLUTION.ipynb
@@ -34,13 +34,14 @@
     "  open(\"/accelerated-computing-hub-installed\", \"a\").close()\n",
     "  print(\"All packages installed.\")\n",
     "\n",
-    "import matplotlib as mpl\n",
-    "import matplotlib.pyplot as plt\n",
     "from numba import cuda\n",
     "import numpy as np\n",
     "import math\n",
     "import urllib.request\n",
     "import cv2\n",
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')\n",
     "\n",
     "plt.rcParams[\"figure.figsize\"] = (30, 4)"
    ]
diff --git a/tutorials/accelerated-python/notebooks/libraries/23__cuda_cccl__customizing_algorithms.ipynb b/tutorials/accelerated-python/notebooks/libraries/23__cuda_cccl__customizing_algorithms.ipynb
@@ -155,7 +155,9 @@
     "import cupy  as cp\n",
     "import cuda.compute as comp\n",
     "import cupyx as cpx\n",
-    "import matplotlib.pyplot as plt"
+    "from jupyter_dark_detect import is_dark\n",
+    "import matplotlib.pyplot as plt\n",
+    "plt.style.use('dark_background' if is_dark() else 'default')"
    ]
   },
   {
diff --git a/tutorials/cuda-cpp/brev/requirements.txt b/tutorials/cuda-cpp/brev/requirements.txt
@@ -1,6 +1,9 @@
 # Visualization
 matplotlib
 
+# Dark mode detection
+jupyter-dark-detect == 0.1.0
+
 # Jupyter
 jupyter
 jupyter-server-proxy
diff --git a/tutorials/cuda-cpp/notebooks/01.04-Vocabulary-Types/Sources/ach.py b/tutorials/cuda-cpp/notebooks/01.04-Vocabulary-Types/Sources/ach.py
@@ -1,10 +1,12 @@
 import subprocess
-import matplotlib.pyplot as plt
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename):
diff --git a/tutorials/cuda-cpp/notebooks/02.02-Asynchrony/Sources/ach.py b/tutorials/cuda-cpp/notebooks/02.02-Asynchrony/Sources/ach.py
@@ -1,10 +1,12 @@
 import subprocess
-import matplotlib.pyplot as plt
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename):
diff --git a/tutorials/cuda-cpp/notebooks/02.03-Streams/Sources/ach.py b/tutorials/cuda-cpp/notebooks/02.03-Streams/Sources/ach.py
@@ -1,10 +1,12 @@
 import subprocess
-import matplotlib.pyplot as plt
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename):
diff --git a/tutorials/cuda-cpp/notebooks/02.04-Pinned-Memory/Sources/ach.py b/tutorials/cuda-cpp/notebooks/02.04-Pinned-Memory/Sources/ach.py
@@ -1,10 +1,12 @@
 import subprocess
-import matplotlib.pyplot as plt
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename):
diff --git a/tutorials/cuda-cpp/notebooks/03.03-Atomics/Sources/ach.py b/tutorials/cuda-cpp/notebooks/03.03-Atomics/Sources/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-cpp/notebooks/03.04-Synchronization/Solutions/ach.py b/tutorials/cuda-cpp/notebooks/03.04-Synchronization/Solutions/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-cpp/notebooks/03.04-Synchronization/Sources/ach.py b/tutorials/cuda-cpp/notebooks/03.04-Synchronization/Sources/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-cpp/notebooks/03.05-Shared-Memory/Solutions/ach.py b/tutorials/cuda-cpp/notebooks/03.05-Shared-Memory/Solutions/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-cpp/notebooks/03.05-Shared-Memory/Sources/ach.py b/tutorials/cuda-cpp/notebooks/03.05-Shared-Memory/Sources/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-cpp/notebooks/03.06-Cooperative-Algorithms/Sources/ach.py b/tutorials/cuda-cpp/notebooks/03.06-Cooperative-Algorithms/Sources/ach.py
@@ -1,11 +1,13 @@
 import subprocess
-import matplotlib.pyplot as plt
-from matplotlib.ticker import StrMethodFormatter
-import matplotlib.animation as animation
 from IPython.display import HTML
 import numpy as np
 import glob
 import os
+from jupyter_dark_detect import is_dark
+import matplotlib.pyplot as plt
+from matplotlib.ticker import StrMethodFormatter
+import matplotlib.animation as animation
+plt.style.use('dark_background' if is_dark() else 'default')
 
 
 def run(filename, only_show=False):
diff --git a/tutorials/cuda-tile/brev/requirements.txt b/tutorials/cuda-tile/brev/requirements.txt
@@ -6,6 +6,9 @@ scipy
 matplotlib
 opencv-python-headless
 
+# Dark mode detection
+jupyter-dark-detect == 0.1.0
+
 # Jupyter
 jupyter
 jupyter-server-proxy
diff --git a/tutorials/nvmath-python/brev/requirements.txt b/tutorials/nvmath-python/brev/requirements.txt
@@ -18,6 +18,9 @@ nvmath-python[cu12,dx,cpu,cu12-distributed]
 # Visualization
 matplotlib
 
+# Dark mode detection
+jupyter-dark-detect == 0.1.0
+
 # Jupyter
 jupyter-server-proxy
 jupyterlab
diff --git a/tutorials/nvmath-python/notebooks/04_callbacks.ipynb b/tutorials/nvmath-python/notebooks/04_callbacks.ipynb
diff --git a/tutorials/nvmath-python/notebooks/04_callbacks_SOLUTION.ipynb b/tutorials/nvmath-python/notebooks/04_callbacks_SOLUTION.ipynb
diff --git a/tutorials/nvmath-python/notebooks/05_device_api.ipynb b/tutorials/nvmath-python/notebooks/05_device_api.ipynb
diff --git a/tutorials/nvmath-python/notebooks/05_device_api_SOLUTION.ipynb b/tutorials/nvmath-python/notebooks/05_device_api_SOLUTION.ipynb
diff --git a/tutorials/stdpar/brev/requirements.txt b/tutorials/stdpar/brev/requirements.txt
diff --git a/tutorials/stdpar/notebooks/cpp/lab2_heat/vis.py b/tutorials/stdpar/notebooks/cpp/lab2_heat/vis.py
diff --git a/tutorials/stdpar/notebooks/fortran/lab3_heat/vis.py b/tutorials/stdpar/notebooks/fortran/lab3_heat/vis.py

Original file line number	Diff line number	Diff line change
`@@ -30,9 +30,11 @@`
`30`	`30`	`"outputs": [],`
`31`	`31`	`"source": [`
`32`	`32`	`"import numpy as xp\n",`
`33`		`- "import matplotlib.pyplot as plt\n",`
`34`	`33`	`"import cv2\n",`
`35`		`- "import urllib.request"`
	`34`	`+ "import urllib.request\n",`
	`35`	`+ "from jupyter_dark_detect import is_dark\n",`
	`36`	`+ "import matplotlib.pyplot as plt\n",`
	`37`	`+ "plt.style.use('dark_background' if is_dark() else 'default')"`
`36`	`38`	`]`
`37`	`39`	`},`
`38`	`40`	`{`
Original file line number	Diff line number	Diff line change
`@@ -52,8 +52,10 @@`
`52`	`52`	`"\n",`
`53`	`53`	`"import numpy as np\n",`
`54`	`54`	`"import nsightful\n",`
	`55`	`+ "import urllib.request\n",`
	`56`	`+ "from jupyter_dark_detect import is_dark\n",`
`55`	`57`	`"import matplotlib.pyplot as plt\n",`
`56`		`- "import urllib.request"`
	`58`	`+ "plt.style.use('dark_background' if is_dark() else 'default')"`
`57`	`59`	`]`
`58`	`60`	`},`
`59`	`61`	`{`