Replace pyprojroot boilerplate with setup_notebook()

.gitignore

@@ -1,5 +1,7 @@
 output/
 dataset/
+test_report.md
+test_results/
 root.log
 report.log
 *.sqlite*

README.rst

@@ -85,3 +85,15 @@ joining the **PyAutoFit** `Slack channel <https://pyautofit.slack.com/>`_, where
 
 Slack is invitation-only, so if you'd like to join send an `email <https://github.com/Jammy2211>`_ requesting an
 invite.
+
+Build Configuration
+-------------------
+
+The ``config/`` directory contains two files used by the automated build and test system
+(CI, smoke tests, and pre-release checks). These are not relevant to normal workspace usage.
+
+- ``config/build/no_run.yaml`` — scripts to skip during automated runs. Each entry is a filename stem
+  or path pattern with an inline comment explaining why it is skipped.
+- ``config/build/env_vars.yaml`` — environment variables applied to each script during automated runs.
+  Defines default values (e.g. test mode, small datasets) and per-script overrides for scripts
+  that need different settings.

config/build/env_vars.yaml

@@ -0,0 +1,21 @@
+# Per-script environment variable configuration for automated runs
+# (smoke tests, pre-release checks, CI).
+#
+# "defaults" are applied to every script on top of the inherited environment.
+# "overrides" selectively unset or replace vars for matching path patterns.
+#
+# Pattern convention (same as no_run.yaml):
+#   - Patterns containing '/' do a substring match against the file path
+#   - Patterns without '/' match the file stem exactly
+
+defaults:
+  PYAUTOFIT_TEST_MODE: "2"              # 0=normal, 1=reduced iterations, 2=skip sampler (fastest)
+  PYAUTO_WORKSPACE_SMALL_DATASETS: "1"  # Cap grids/masks to 15x15, reduce MGE gaussians
+  PYAUTO_DISABLE_CRITICAL_CAUSTICS: "1" # Skip critical curve/caustic overlays in plots
+  PYAUTO_DISABLE_JAX: "1"              # Force use_jax=False, avoid JIT compilation overhead
+  PYAUTO_FAST_PLOTS: "1"               # Skip tight_layout() in subplots
+  JAX_ENABLE_X64: "True"               # Enable 64-bit precision in JAX
+  NUMBA_CACHE_DIR: "/tmp/numba_cache"   # Writable cache dir for numba
+  MPLCONFIGDIR: "/tmp/matplotlib"       # Writable config dir for matplotlib
+
+overrides: []

config/build/no_run.yaml

@@ -0,0 +1,17 @@
+# Scripts to skip during automated runs (smoke tests, pre-release checks, CI).
+# Each entry is matched against script paths:
+#   - Entries with '/' do a substring match against the file path
+#   - Entries without '/' match the file stem exactly
+# Add an inline # comment to document the reason for skipping.
+
+- GetDist # Cant get it to install, even in optional requirements.
+- Zeus # Test Model Iniitalization no good.
+- ZeusPlotter # Test Model Iniitalization no good.
+- UltraNestPlotter # Test Model Iniitalization no good.
+- DynestyPlotter # Test Model Iniitalization no good.
+- start_point # bug https://github.com/rhayes777/PyAutoFit/issues/1017
+- tutorial_8_astronomy_example # Requires dataset/howtofit/chapter_1/astro/simple/data.npy (not auto-generated)
+- searches/mle/PySwarmsGlobal # PySwarms does not support JAX.
+- searches/mle/PySwarmsLocal # PySwarms does not support JAX.
+- searches/nest/UltraNest # UltraNest does not support JAX.
+- plot/PySwarmsPlotter # PySwarms does not support JAX.