diff --git a/.github/scripts/discover_models.py b/.github/scripts/discover_models.py
new file mode 100644
index 00000000..4ef54180
--- /dev/null
+++ b/.github/scripts/discover_models.py
@@ -0,0 +1,115 @@
+#!/usr/bin/env python
+"""Discover registered model runs and orchestrator configs for GitHub Actions matrix.
+
+This script outputs JSON for both models and orchestrator configurations that
+can be used in a GitHub Actions matrix strategy.
+
+This script only reads entry point names without loading the classes, so it
+doesn't require test dependencies to be installed.
+"""
+
+import importlib.metadata
+import json
+import sys
+
+
+def discover_model_names():
+    """Discover registered model run names from entry points.
+
+    Returns just the entry point names without loading the actual classes,
+    so this works even without test dependencies installed.
+    """
+    # Python 3.9 vs 3.10+ compatibility
+    try:
+        # Try Python 3.10+ API first
+        eps = importlib.metadata.entry_points(group="pycmor.fixtures.model_runs")
+    except TypeError:
+        # Fall back to Python 3.9 API
+        all_eps = importlib.metadata.entry_points()
+        eps = all_eps.get("pycmor.fixtures.model_runs", [])
+
+    # Just get the names, don't load the classes
+    model_names = [ep.name for ep in eps]
+
+    return model_names
+
+
+def get_orchestrator_configs():
+    """Get orchestrator configurations for the test matrix.
+
+    Returns the standard orchestrator configurations used in integration tests.
+    This is the single source of truth for orchestrator combinations.
+    """
+    return [
+        {
+            "id": "prefect-dask",
+            "pipeline_workflow_orchestrator": "prefect",
+            "enable_dask": "yes",
+        },
+        {
+            "id": "native-dask",
+            "pipeline_workflow_orchestrator": "native",
+            "enable_dask": "yes",
+        },
+        {
+            "id": "native-nodask",
+            "pipeline_workflow_orchestrator": "native",
+            "enable_dask": "no",
+        },
+    ]
+
+
+def main():
+    """Discover models and orchestrators, output as JSON for GitHub Actions matrix."""
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Discover models and orchestrators for CI matrix")
+    parser.add_argument(
+        "--output",
+        choices=["models", "orchestrators", "both"],
+        default="models",
+        help="What to output",
+    )
+    args = parser.parse_args()
+
+    try:
+        if args.output == "models":
+            model_names = discover_model_names()
+            model_names = sorted(model_names)
+            print(json.dumps(model_names))
+            print(
+                f"# Discovered {len(model_names)} models: {', '.join(model_names)}",
+                file=sys.stderr,
+            )
+        elif args.output == "orchestrators":
+            orchestrators = get_orchestrator_configs()
+            print(json.dumps(orchestrators))
+            orchestrator_ids = [o["id"] for o in orchestrators]
+            print(
+                f"# Orchestrators: {', '.join(orchestrator_ids)}",
+                file=sys.stderr,
+            )
+        elif args.output == "both":
+            result = {
+                "models": sorted(discover_model_names()),
+                "orchestrators": get_orchestrator_configs(),
+            }
+            print(json.dumps(result))
+            print(
+                f"# Discovered {len(result['models'])} models and {len(result['orchestrators'])} orchestrator configs",
+                file=sys.stderr,
+            )
+
+        return 0
+    except Exception as e:
+        print(f"# Error discovering CI matrix config: {e}", file=sys.stderr)
+        # Return empty array/object on error so workflow doesn't fail
+        if args.output == "both":
+            print('{"models": [], "orchestrators": []}')
+        else:
+            print("[]")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/.github/workflows/CI-test.yaml b/.github/workflows/CI-test.yaml
index 00c77c8d..f3ba0ad1 100644
--- a/.github/workflows/CI-test.yaml
+++ b/.github/workflows/CI-test.yaml
@@ -617,6 +617,7 @@ jobs:
         run: |
           docker run --rm \
             -e PYCMOR_USE_REAL_TEST_DATA=1 \
+            -e PYCMOR_FORCE_REEXTRACT=1 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_ENGINE=netcdf4 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_PARALLEL=no \
             -e PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS=300 \
@@ -663,6 +664,7 @@ jobs:
         run: |
           docker run --rm \
             -e PYCMOR_USE_REAL_TEST_DATA=1 \
+            -e PYCMOR_FORCE_REEXTRACT=1 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_ENGINE=netcdf4 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_PARALLEL=no \
             -e PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS=300 \
@@ -709,6 +711,7 @@ jobs:
         run: |
           docker run --rm \
             -e PYCMOR_USE_REAL_TEST_DATA=1 \
+            -e PYCMOR_FORCE_REEXTRACT=1 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_ENGINE=netcdf4 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_PARALLEL=no \
             -e PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS=300 \
@@ -755,6 +758,7 @@ jobs:
         run: |
           docker run --rm \
             -e PYCMOR_USE_REAL_TEST_DATA=1 \
+            -e PYCMOR_FORCE_REEXTRACT=1 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_ENGINE=netcdf4 \
             -e PYCMOR_XARRAY_OPEN_MFDATASET_PARALLEL=no \
             -e PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS=300 \
diff --git a/conftest.py b/conftest.py
index 61694040..6322268b 100644
--- a/conftest.py
+++ b/conftest.py
@@ -1,8 +1,47 @@
 import logging
+import os
+import tempfile
 
 import pytest
 
-from tests.utils.constants import TEST_ROOT  # noqa: F401
+
+def pytest_configure(config):
+    """Set up XDG_CONFIG_HOME before any modules are imported.
+
+    This runs very early in pytest's lifecycle, before test collection,
+    ensuring environment variables are set before any test modules import
+    code that reads them.
+    """
+    import yaml
+
+    # Create a temporary directory that will persist for the entire pytest session
+    tmp_dir = tempfile.mkdtemp(prefix="pycmor_test_config_")
+    config_dir = os.path.join(tmp_dir, "pycmor")
+    os.makedirs(config_dir, exist_ok=True)
+
+    # Set XDG_CONFIG_HOME before any modules are imported
+    os.environ["XDG_CONFIG_HOME"] = tmp_dir
+
+    # Create the config file with inherit section matching doctest examples
+    config_file = os.path.join(config_dir, "pycmor.yaml")
+    config_content = {
+        "inherit": {
+            "source_id": "FESOM2",
+            "experiment_id": "historical",
+            "variant_label": "r1i1p1f1",
+            "grid_label": "gn",
+            "institution_id": "AWI",
+            "output_directory": "/tmp/cmor_output",
+        }
+    }
+
+    with open(config_file, "w") as f:
+        yaml.dump(config_content, f)
+
+    print(f"\n[pytest_configure] XDG_CONFIG_HOME set to: {os.environ['XDG_CONFIG_HOME']}")
+    print(f"[pytest_configure] Config file created at: {config_file}")
+    logging.debug(f"[pytest_configure] XDG_CONFIG_HOME set to: {os.environ['XDG_CONFIG_HOME']}")
+    logging.debug(f"[pytest_configure] Config file created at: {config_file}")
 
 
 @pytest.fixture(scope="function", autouse=True)
@@ -29,12 +68,66 @@ def suppress_third_party_logs():
         logging.getLogger(logger_name).setLevel(logging.WARNING)
 
 
+def _get_model_fixture_plugins():
+    """Dynamically discover model fixture plugins from entry points.
+
+    For each registered model (via pycmor.fixtures.model_runs entry point),
+    generate the fixture module paths for config, datadir, and datasets.
+
+    Returns
+    -------
+    list
+        List of fixture module paths
+    """
+    try:
+        import importlib.metadata as importlib_metadata
+    except ImportError:
+        import importlib_metadata
+
+    plugins = []
+
+    # Discover model entry points
+    entry_points = importlib_metadata.entry_points()
+    if hasattr(entry_points, "select"):
+        pycmor_models = entry_points.select(group="pycmor.fixtures.model_runs")
+    else:
+        pycmor_models = entry_points.get("pycmor.fixtures.model_runs", [])
+
+    for ep in pycmor_models:
+        # Extract module path from entry point value
+        # e.g., "tests.contrib.models.fesom_2p6.fixtures.model:Fesom2p6ModelRun"
+        # -> "tests.contrib.models.fesom_2p6.fixtures"
+        module_path = ep.value.split(":")[0]  # Get module path before ":"
+        base_path = ".".join(module_path.split(".")[:-1])  # Remove ".model"
+
+        # Try to add fixture modules for this model, but only if they exist
+        # External packages may not have config/datadir/datasets modules
+        import importlib.util
+        import warnings
+
+        for fixture_module in ["config", "datadir", "datasets"]:
+            full_module_name = f"{base_path}.{fixture_module}"
+            spec = importlib.util.find_spec(full_module_name)
+            if spec is not None:
+                plugins.append(full_module_name)
+            else:
+                warnings.warn(
+                    f"Model entry point '{ep.name}' missing fixture module '{fixture_module}' "
+                    f"at {full_module_name}. This may lead to some features of the testing suite "
+                    f"not being fully supported for this model fixture.",
+                    UserWarning,
+                )
+
+    return plugins
+
+
 pytest_plugins = [
     "tests.fixtures.CMIP_Tables_Dir",
     "tests.fixtures.CV_Dir",
     "tests.fixtures.cmip7_test_data",
     "tests.fixtures.config_files",
     "tests.fixtures.configs",
+    "tests.fixtures.data_requests",
     "tests.fixtures.datasets",
     "tests.fixtures.environment",
     "tests.fixtures.example_data.awicm_recom",
@@ -43,10 +136,135 @@ def suppress_third_party_logs():
     "tests.fixtures.fake_data.fesom_mesh",
     "tests.fixtures.fake_filesystem",
     "tests.fixtures.sample_rules",
-    "tests.fixtures.config_files",
-    "tests.fixtures.CV_Dir",
-    "tests.fixtures.CMIP_Tables_Dir",
-    "tests.fixtures.config_files",
-    "tests.fixtures.CV_Dir",
-    "tests.fixtures.data_requests",
-]
+] + _get_model_fixture_plugins()  # Dynamically add model-contrib fixtures
+
+
+def _discover_model_runs():
+    """Discover all model run classes via entry points.
+
+    Discovers both built-in models (shipped with pycmor) and external
+    plugin models. All models are registered via the 'pycmor.fixtures.model_runs'
+    entry point group in pyproject.toml.
+
+    Returns
+    -------
+    list
+        List of BaseModelRun subclasses
+    """
+    try:
+        import importlib.metadata as importlib_metadata
+    except ImportError:
+        # Python < 3.8
+        import importlib_metadata
+
+    models = []
+
+    # Discover all models via entry points
+    entry_points = importlib_metadata.entry_points()
+
+    # Handle both old dict-style and new SelectableGroups-style
+    if hasattr(entry_points, "select"):
+        # Python 3.10+ with importlib.metadata.EntryPoints
+        pycmor_models = entry_points.select(group="pycmor.fixtures.model_runs")
+    else:
+        # Python 3.9 and earlier
+        pycmor_models = entry_points.get("pycmor.fixtures.model_runs", [])
+
+    for entry_point in pycmor_models:
+        try:
+            model_class = entry_point.load()
+            models.append(model_class)
+            logging.info(f"Discovered model: {entry_point.name} from {entry_point.value}")
+        except Exception as e:
+            logging.warning(f"Failed to load model {entry_point.name}: {e}")
+
+    return models
+
+
+def pytest_generate_tests(metafunc):
+    """Dynamically parametrize tests with available model runs.
+
+    This hook enables generic model tests to run against all registered models,
+    both built-in and from external plugins. Tests using the 'model_run_class'
+    fixture will be parametrized with all discovered model run classes.
+
+    Built-in models are registered in pyproject.toml:
+
+        [project.entry-points."pycmor.fixtures.model_runs"]
+        awicm_recom = "tests.contrib.models.awicm_recom.fixtures.model:AwicmRecomModelRun"
+
+    External plugins register their models the same way:
+
+        [project.entry-points."pycmor.fixtures.model_runs"]
+        cesm = "pycmor_plugin_cesm.model:CESMModelRun"
+
+    Parameters
+    ----------
+    metafunc : pytest.Metafunc
+        The pytest metafunc object for parametrization
+    """
+    if "model_run_class" in metafunc.fixturenames:
+        # Discover all model run classes via entry points
+        all_models = _discover_model_runs()
+
+        # Parametrize with model class and use model_name as test ID
+        metafunc.parametrize(
+            "model_run_class",
+            all_models,
+            ids=[model_cls.__name__.replace("ModelRun", "").lower() for model_cls in all_models],
+        )
+
+
+@pytest.fixture(scope="function")
+def model_run(model_run_class, request, tmp_path_factory):
+    """Instantiate a model run from a parametrized model run class.
+
+    This fixture works in conjunction with pytest_generate_tests to create
+    actual model run instances for testing.
+
+    Parameters
+    ----------
+    model_run_class : type
+        The model run class (parametrized by pytest_generate_tests)
+    request : pytest.FixtureRequest
+        Pytest request object for checking markers
+    tmp_path_factory : pytest.TempPathFactory
+        Factory for creating temporary directories
+
+    Returns
+    -------
+    BaseModelRun
+        An instance of the model run class
+    """
+    use_real = model_run_class.should_use_real_data(request)
+
+    # For built-in models, we can use from_module
+    # For plugins, we need a different approach since they won't have __file__ in tests
+    # Create instance directly with a fixtures_dir based on model_name
+    from pathlib import Path
+
+    # Try to infer fixtures_dir from the model class's module
+    model_module = model_run_class.__module__
+    if model_module.startswith("tests.contrib.models."):
+        # Built-in model - use from_module if we can find the file
+        import importlib
+
+        module = importlib.import_module(model_module)
+        if hasattr(module, "__file__"):
+            return model_run_class.from_module(
+                module.__file__,
+                use_real=use_real,
+                tmp_path_factory=tmp_path_factory,
+            )
+
+    # For plugins or if from_module doesn't work, create instance directly
+    # Use a sensible default for fixtures_dir
+    model_name = model_run_class.__name__.replace("ModelRun", "").lower()
+    fixtures_dir = Path.cwd() / "fixtures" / model_name
+
+    return model_run_class(
+        model_name=model_name,
+        fixtures_dir=fixtures_dir,
+        use_real=use_real,
+        tmp_path_factory=tmp_path_factory,
+    )
diff --git a/doc/adding_model_fixtures.rst b/doc/adding_model_fixtures.rst
new file mode 100644
index 00000000..793b4227
--- /dev/null
+++ b/doc/adding_model_fixtures.rst
@@ -0,0 +1,786 @@
+====================================
+Adding Model Fixtures to pycmor
+====================================
+
+This guide explains how to create an external test data package that integrates with pycmor's testing infrastructure.
+
+Overview
+========
+
+pycmor uses a **plugin-based architecture** for test data, allowing climate models to provide their own test datasets as separate packages. Each model package provides:
+
+1. **Model run classes** that handle data fetching and management
+2. **CMIP configuration files** for CMIP6/CMIP7 processing
+3. **Entry points** for automatic discovery by pycmor
+
+This approach enables:
+
+- **Decoupled maintenance**: Model teams maintain their own test data
+- **Progressive implementation**: Start with minimal implementation, add features over time
+- **Self-healing tests**: Tests automatically adapt as configs become available
+- **Shared infrastructure**: All models benefit from common test infrastructure
+
+Architecture
+============
+
+Entry Point Discovery
+---------------------
+
+pycmor discovers model fixtures through Python entry points defined in ``pyproject.toml``:
+
+.. code-block:: toml
+
+   [project.entry-points."pycmor.fixtures.model_runs"]
+   fesom_2p6 = "pycmor_test_data_fesom.fesom_2p6:Fesom2p6ModelRun"
+   fesom_dev = "pycmor_test_data_fesom.fesom_dev:FesomDevModelRun"
+
+Integration Test Matrix
+------------------------
+
+pycmor's integration tests create a test matrix across all discovered models:
+
+.. list-table:: Integration Test Matrix
+   :header-rows: 1
+   :widths: 30 20 25 25
+
+   * - Test
+     - Scope
+     - Runs For
+     - Validates
+   * - ``test_library_initialization``
+     - Basic setup
+     - Each model × CMIP6/7
+     - CMORizer can load config
+   * - ``test_library_process``
+     - Full pipeline
+     - Each model × CMIP6/7 × 3 orchestrators
+     - End-to-end processing
+   * - ``test_library_accessor``
+     - Accessor API
+     - Each model × CMIP6/7
+     - In-memory processing
+
+Self-Healing Test Behavior
+---------------------------
+
+Tests use the ``configs`` property for conditional xfail:
+
+.. code-block:: python
+
+   def test_library_initialization(model_run_instance, cmip_version):
+       # Conditionally xfail if config not available
+       if cmip_version not in model_run_instance.configs:
+           pytest.xfail(f"{cmip_version.upper()} config not available")
+
+       # Test proceeds only when config exists
+       config_path = model_run_instance.configs[cmip_version]
+       cmorizer = CMORizer.from_dict(load_config(config_path))
+       assert cmorizer is not None
+
+This creates a **progressive workflow**:
+
+1. **No configs**: Tests show ``XFAIL`` (expected failure) - not a problem
+2. **Add CMIP6 config**: CMIP6 tests pass, CMIP7 still ``XFAIL``
+3. **Add CMIP7 config**: All tests pass
+
+Step-by-Step Implementation Guide
+==================================
+
+This guide walks through creating a complete model fixture package using FESOM 2.6 as an example.
+
+Step 1: Create Package Structure
+---------------------------------
+
+Create a new Python package with this structure:
+
+.. code-block:: text
+
+   pycmor_test_data_<model>/
+   ├── README.md
+   ├── pyproject.toml
+   └── src/
+       └── pycmor_test_data_<model>/
+           ├── __init__.py
+           ├── <model>_2p6.py              # ModelRun class
+           ├── <model>_2p6_registry.yaml   # Pooch registry
+           ├── <model>_2p6_stub_manifest.yaml  # Stub data spec
+           └── fixtures/                   # CMIP configs (create later)
+
+**Example for FESOM:**
+
+.. code-block:: text
+
+   pycmor_test_data_fesom/
+   └── src/
+       └── pycmor_test_data_fesom/
+           ├── __init__.py
+           ├── fesom_2p6.py
+           ├── fesom_2p6_registry.yaml
+           └── fesom_2p6_stub_manifest.yaml
+
+Step 2: Create pyproject.toml
+------------------------------
+
+Define your package with entry points for model discovery:
+
+.. code-block:: toml
+
+   [build-system]
+   requires = ["setuptools>=61.0", "wheel"]
+   build-backend = "setuptools.build_meta"
+
+   [project]
+   name = "pycmor-test-data-fesom"
+   version = "0.1.0"
+   description = "FESOM test datasets for pycmor"
+   readme = "README.md"
+   requires-python = ">=3.9"
+   dependencies = [
+       "pycmor",
+   ]
+
+   # Register model runs for automatic discovery
+   [project.entry-points."pycmor.fixtures.model_runs"]
+   fesom_2p6 = "pycmor_test_data_fesom.fesom_2p6:Fesom2p6ModelRun"
+
+   [tool.setuptools]
+   zip-safe = false
+   include-package-data = true
+
+   [tool.setuptools.packages.find]
+   where = ["src"]
+
+   [tool.setuptools.package-dir]
+   "" = "src"
+
+   # Include YAML files in package distribution
+   [tool.setuptools.package-data]
+   pycmor_test_data_fesom = ["*.yaml", "fixtures/*.yaml"]
+
+**Key sections:**
+
+- ``project.entry-points``: Registers your model with pycmor
+- ``package-data``: Ensures YAML files are included in the package
+
+Step 3: Implement the ModelRun Class
+-------------------------------------
+
+Create a class inheriting from ``BaseModelRun``:
+
+.. code-block:: python
+
+   """FESOM 2.6 PI mesh model run implementation."""
+
+   import logging
+   from pathlib import Path
+
+   from pycmor.tutorial.base_model_run import BaseModelRun
+
+   logger = logging.getLogger(__name__)
+
+
+   class Fesom2p6ModelRun(BaseModelRun):
+       """FESOM 2.6 PI mesh model run.
+
+       This model run includes FESOM 2.6 output on the PI mesh configuration.
+       """
+
+       @property
+       def configs(self) -> dict:
+           """Return available CMIP config files.
+
+           Returns
+           -------
+           dict[str, Path]
+               Mapping of CMIP version ("cmip6", "cmip7") to config file paths.
+               Empty dict if no configs available.
+           """
+           configs = {}
+           fixtures_dir = Path(__file__).parent / "fixtures"
+
+           # Check for CMIP6 config
+           cmip6_config = fixtures_dir / "config_cmip6_fesom_2p6.yaml"
+           if cmip6_config.exists():
+               configs["cmip6"] = cmip6_config
+
+           # Check for CMIP7 config
+           cmip7_config = fixtures_dir / "config_cmip7_fesom_2p6.yaml"
+           if cmip7_config.exists():
+               configs["cmip7"] = cmip7_config
+
+           return configs
+
+       def fetch_real_datadir(self) -> Path:
+           """Download and extract real FESOM 2.6 data using pooch.
+
+           Returns
+           -------
+           Path
+               Path to the extracted data directory
+           """
+           from pycmor.tutorial.data_fetcher import fetch_and_extract
+
+           data_dir = fetch_and_extract(
+               "fesom_2p6_pimesh.tar",
+               registry_path=self.registry_path
+           )
+           return data_dir
+
+       def generate_stub_datadir(self, stub_dir: Path) -> Path:
+           """Generate stub data from YAML manifest.
+
+           Parameters
+           ----------
+           stub_dir : Path
+               Temporary directory for stub data
+
+           Returns
+           -------
+           Path
+               Path to the stub data directory
+           """
+           from pycmor.tutorial.stub_generator import generate_stub_files
+
+           return generate_stub_files(self.stub_manifest_path, stub_dir)
+
+       def open_mfdataset(self, **kwargs):
+           """Open FESOM 2.6 dataset with xarray.
+
+           Parameters
+           ----------
+           **kwargs
+               Additional keyword arguments for xr.open_mfdataset
+
+           Returns
+           -------
+           xr.Dataset
+               Opened dataset
+           """
+           import xarray as xr
+
+           fesom_output_dir = self.datadir / "outdata" / "fesom"
+           matching_files = [
+               f for f in fesom_output_dir.iterdir()
+               if f.name.startswith("temp.fesom")
+           ]
+
+           if not matching_files:
+               raise FileNotFoundError(
+                   f"No temp.fesom* files found in {fesom_output_dir}"
+               )
+
+           return xr.open_mfdataset(matching_files, **kwargs)
+
+**Required Methods:**
+
+1. ``configs`` property - Returns available CMIP configs (initially returns ``{}``)
+2. ``fetch_real_datadir()`` - Downloads real data via pooch
+3. ``generate_stub_datadir()`` - Creates lightweight test data
+4. ``open_mfdataset()`` - Opens data with xarray
+
+**Inherited Properties:**
+
+BaseModelRun automatically provides:
+
+- ``registry_path`` - Generated from class name (``fesom_2p6_registry.yaml``)
+- ``stub_manifest_path`` - Generated from class name (``fesom_2p6_stub_manifest.yaml``)
+- ``datadir`` - Lazy-loaded data directory
+- ``ds`` - Lazy-loaded xarray dataset
+
+Step 4: Create Registry and Stub Manifest
+------------------------------------------
+
+Create two YAML files for data management:
+
+**fesom_2p6_registry.yaml** (Pooch registry for real data):
+
+.. code-block:: yaml
+
+   fesom_2p6_pimesh.tar:
+     url: https://zenodo.org/record/12345/files/fesom_2p6_pimesh.tar
+     sha256: abc123def456...
+
+**fesom_2p6_stub_manifest.yaml** (Specification for stub data):
+
+.. code-block:: yaml
+
+   files:
+     - path: outdata/fesom/temp.fesom.1850.nc
+       variables:
+         temp:
+           dims: [time, nz1, nod2]
+           shape: [12, 10, 100]
+           dtype: float32
+
+See pycmor documentation for complete manifest specification.
+
+Step 5: Create CMIP Configuration Files
+----------------------------------------
+
+Create ``fixtures/`` directory and add CMIP configs. Start with CMIP6:
+
+**fixtures/config_cmip6_fesom_2p6.yaml:**
+
+.. code-block:: yaml
+
+   pycmor:
+     version: "unreleased"
+     use_xarray_backend: True
+     warn_on_no_rule: False
+
+   general:
+     name: "fesom_2p6_pimesh"
+     description: "FESOM 2.6 PI mesh configuration for CMIP6"
+     maintainer: "your_name"
+     email: "your.email@example.com"
+     cmor_version: "CMIP6"
+     mip: "CMIP"
+     frequency: "mon"
+     CMIP_Tables_Dir: "./cmip6-cmor-tables/Tables"
+     CV_Dir: "./cmip6-cmor-tables/CMIP6_CVs"
+
+   rules:
+     - name: "thetao_with_levels"
+       experiment_id: "piControl"
+       activity_id: "CMIP"
+       output_directory: "./output"
+       source_id: "FESOM"
+       grid_label: gn
+       variant_label: "r1i1p1f1"
+       model_component: "ocean"
+       inputs:
+         - path: "{{ datadir }}/outdata/fesom"
+           pattern: "temp.fesom..*\\.nc"  # REGEX pattern
+       cmor_variable: "thetao"
+       model_variable: "temp"
+       pipelines:
+         - level_regridder
+
+   pipelines:
+     - name: level_regridder
+       steps:
+         - pycmor.core.gather_inputs.load_mfdataset
+         - pycmor.std_lib.generic.get_variable
+         - pycmor.std_lib.generic.trigger_compute
+
+**Important Notes:**
+
+- Use ``{{ datadir }}`` template variable (NOT ``REPLACE_ME``)
+- ``pattern`` expects **regex**, not glob (``.*\\.nc`` not ``*.nc``)
+- Escape literal dots: ``\\.nc``
+- Include complete pipeline steps for your model
+
+**CMIP7 config** (optional, add when ready):
+
+.. code-block:: yaml
+
+   general:
+     cmor_version: "CMIP7"  # Changed from CMIP6
+     # CMIP_Tables_Dir not needed (uses packaged data)
+     # CV_Dir is optional
+
+   rules:
+     - name: "thetao_with_levels"
+       institution_id: "AWI"  # Required for CMIP7
+       compound_name: "ocean.thetao.mean.mon.gn"  # CMIP7 identifier
+       # ... rest similar to CMIP6
+
+Step 6: Test Your Implementation
+---------------------------------
+
+Install your package in development mode:
+
+.. code-block:: bash
+
+   cd pycmor_test_data_fesom
+   pip install -e .
+
+Verify entry point registration:
+
+.. code-block:: bash
+
+   python -c "from pycmor.tutorial.base_model_run import BaseModelRun; \
+              from tests.utils.entry_points import discover_model_runs; \
+              print(discover_model_runs())"
+
+Expected output should include your model:
+
+.. code-block:: python
+
+   {
+       'fesom_2p6': <class 'pycmor_test_data_fesom.fesom_2p6.Fesom2p6ModelRun'>,
+       # ... other models
+   }
+
+Test the ModelRun class:
+
+.. code-block:: python
+
+   from pycmor_test_data_fesom.fesom_2p6 import Fesom2p6ModelRun
+
+   # Create instance
+   model_run = Fesom2p6ModelRun.from_module(
+       "pycmor_test_data_fesom/fesom_2p6.py"
+   )
+
+   # Check configs (should be empty initially)
+   print(model_run.configs)  # {}
+
+   # Check data paths work
+   print(model_run.datadir)  # Should generate stub data
+
+Step 7: Run Integration Tests
+------------------------------
+
+From the pycmor repository:
+
+.. code-block:: bash
+
+   # Run tests for your model
+   pytest tests/integration/test_model_runs.py -k fesom_2p6 -v
+
+Expected behavior **without configs**:
+
+.. code-block:: text
+
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip6] XFAIL
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip7] XFAIL
+
+Expected behavior **with CMIP6 config**:
+
+.. code-block:: text
+
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip6] PASSED
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip7] XFAIL
+
+Expected behavior **with both configs**:
+
+.. code-block:: text
+
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip6] PASSED
+   test_model_runs.py::test_library_initialization[fesom_2p6-cmip7] PASSED
+
+Common Issues and Solutions
+============================
+
+Registry Files Not Found
+-------------------------
+
+**Error:**
+
+.. code-block:: text
+
+   FileNotFoundError: [Errno 2] No such file or directory:
+   '.../pycmor_test_data_fesom/registry.yaml'
+
+**Solution:**
+
+The ``BaseModelRun`` class automatically generates filenames from your class name. Ensure your files match the expected pattern:
+
+- ``Fesom2p6ModelRun`` → ``fesom_2p6_registry.yaml``
+- ``AwicmRecomModelRun`` → ``awicm_recom_registry.yaml``
+
+The conversion uses this pattern:
+
+.. code-block:: python
+
+   class_name = "Fesom2p6ModelRun".replace("ModelRun", "")  # "Fesom2p6"
+   prefix = re.sub(r'(?<!^)(?=[A-Z])', '_', class_name).lower()  # "fesom_2p6"
+   filename = f"{prefix}_registry.yaml"  # "fesom_2p6_registry.yaml"
+
+Invalid Regex Pattern
+---------------------
+
+**Error:**
+
+.. code-block:: text
+
+   re.error: nothing to repeat at position 0
+
+**Cause:**
+
+Using glob patterns instead of regex:
+
+.. code-block:: yaml
+
+   # WRONG - this is a glob pattern
+   pattern: "*.nc"
+
+   # CORRECT - this is a regex pattern
+   pattern: ".*\\.nc"
+
+**Solution:**
+
+- Use ``.*`` for "any characters" (not ``*``)
+- Escape literal dots: ``\\.`` (not ``.``)
+- Common patterns:
+
+  - Any .nc file: ``".*\\.nc"``
+  - Specific prefix: ``"temp.fesom..*\\.nc"``
+  - Date pattern: ``"data.\\d{4}-\\d{2}\\.nc"``
+
+Configs Not Discovered
+-----------------------
+
+**Symptom:** Tests still show XFAIL even after adding config files.
+
+**Checklist:**
+
+1. **File location correct?**
+
+   .. code-block:: bash
+
+      ls src/pycmor_test_data_fesom/fixtures/config_cmip6_*.yaml
+
+2. **Filenames match pattern?**
+
+   - For ``Fesom2p6ModelRun``: ``config_cmip6_fesom_2p6.yaml``
+   - Pattern: ``config_{cmip_version}_{model_prefix}.yaml``
+
+3. **configs property implemented?**
+
+   .. code-block:: python
+
+      @property
+      def configs(self) -> dict:
+          configs = {}
+          fixtures_dir = Path(__file__).parent / "fixtures"
+          cmip6_config = fixtures_dir / "config_cmip6_fesom_2p6.yaml"
+          if cmip6_config.exists():
+              configs["cmip6"] = cmip6_config
+          return configs
+
+4. **Package data registered in pyproject.toml?**
+
+   .. code-block:: toml
+
+      [tool.setuptools.package-data]
+      pycmor_test_data_fesom = ["*.yaml", "fixtures/*.yaml"]
+
+5. **Package reinstalled after adding configs?**
+
+   .. code-block:: bash
+
+      pip install -e . --force-reinstall --no-deps
+
+Template Variables Not Rendered
+--------------------------------
+
+**Error:**
+
+.. code-block:: text
+
+   FileNotFoundError: {{ datadir }}/outdata/fesom
+
+**Cause:**
+
+Tests render the config template, but you're using it directly.
+
+**Solution:**
+
+When using configs in tests, always render Jinja2 templates:
+
+.. code-block:: python
+
+   from jinja2 import Template
+   import yaml
+
+   # Load and render config
+   with open(config_path) as f:
+       template = Template(f.read())
+
+   rendered_config = template.render(datadir=str(model_run.datadir))
+   cfg = yaml.safe_load(rendered_config)
+
+Progressive Implementation Workflow
+====================================
+
+You don't need to implement everything at once. Here's a recommended progression:
+
+Phase 1: Minimal Viable Package
+--------------------------------
+
+**Goal:** Get your model discovered by pycmor tests
+
+**Implement:**
+
+1. Package structure with ``pyproject.toml``
+2. Basic ``ModelRun`` class with:
+
+   - ``fetch_real_datadir()``
+   - ``generate_stub_datadir()``
+   - ``open_mfdataset()``
+   - ``configs`` property returning ``{}``
+
+3. Registry and stub manifest files
+
+**Result:** Tests discover your model but show XFAIL (expected, not a problem)
+
+Phase 2: CMIP6 Integration
+---------------------------
+
+**Goal:** Enable CMIP6 processing tests
+
+**Implement:**
+
+1. Create ``fixtures/`` directory
+2. Add ``config_cmip6_<model>.yaml``
+3. Update ``configs`` property to return CMIP6 config
+
+**Result:** CMIP6 tests pass, CMIP7 tests still XFAIL
+
+Phase 3: CMIP7 Integration
+---------------------------
+
+**Goal:** Full CMIP6/7 support
+
+**Implement:**
+
+1. Add ``config_cmip7_<model>.yaml``
+2. ``configs`` property now returns both configs
+
+**Result:** All tests pass
+
+Phase 4: Optional Enhancements
+-------------------------------
+
+**Consider adding:**
+
+- Pytest fixture modules (``config.py``, ``datadir.py``, ``datasets.py``)
+- Additional model variants
+- Mesh-specific fixtures
+- Custom processing steps
+
+Best Practices
+==============
+
+Class Naming
+------------
+
+Use descriptive names that convert cleanly to filenames:
+
+.. code-block:: python
+
+   # GOOD - converts to fesom_2p6
+   class Fesom2p6ModelRun(BaseModelRun):
+       pass
+
+   # GOOD - converts to awicm_recom
+   class AwicmRecomModelRun(BaseModelRun):
+       pass
+
+   # AVOID - creates awkward filenames
+   class FESOMRun(BaseModelRun):  # -> f_e_s_o_m_run.yaml
+       pass
+
+Config Organization
+-------------------
+
+Organize configs by version and model:
+
+.. code-block:: text
+
+   fixtures/
+   ├── config_cmip6_fesom_2p6.yaml
+   ├── config_cmip7_fesom_2p6.yaml
+   ├── config_cmip6_fesom_dev.yaml
+   └── config_cmip7_fesom_dev.yaml
+
+Stub Data Design
+----------------
+
+Keep stub data minimal but representative:
+
+- Use small dimensions (time=12, lev=10, lat/lon=20)
+- Include all required coordinates
+- Match real data structure
+- Use realistic variable names
+
+Documentation
+-------------
+
+Document your ModelRun class clearly:
+
+.. code-block:: python
+
+   class Fesom2p6ModelRun(BaseModelRun):
+       """FESOM 2.6 PI mesh model run.
+
+       This model run includes FESOM 2.6 output on the PI mesh configuration
+       with monthly mean ocean temperature data.
+
+       Data Structure
+       --------------
+       - Input path: ``{datadir}/outdata/fesom/``
+       - File pattern: ``temp.fesom.*.nc``
+       - Mesh path: ``{datadir}/input/fesom/mesh/pi/``
+
+       Variables
+       ---------
+       - temp: 3D ocean potential temperature
+
+       CMIP Variables
+       --------------
+       - CMIP6: thetao (sea_water_potential_temperature)
+       - CMIP7: ocean.thetao.mean.mon.gn
+       """
+
+Testing Strategy
+----------------
+
+Test at multiple levels:
+
+1. **Unit tests**: Test ModelRun methods in your package
+2. **Integration tests**: Let pycmor's test suite validate integration
+3. **CI/CD**: Run both on every commit
+
+Example unit test:
+
+.. code-block:: python
+
+   # In your package's test suite
+   def test_fesom_2p6_data_structure():
+       """Test FESOM 2.6 data has expected structure."""
+       model_run = Fesom2p6ModelRun.from_module(__file__)
+       ds = model_run.ds
+
+       assert "temp" in ds.variables
+       assert "time" in ds.dims
+       assert len(ds.time) > 0
+
+Example References
+==================
+
+Complete implementations to study:
+
+**FESOM Package:**
+
+- Package: ``pycmor_test_data_fesom``
+- Location: ``https://github.com/fesom/pycmor_test_data``
+- Models: FESOM 2.6, FESOM dev
+
+**AWI-CM RECOM Package:**
+
+- Package: ``pycmor_test_data_awiesm``
+- Location: ``https://github.com/AWI-ESM/pycmor_test_data``
+- Models: AWI-CM RECOM
+
+**Built-in Example:**
+
+- Location: ``tests/contrib/models/awicm_recom/`` in pycmor repo
+- Complete reference implementation
+
+Related Documentation
+=====================
+
+* :doc:`test_infrastructure` - Test infrastructure overview
+* :doc:`developer_guide` - General developer guide
+* :doc:`pycmor_configuration` - Configuration file format
+* :doc:`pycmor_building_blocks` - Pipeline and rule concepts
+
+External Resources
+------------------
+
+* `Entry Points Guide <https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_
+* `Pooch Documentation <https://www.fatiando.org/pooch/>`_
+* `Jinja2 Templates <https://jinja.palletsprojects.com/>`_
diff --git a/doc/test_infrastructure.rst b/doc/test_infrastructure.rst
index ddbbcabc..727996ba 100644
--- a/doc/test_infrastructure.rst
+++ b/doc/test_infrastructure.rst
@@ -249,6 +249,114 @@ If still old, clear local cache:
     docker rmi ghcr.io/esm-tools/pycmor-testground:py3.10-prep-release
     docker pull ghcr.io/esm-tools/pycmor-testground:py3.10-prep-release
 
+Fixture Naming Conventions
+---------------------------
+
+The pycmor test suite uses semantic fixture naming to clearly indicate what type of object each fixture returns.
+
+Naming Convention
+^^^^^^^^^^^^^^^^^
+
+Fixtures follow these suffixes to indicate their return type:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 40 40
+
+   * - Suffix
+     - Returns
+     - Example
+   * - ``*_datadir``
+     - Path to directory with data files
+     - ``awicm_recom_datadir``
+   * - ``*_meshdir``
+     - Path to directory with mesh files
+     - ``fesom_pi_meshdir``
+   * - ``*_file``
+     - Path to single file
+     - ``fesom_sst_file``
+   * - ``*_ds``
+     - Opened xarray.Dataset
+     - ``fesom_sst_ds``
+   * - ``*_da``
+     - Opened xarray.DataArray
+     - ``fesom_temp_da``
+   * - ``*_cfg``
+     - Configuration dict
+     - ``awicm_recom_cfg``
+   * - ``*_cfgfile``
+     - Path to config file
+     - ``awicm_recom_cfgfile``
+   * - ``*_rule``
+     - Rule object
+     - ``fesom_temp_rule``
+
+Data Fixture Variants
+^^^^^^^^^^^^^^^^^^^^^^
+
+Test data fixtures come in three variants:
+
+1. **Router fixture** (no suffix): Returns stub by default, real if ``PYCMOR_USE_REAL_TEST_DATA=1``
+2. **Real variant** (``*_real_*``): Always downloads real data via pooch
+3. **Stub variant** (``*_stub_*``): Always generates lightweight stub data
+
+Example:
+
+.. code-block:: python
+
+   # Use the router (stub by default)
+   def test_something(awicm_recom_datadir):
+       data_path = awicm_recom_datadir / "output"
+
+   # Force real data with marker
+   @pytest.mark.real_data
+   def test_with_real_data(awicm_recom_datadir):
+       # awicm_recom_datadir now returns real data
+       pass
+
+   # Or explicitly request real/stub
+   def test_explicit(awicm_recom_real_datadir):
+       # Always gets real data
+       pass
+
+Migration Strategy
+^^^^^^^^^^^^^^^^^^
+
+The test suite is gradually migrating to these conventions:
+
+* **Old fixture names are deprecated** but still work with warnings
+* **New tests should use new naming conventions**
+* **When modifying existing tests**, migrate fixtures to new names
+* **Deprecation warnings** guide you to the new names
+
+Example deprecation:
+
+.. code-block:: python
+
+   # Old (deprecated but works)
+   def test_old(fesom_2p6_pimesh_esm_tools_data):
+       pass
+
+   # New (preferred)
+   def test_new(fesom_2p6_pimesh_datadir):
+       pass
+
+Finding Fixtures
+^^^^^^^^^^^^^^^^
+
+All fixtures are organized in ``tests/fixtures/``:
+
+.. code-block:: text
+
+   tests/fixtures/
+   ├── example_data/       # Real data download fixtures (pooch)
+   ├── stub_data/          # Stub data generation fixtures
+   ├── fake_data/          # Programmatic fake data
+   ├── datasets.py         # Opened xarray.Dataset fixtures
+   ├── sample_rules.py     # Rule object fixtures
+   ├── configs.py          # Config dict fixtures
+   └── config_files.py     # Config file path fixtures
+
 Related Documentation
 ---------------------
 
diff --git a/docs/PLUGIN_DEVELOPMENT.md b/docs/PLUGIN_DEVELOPMENT.md
new file mode 100644
index 00000000..efff40f5
--- /dev/null
+++ b/docs/PLUGIN_DEVELOPMENT.md
@@ -0,0 +1,650 @@
+# Developing pycmor Model Plugins
+
+This guide explains how to create external model plugins for pycmor that integrate seamlessly with the test suite.
+
+## Overview
+
+pycmor uses a plugin system that allows external developers to:
+1. Add support for their climate models
+2. Automatically integrate with pycmor's test suite
+3. Share model-specific fixtures and test data
+
+When you install a plugin with `pip install pycmor-plugin-yourmodel[test]`, the plugin's model will automatically be tested alongside pycmor's built-in models.
+
+## Example Plugins
+
+This guide uses three realistic examples from German climate modeling centers:
+1. **FOCI** - Flexible Ocean Climate Infrastructure (GEOMAR Kiel)
+2. **ICON** - Icosahedral Nonhydrostatic model (MPI-M Hamburg)
+3. **POEM** - Potsdam Earth Model (PIK Potsdam)
+
+## Creating a Plugin
+
+### 1. Package Structure
+
+**Example: FOCI plugin at GEOMAR**
+
+```
+pycmor-plugin-foci/
+├── pyproject.toml
+├── README.md
+├── src/
+│   └── pycmor_plugin_foci/
+│       ├── __init__.py
+│       ├── model.py          # FOCIModelRun class
+│       └── fixtures/
+│           ├── registry.yaml       # Pooch registry for real data
+│           └── stub_manifest.yaml  # Stub data specification
+└── tests/
+    └── test_foci_specific.py  # Model-specific tests
+```
+
+**Example: ICON plugin at MPI-M**
+
+```
+pycmor-plugin-icon/
+├── pyproject.toml
+├── README.md
+├── src/
+│   └── pycmor_plugin_icon/
+│       ├── __init__.py
+│       ├── model.py          # ICONModelRun class
+│       └── fixtures/
+│           ├── registry.yaml
+│           └── stub_manifest.yaml
+└── tests/
+    └── test_icon_specific.py
+```
+
+### 2. Implement Your ModelRun Class
+
+**Example 1: FOCI at GEOMAR**
+
+In `src/pycmor_plugin_foci/model.py`:
+
+```python
+"""FOCI model run implementation for GEOMAR."""
+
+from pathlib import Path
+from pycmor.tests.fixtures.base_model_run import BaseModelRun
+
+
+class FOCIModelRun(BaseModelRun):
+    """FOCI (Flexible Ocean Climate Infrastructure) model run.
+
+    FOCI couples NEMO ocean model with ECHAM atmosphere model.
+    Developed and maintained at GEOMAR Helmholtz Centre for Ocean Research.
+    """
+
+    def fetch_real_datadir(self) -> Path:
+        """Download real FOCI data using pooch.
+
+        Returns
+        -------
+        Path
+            Path to the extracted data directory
+        """
+        from tests.fixtures.example_data.data_fetcher import fetch_and_extract
+
+        return fetch_and_extract("foci_test_data.tar", registry_path=self.registry_path)
+
+    def generate_stub_datadir(self, stub_dir: Path) -> Path:
+        """Generate stub FOCI data from YAML manifest.
+
+        Parameters
+        ----------
+        stub_dir : Path
+            Temporary directory for stub data
+
+        Returns
+        -------
+        Path
+            Path to the stub data directory
+        """
+        from tests.fixtures.stub_generator import generate_stub_files
+
+        generate_stub_files(self.stub_manifest_path, stub_dir)
+        return stub_dir
+
+    def open_mfdataset(self, **kwargs):
+        """Open FOCI dataset from data directory.
+
+        FOCI uses NEMO ocean output with specific file naming patterns.
+
+        Parameters
+        ----------
+        **kwargs
+            Additional keyword arguments for xr.open_mfdataset
+
+        Returns
+        -------
+        xr.Dataset
+            Opened dataset
+        """
+        import xarray as xr
+
+        # FOCI/NEMO file pattern: FOCI_*_1m_*.nc
+        nc_files = list(self.datadir.glob("FOCI_*_1m_*.nc"))
+
+        if not nc_files:
+            raise FileNotFoundError(f"No FOCI files found in {self.datadir}")
+
+        return xr.open_mfdataset(nc_files, **kwargs)
+```
+
+**Example 2: ICON at MPI-M**
+
+In `src/pycmor_plugin_icon/model.py`:
+
+```python
+"""ICON model run implementation for MPI-M."""
+
+from pathlib import Path
+from pycmor.tests.fixtures.base_model_run import BaseModelRun
+
+
+class ICONModelRun(BaseModelRun):
+    """ICON (Icosahedral Nonhydrostatic) model run.
+
+    ICON is a unified modeling framework for atmosphere, ocean, and land.
+    Developed at MPI-M and DWD.
+    """
+
+    def fetch_real_datadir(self) -> Path:
+        """Download real ICON data using pooch.
+
+        Returns
+        -------
+        Path
+            Path to the extracted data directory
+        """
+        from tests.fixtures.example_data.data_fetcher import fetch_and_extract
+
+        return fetch_and_extract("icon_test_data.tar", registry_path=self.registry_path)
+
+    def generate_stub_datadir(self, stub_dir: Path) -> Path:
+        """Generate stub ICON data from YAML manifest.
+
+        Parameters
+        ----------
+        stub_dir : Path
+            Temporary directory for stub data
+
+        Returns
+        -------
+        Path
+            Path to the stub data directory
+        """
+        from tests.fixtures.stub_generator import generate_stub_files
+
+        generate_stub_files(self.stub_manifest_path, stub_dir)
+        return stub_dir
+
+    def open_mfdataset(self, **kwargs):
+        """Open ICON dataset from data directory.
+
+        ICON uses unstructured icosahedral grids with specific conventions.
+
+        Parameters
+        ----------
+        **kwargs
+            Additional keyword arguments for xr.open_mfdataset
+
+        Returns
+        -------
+        xr.Dataset
+            Opened dataset
+        """
+        import xarray as xr
+
+        # ICON file pattern: icon_atm_*.nc
+        nc_files = list(self.datadir.glob("icon_atm_*.nc"))
+
+        if not nc_files:
+            raise FileNotFoundError(f"No ICON files found in {self.datadir}")
+
+        return xr.open_mfdataset(nc_files, **kwargs)
+```
+
+**Example 3: POEM at PIK**
+
+In `src/pycmor_plugin_poem/model.py`:
+
+```python
+"""POEM model run implementation for PIK."""
+
+from pathlib import Path
+from pycmor.tests.fixtures.base_model_run import BaseModelRun
+
+
+class POEMModelRun(BaseModelRun):
+    """POEM (Potsdam Earth Model) model run.
+
+    POEM is a fast and comprehensive Earth system model featuring:
+    - Ocean general circulation model
+    - Statistical-dynamical atmosphere
+    - LPJmL land biosphere model
+    - PISM ice-sheet model
+
+    Developed at PIK Potsdam for planetary boundaries and long-term climate research.
+    """
+
+    def fetch_real_datadir(self) -> Path:
+        """Download real POEM data using pooch.
+
+        Returns
+        -------
+        Path
+            Path to the extracted data directory
+        """
+        from tests.fixtures.example_data.data_fetcher import fetch_and_extract
+
+        return fetch_and_extract("poem_test_data.tar", registry_path=self.registry_path)
+
+    def generate_stub_datadir(self, stub_dir: Path) -> Path:
+        """Generate stub POEM data from YAML manifest.
+
+        Parameters
+        ----------
+        stub_dir : Path
+            Temporary directory for stub data
+
+        Returns
+        -------
+        Path
+            Path to the stub data directory
+        """
+        from tests.fixtures.stub_generator import generate_stub_files
+
+        generate_stub_files(self.stub_manifest_path, stub_dir)
+        return stub_dir
+
+    def open_mfdataset(self, **kwargs):
+        """Open POEM dataset from data directory.
+
+        POEM uses standard Earth system model output conventions.
+
+        Parameters
+        ----------
+        **kwargs
+            Additional keyword arguments for xr.open_mfdataset
+
+        Returns
+        -------
+        xr.Dataset
+            Opened dataset
+        """
+        import xarray as xr
+
+        # POEM file pattern: poem_*.nc
+        nc_files = list(self.datadir.glob("poem_*.nc"))
+
+        if not nc_files:
+            raise FileNotFoundError(f"No POEM files found in {self.datadir}")
+
+        return xr.open_mfdataset(nc_files, **kwargs)
+```
+
+### 3. Create Fixture Files
+
+**Example: FOCI registry.yaml**
+
+```yaml
+# src/pycmor_plugin_foci/fixtures/registry.yaml
+foci_test_data.tar:
+  url: https://data.geomar.de/foci/test_data/foci_cmip6_test.tar
+  sha256: null  # Add SHA256 hash for verification
+  description: FOCI CMIP6 test data from GEOMAR
+  extract_dir: foci_test_data
+```
+
+**Example: ICON registry.yaml**
+
+```yaml
+# src/pycmor_plugin_icon/fixtures/registry.yaml
+icon_test_data.tar:
+  url: https://mpimet.mpg.de/icon/test_data/icon_cmip6_test.tar
+  sha256: null  # Add SHA256 hash for verification
+  description: ICON CMIP6 test data from MPI-M
+  extract_dir: icon_test_data
+```
+
+**Example: POEM registry.yaml**
+
+```yaml
+# src/pycmor_plugin_poem/fixtures/registry.yaml
+poem_test_data.tar:
+  url: https://www.pik-potsdam.de/poem/test_data/poem_cmip6_test.tar
+  sha256: null  # Add SHA256 hash for verification
+  description: POEM CMIP6 test data from PIK
+  extract_dir: poem_test_data
+```
+
+**Example: FOCI stub_manifest.yaml**
+
+```yaml
+# src/pycmor_plugin_foci/fixtures/stub_manifest.yaml
+files:
+  - path: FOCI_ocean_1m_2000-01.nc
+    dimensions:
+      time: 12
+      y: 180
+      x: 360
+      depth: 50
+    variables:
+      thetao:
+        dims: [time, depth, y, x]
+        attrs:
+          long_name: Sea Water Potential Temperature
+          units: degC
+          standard_name: sea_water_potential_temperature
+      so:
+        dims: [time, depth, y, x]
+        attrs:
+          long_name: Sea Water Salinity
+          units: psu
+          standard_name: sea_water_salinity
+```
+
+**Example: ICON stub_manifest.yaml**
+
+```yaml
+# src/pycmor_plugin_icon/fixtures/stub_manifest.yaml
+files:
+  - path: icon_atm_2d_ml_2000-01.nc
+    dimensions:
+      time: 12
+      ncells: 20480  # R2B04 resolution
+      nlevels: 90
+    variables:
+      tas:
+        dims: [time, ncells]
+        attrs:
+          long_name: Near-Surface Air Temperature
+          units: K
+          standard_name: air_temperature
+      ps:
+        dims: [time, ncells]
+        attrs:
+          long_name: Surface Air Pressure
+          units: Pa
+          standard_name: surface_air_pressure
+```
+
+**Example: POEM stub_manifest.yaml**
+
+```yaml
+# src/pycmor_plugin_poem/fixtures/stub_manifest.yaml
+files:
+  - path: poem_ocean_2000.nc
+    dimensions:
+      time: 12
+      lat: 180
+      lon: 360
+      depth: 40
+    variables:
+      thetao:
+        dims: [time, depth, lat, lon]
+        attrs:
+          long_name: Sea Water Potential Temperature
+          units: degC
+          standard_name: sea_water_potential_temperature
+      tos:
+        dims: [time, lat, lon]
+        attrs:
+          long_name: Sea Surface Temperature
+          units: degC
+          standard_name: sea_surface_temperature
+```
+
+### 4. Register Your Plugin
+
+**Example: FOCI pyproject.toml (GEOMAR)**
+
+```toml
+[project]
+name = "pycmor-plugin-foci"
+version = "0.1.0"
+description = "FOCI model plugin for pycmor (GEOMAR)"
+dependencies = [
+    "pycmor>=1.0.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pycmor[test]",  # Include pycmor's test dependencies
+    "pytest>=7.0",
+]
+
+# Register your model via entry points
+[project.entry-points."pycmor.fixtures.model_runs"]
+foci = "pycmor_plugin_foci.model:FOCIModelRun"
+```
+
+**Example: ICON pyproject.toml (MPI-M)**
+
+```toml
+[project]
+name = "pycmor-plugin-icon"
+version = "0.1.0"
+description = "ICON model plugin for pycmor (MPI-M)"
+dependencies = [
+    "pycmor>=1.0.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pycmor[test]",  # Include pycmor's test dependencies
+    "pytest>=7.0",
+]
+
+# Register your model via entry points
+[project.entry-points."pycmor.fixtures.model_runs"]
+icon = "pycmor_plugin_icon.model:ICONModelRun"
+```
+
+**Example: POEM pyproject.toml (PIK)**
+
+```toml
+[project]
+name = "pycmor-plugin-poem"
+version = "0.1.0"
+description = "POEM model plugin for pycmor (PIK Potsdam)"
+dependencies = [
+    "pycmor>=1.0.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pycmor[test]",  # Include pycmor's test dependencies
+    "pytest>=7.0",
+]
+
+# Register your model via entry points
+[project.entry-points."pycmor.fixtures.model_runs"]
+poem = "pycmor_plugin_poem.model:POEMModelRun"
+```
+
+## Using Your Plugin
+
+### Installation
+
+Users install your plugin with the test extra:
+
+```bash
+# At GEOMAR Kiel
+pip install pycmor-plugin-foci[test]
+
+# At MPI-M Hamburg
+pip install pycmor-plugin-icon[test]
+
+# At PIK Potsdam
+pip install pycmor-plugin-poem[test]
+```
+
+### Running Tests
+
+When users run pycmor's test suite, your model is automatically included:
+
+```bash
+cd /path/to/pycmor
+pytest tests/test_generic_models.py
+```
+
+Output:
+```
+tests/test_generic_models.py::test_model_run_has_datadir[awicmrecom] PASSED
+tests/test_generic_models.py::test_model_run_has_datadir[fesom2p6pimesh] PASSED
+tests/test_generic_models.py::test_model_run_has_datadir[fesomuxarray] PASSED
+tests/test_generic_models.py::test_model_run_has_datadir[foci] PASSED  ← GEOMAR's FOCI!
+tests/test_generic_models.py::test_model_run_has_datadir[icon] PASSED  ← MPI-M's ICON!
+tests/test_generic_models.py::test_model_run_has_datadir[poem] PASSED  ← PIK's POEM!
+...
+```
+
+## Generic Tests
+
+Your model will automatically be tested against:
+
+1. **Data directory access** - Can provide a valid data directory
+2. **Dataset opening** - Can open an xarray dataset
+3. **Registry configuration** - Has proper registry.yaml
+4. **Stub manifest** - Has proper stub_manifest.yaml
+5. **Lazy loading** - Properties are lazy-loaded
+6. **Attribute presence** - Has required attributes (model_name, etc.)
+
+## Adding Model-Specific Tests
+
+You can also add tests specific to your model.
+
+**Example: FOCI-specific tests** (`tests/test_foci_specific.py`):
+
+```python
+import pytest
+
+
+def test_foci_has_ocean_variables(foci_model_run):
+    """Test FOCI-specific ocean variables from NEMO."""
+    ds = foci_model_run.ds
+    assert 'thetao' in ds.data_vars, "Missing potential temperature"
+    assert 'so' in ds.data_vars, "Missing salinity"
+
+
+def test_foci_nemo_grid_structure(foci_model_run):
+    """Test that FOCI uses expected NEMO grid dimensions."""
+    ds = foci_model_run.ds
+    assert 'x' in ds.dims or 'i' in ds.dims, "Missing NEMO x/i dimension"
+    assert 'y' in ds.dims or 'j' in ds.dims, "Missing NEMO y/j dimension"
+```
+
+**Example: ICON-specific tests** (`tests/test_icon_specific.py`):
+
+```python
+import pytest
+
+
+def test_icon_has_unstructured_grid(icon_model_run):
+    """Test ICON uses icosahedral unstructured grid."""
+    ds = icon_model_run.ds
+    assert 'ncells' in ds.dims, "Missing ncells dimension for unstructured grid"
+
+
+def test_icon_atmosphere_variables(icon_model_run):
+    """Test ICON-specific atmosphere variables."""
+    ds = icon_model_run.ds
+    assert 'tas' in ds.data_vars, "Missing near-surface air temperature"
+    assert 'ps' in ds.data_vars, "Missing surface pressure"
+```
+
+To make your model_run fixture available, create `conftest.py`:
+
+**Example: FOCI conftest.py**
+
+```python
+import pytest
+from pycmor_plugin_foci.model import FOCIModelRun
+
+
+@pytest.fixture(scope="session")
+def foci_model_run(request, tmp_path_factory):
+    """FOCI model run fixture for tests."""
+    use_real = FOCIModelRun.should_use_real_data(request)
+    from pathlib import Path
+    fixtures_dir = Path(__file__).parent.parent / "src" / "pycmor_plugin_foci" / "fixtures"
+
+    return FOCIModelRun(
+        model_name="foci",
+        fixtures_dir=fixtures_dir,
+        use_real=use_real,
+        tmp_path_factory=tmp_path_factory,
+    )
+```
+
+**Example: ICON conftest.py**
+
+```python
+import pytest
+from pycmor_plugin_icon.model import ICONModelRun
+
+
+
+@pytest.fixture(scope="session")
+def icon_model_run(request, tmp_path_factory):
+    """ICON model run fixture for tests."""
+    use_real = ICONModelRun.should_use_real_data(request)
+    from pathlib import Path
+    fixtures_dir = Path(__file__).parent.parent / "src" / "pycmor_plugin_icon" / "fixtures"
+
+    return ICONModelRun(
+        model_name="icon",
+        fixtures_dir=fixtures_dir,
+        use_real=use_real,
+        tmp_path_factory=tmp_path_factory,
+    )
+```
+
+## Best Practices
+
+1. **Use descriptive model names** - Name your ModelRun class clearly (e.g., `FOCIModelRun`, `ICONModelRun`, not `ModelRun`)
+
+2. **Provide both real and stub data** - Implement both `fetch_real_datadir()` and `generate_stub_datadir()`
+
+3. **Document your data requirements** - Clearly document what data files are expected
+
+4. **Include SHA256 hashes** - Add SHA256 hashes to registry.yaml for data integrity
+
+5. **Test locally first** - Run pycmor's test suite locally before publishing
+
+6. **Version constraints** - Pin compatible pycmor versions in your dependencies
+
+## Advanced: Optional Methods
+
+If your model has mesh files, override the mesh methods:
+
+```python
+def fetch_real_meshdir(self) -> Path:
+    """Download real mesh files."""
+    # Implementation
+    pass
+
+def generate_stub_meshdir(self, stub_dir: Path) -> Path:
+    """Generate stub mesh files."""
+    # Implementation
+    pass
+```
+
+Then users can access:
+```python
+mesh_path = cesm_model_run.meshdir
+```
+
+## Support
+
+For questions or issues:
+- pycmor documentation: https://pycmor.readthedocs.io/
+- pycmor issues: https://github.com/esm-tools/pycmor/issues
+- Example plugin: See `tests/contrib/models/` for built-in model examples
+
+## License
+
+Plugins can use any license, but must be compatible with pycmor's license.
diff --git a/pixi.lock b/pixi.lock
index 00aa24fb..7f69714f 100644
--- a/pixi.lock
+++ b/pixi.lock
@@ -81,7 +81,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -123,7 +123,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/7b/7a/a8d32501bb95ecff342004a674720164f95ad616f269450b3bc13dc88ae3/netcdf4-1.7.4-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/9b/89/1a74ea99b180b7a5587b0301ed1b183a2937c4b4b67f7994689b5d36fc34/numba-0.64.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/bd/79/cc665495e4d57d0aa6fbcc0aa57aa82671dfc78fbf95fe733ed86d98f52a/numpy-2.4.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/0a/0d/0e3ecece05b7a7e87ab9fb587855548da437a061326fff64a223b6dcb78a/numpy-2.4.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -137,7 +137,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/3f/2b/abe15c62ef1aece41d0799f31ba97d298aad9c76bc31dd655c387c29f17a/Pint-0.24.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/06/26/fd5e5d034af92d5eaabde3e4e1920143f9ab1292c83296bf0ec9e2731958/pint_xarray-0.5.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -152,10 +152,10 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/00/4b/ccc026168948fec4f7555b9164c724cf4125eac006e176541483d2c959be/pydantic_settings-2.13.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ab/4c/b888e6cf58bd9db9c93f40d1c6be8283ff49d88919231afe93a6bcf61626/pydeck-0.9.1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/4f/cf/8c1b6340baf81d7f6c97fe0181bda7cfd500d5e33bf469fbffbdae07b3c9/pydocket-0.18.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
@@ -164,7 +164,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/9e/40/bb226f203caa22c1043c1ca79b36340156eca0f6a6742b46c3bb222a3a57/regex-2026.2.28-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/0a/fe/661043d1c263b0d9d10c6ff4e9c9745f3df9641c62b51f96a3473638e7ce/regex-2026.3.32-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -274,7 +274,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -316,7 +316,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/38/de/38ed7e1956943d28e8ea74161e97c3a00fb98d6d08943b4fd21bae32c240/netcdf4-1.7.4-cp311-abi3-macosx_13_0_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/23/c9/a0fb41787d01d621046138da30f6c2100d80857bf34b3390dd68040f27a3/numba-0.64.0.tar.gz
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/a9/ed/6388632536f9788cea23a3a1b629f25b43eaacd7d7377e5d6bc7b9deb69b/numpy-2.4.3-cp312-cp312-macosx_10_13_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/28/05/32396bec30fb2263770ee910142f49c1476d08e8ad41abf8403806b520ce/numpy-2.4.4-cp312-cp312-macosx_10_13_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -330,7 +330,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/3f/2b/abe15c62ef1aece41d0799f31ba97d298aad9c76bc31dd655c387c29f17a/Pint-0.24.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/06/26/fd5e5d034af92d5eaabde3e4e1920143f9ab1292c83296bf0ec9e2731958/pint_xarray-0.5.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -345,10 +345,10 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/00/4b/ccc026168948fec4f7555b9164c724cf4125eac006e176541483d2c959be/pydantic_settings-2.13.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ab/4c/b888e6cf58bd9db9c93f40d1c6be8283ff49d88919231afe93a6bcf61626/pydeck-0.9.1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/4f/cf/8c1b6340baf81d7f6c97fe0181bda7cfd500d5e33bf469fbffbdae07b3c9/pydocket-0.18.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl
@@ -357,7 +357,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/77/83/0c8a5623a233015595e3da499c5a1c13720ac63c107897a6037bb97af248/regex-2026.2.28-cp312-cp312-macosx_10_13_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/92/0a/7dcffeebe0fcac45a1f9caf80712002d3cbd66d7d69d719315ee142b280f/regex-2026.3.32-cp312-cp312-macosx_10_13_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -467,7 +467,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -509,7 +509,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/34/b6/0370bb3af66a12098da06dc5843f3b349b7c83ccbdf7306e7afa6248b533/netcdf4-1.7.4.tar.gz
       - pypi: https://files.pythonhosted.org/packages/70/a6/9fc52cb4f0d5e6d8b5f4d81615bc01012e3cf24e1052a60f17a68deb8092/numba-0.64.0-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/74/1b/ee2abfc68e1ce728b2958b6ba831d65c62e1b13ce3017c13943f8f9b5b2e/numpy-2.4.3-cp312-cp312-macosx_11_0_arm64.whl
+      - pypi: https://files.pythonhosted.org/packages/c5/f3/a983d28637bfcd763a9c7aafdb6d5c0ebf3d487d1e1459ffdb57e2f01117/numpy-2.4.4-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -523,7 +523,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/3f/2b/abe15c62ef1aece41d0799f31ba97d298aad9c76bc31dd655c387c29f17a/Pint-0.24.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/06/26/fd5e5d034af92d5eaabde3e4e1920143f9ab1292c83296bf0ec9e2731958/pint_xarray-0.5.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -538,10 +538,10 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/00/4b/ccc026168948fec4f7555b9164c724cf4125eac006e176541483d2c959be/pydantic_settings-2.13.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ab/4c/b888e6cf58bd9db9c93f40d1c6be8283ff49d88919231afe93a6bcf61626/pydeck-0.9.1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/4f/cf/8c1b6340baf81d7f6c97fe0181bda7cfd500d5e33bf469fbffbdae07b3c9/pydocket-0.18.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl
@@ -550,7 +550,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/9e/06/3ef1ac6910dc3295ebd71b1f9bfa737e82cfead211a18b319d45f85ddd09/regex-2026.2.28-cp312-cp312-macosx_11_0_arm64.whl
+      - pypi: https://files.pythonhosted.org/packages/e3/ec/988486058ef49eb931476419bae00f164c4ceb44787c45dc7a54b7de0ea4/regex-2026.3.32-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -696,7 +696,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -744,7 +744,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9b/89/1a74ea99b180b7a5587b0301ed1b183a2937c4b4b67f7994689b5d36fc34/numba-0.64.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/bd/79/cc665495e4d57d0aa6fbcc0aa57aa82671dfc78fbf95fe733ed86d98f52a/numpy-2.4.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/0a/0d/0e3ecece05b7a7e87ab9fb587855548da437a061326fff64a223b6dcb78a/numpy-2.4.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -759,7 +759,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2a/2d/d4bf65e47cea8ff2c794a600c4fd1273a7902f268757c531e0ee9f18aa58/pooch-1.9.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5d/19/fd3ef348460c80af7bb4669ea7926651d1f95c23ff2df18b9d24bab4f3fa/pre_commit-4.5.1-py2.py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -779,12 +779,13 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/c2/2f/81d580a0fb83baeb066698975cb14a618bdbed7720678566f1b046a95fe8/pyflakes-3.4.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9d/7a/d968e294073affff457b041c2be9868a40c1c71f4a35fcc1e45e5493067b/pytest_cov-7.1.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/0f/bd/11809f5c78d5d8da2d0e004845d2382768bc20798b3e0988bca61efd349f/pytest_github_actions_annotate_failures-0.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5a/cc/06253936f4a7fa2e0f48dfe6d851d9c56df896a9ab09ac019d70b760619c/pytest_mock-3.15.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ca/31/d4e37e9e550c2b92a9cbc2e4d0b7420a27224968580b5a447f420847c975/pytest_xdist-3.8.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/67/0f/019d3949a40280f6193b62bc010177d4ce702d0fce424322286488569cd3/python_discovery-1.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/bf/3c/2d5297d82286f6f3d92770289fd439956b201c0a4fc7e72efb9b2293758e/pytokens-0.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
@@ -794,7 +795,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/9e/40/bb226f203caa22c1043c1ca79b36340156eca0f6a6742b46c3bb222a3a57/regex-2026.2.28-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/0a/fe/661043d1c263b0d9d10c6ff4e9c9745f3df9641c62b51f96a3473638e7ce/regex-2026.3.32-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -936,7 +937,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -984,7 +985,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/23/c9/a0fb41787d01d621046138da30f6c2100d80857bf34b3390dd68040f27a3/numba-0.64.0.tar.gz
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/a9/ed/6388632536f9788cea23a3a1b629f25b43eaacd7d7377e5d6bc7b9deb69b/numpy-2.4.3-cp312-cp312-macosx_10_13_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/28/05/32396bec30fb2263770ee910142f49c1476d08e8ad41abf8403806b520ce/numpy-2.4.4-cp312-cp312-macosx_10_13_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -999,7 +1000,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2a/2d/d4bf65e47cea8ff2c794a600c4fd1273a7902f268757c531e0ee9f18aa58/pooch-1.9.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5d/19/fd3ef348460c80af7bb4669ea7926651d1f95c23ff2df18b9d24bab4f3fa/pre_commit-4.5.1-py2.py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -1019,12 +1020,13 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/c2/2f/81d580a0fb83baeb066698975cb14a618bdbed7720678566f1b046a95fe8/pyflakes-3.4.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9d/7a/d968e294073affff457b041c2be9868a40c1c71f4a35fcc1e45e5493067b/pytest_cov-7.1.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/0f/bd/11809f5c78d5d8da2d0e004845d2382768bc20798b3e0988bca61efd349f/pytest_github_actions_annotate_failures-0.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5a/cc/06253936f4a7fa2e0f48dfe6d851d9c56df896a9ab09ac019d70b760619c/pytest_mock-3.15.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ca/31/d4e37e9e550c2b92a9cbc2e4d0b7420a27224968580b5a447f420847c975/pytest_xdist-3.8.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/67/0f/019d3949a40280f6193b62bc010177d4ce702d0fce424322286488569cd3/python_discovery-1.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/c6/78/397db326746f0a342855b81216ae1f0a32965deccfd7c830a2dbc66d2483/pytokens-0.4.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
@@ -1034,7 +1036,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/77/83/0c8a5623a233015595e3da499c5a1c13720ac63c107897a6037bb97af248/regex-2026.2.28-cp312-cp312-macosx_10_13_x86_64.whl
+      - pypi: https://files.pythonhosted.org/packages/92/0a/7dcffeebe0fcac45a1f9caf80712002d3cbd66d7d69d719315ee142b280f/regex-2026.3.32-cp312-cp312-macosx_10_13_x86_64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -1176,7 +1178,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a3/28/5ce78a4838bb9da1bd9f64bc79ba12ddbfcb4824a11ef41da6f05d3240ef/flexparser-0.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/de/7b/4ce04d96cb4538ab3eab6bbcc06e624bbbc3661011bfab0b536f4fb026ab/flox-0.11.2-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/54/b1a42925983c900e436a5b646f301d5e3e7ffb47a2db240d9dbbe0cd7c21/fluids-1.3.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/6a/09/e21df6aef1e1ffc0c816f0522ddc3f6dcded766c3261813131c78a704470/gitpython-3.1.46-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/91/4c/e0ce1ef95d4000ebc1c11801f9b944fa5910ecc15b5e351865763d8657f8/graphviz-0.21-py3-none-any.whl
@@ -1224,7 +1226,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/70/a6/9fc52cb4f0d5e6d8b5f4d81615bc01012e3cf24e1052a60f17a68deb8092/numba-0.64.0-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/07/d2/2391c7db0b1a56d466bc40f70dd2631aaaa9d487b90010640d064d7d923b/numbagg-0.8.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/74/1b/ee2abfc68e1ce728b2958b6ba831d65c62e1b13ce3017c13943f8f9b5b2e/numpy-2.4.3-cp312-cp312-macosx_11_0_arm64.whl
+      - pypi: https://files.pythonhosted.org/packages/c5/f3/a983d28637bfcd763a9c7aafdb6d5c0ebf3d487d1e1459ffdb57e2f01117/numpy-2.4.4-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/be/9c/92789c596b8df838baa98fa71844d84283302f7604ed565dafe5a6b5041a/oauthlib-3.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl
@@ -1239,7 +1241,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2a/2d/d4bf65e47cea8ff2c794a600c4fd1273a7902f268757c531e0ee9f18aa58/pooch-1.9.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5d/19/fd3ef348460c80af7bb4669ea7926651d1f95c23ff2df18b9d24bab4f3fa/pre_commit-4.5.1-py2.py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/cb/a1/d4b936e871af1b4b1c2c5feea32f38b08dfb413a23b5cf845f21cc287b81/prefect_dask-0.3.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl
@@ -1259,12 +1261,13 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/c2/2f/81d580a0fb83baeb066698975cb14a618bdbed7720678566f1b046a95fe8/pyflakes-3.4.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9d/7a/d968e294073affff457b041c2be9868a40c1c71f4a35fcc1e45e5493067b/pytest_cov-7.1.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/0f/bd/11809f5c78d5d8da2d0e004845d2382768bc20798b3e0988bca61efd349f/pytest_github_actions_annotate_failures-0.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5a/cc/06253936f4a7fa2e0f48dfe6d851d9c56df896a9ab09ac019d70b760619c/pytest_mock-3.15.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ca/31/d4e37e9e550c2b92a9cbc2e4d0b7420a27224968580b5a447f420847c975/pytest_xdist-3.8.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/67/0f/019d3949a40280f6193b62bc010177d4ce702d0fce424322286488569cd3/python_discovery-1.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/41/5d/e44573011401fb82e9d51e97f1290ceb377800fb4eed650b96f4753b499c/pytokens-0.4.1-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl
@@ -1274,7 +1277,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/74/3a/95deec7db1eb53979973ebd156f3369a72732208d1391cd2e5d127062a32/redis-7.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl
-      - pypi: https://files.pythonhosted.org/packages/9e/06/3ef1ac6910dc3295ebd71b1f9bfa737e82cfead211a18b319d45f85ddd09/regex-2026.2.28-cp312-cp312-macosx_11_0_arm64.whl
+      - pypi: https://files.pythonhosted.org/packages/e3/ec/988486058ef49eb931476419bae00f164c4ceb44787c45dc7a54b7de0ea4/regex-2026.3.32-cp312-cp312-macosx_11_0_arm64.whl
       - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/3b/5d/63d4ae3b9daea098d5d6f5da83984853c1bbacd5dc826764b249fe119d24/requests_oauthlib-2.0.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl
@@ -2558,10 +2561,10 @@ packages:
   - build ; extra == 'dev'
   - twine ; extra == 'dev'
   requires_python: '>=3.9'
-- pypi: https://files.pythonhosted.org/packages/e6/ab/fb21f4c939bb440104cc2b396d3be1d9b7a9fd3c6c2a53d98c45b3d7c954/fsspec-2026.2.0-py3-none-any.whl
+- pypi: https://files.pythonhosted.org/packages/d5/1f/5f4a3cd9e4440e9d9bc78ad0a91a1c8d46b4d429d5239ebe6793c9fe5c41/fsspec-2026.3.0-py3-none-any.whl
   name: fsspec
-  version: 2026.2.0
-  sha256: 98de475b5cb3bd66bedd5c4679e87b4fdfe1a3bf4d707b151b3c07e58c9a2437
+  version: 2026.3.0
+  sha256: d2ceafaad1b3457968ed14efa28798162f1638dbb5d2a6868a2db002a5ee39a4
   requires_dist:
   - adlfs ; extra == 'abfs'
   - adlfs ; extra == 'adl'
@@ -3625,20 +3628,20 @@ packages:
   - tabulate ; extra == 'dev'
   - jq ; sys_platform != 'win32' and extra == 'dev'
   requires_python: '>=3.9'
-- pypi: https://files.pythonhosted.org/packages/74/1b/ee2abfc68e1ce728b2958b6ba831d65c62e1b13ce3017c13943f8f9b5b2e/numpy-2.4.3-cp312-cp312-macosx_11_0_arm64.whl
+- pypi: https://files.pythonhosted.org/packages/0a/0d/0e3ecece05b7a7e87ab9fb587855548da437a061326fff64a223b6dcb78a/numpy-2.4.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
   name: numpy
-  version: 2.4.3
-  sha256: 7395e69ff32526710748f92cd8c9849b361830968ea3e24a676f272653e8983e
+  version: 2.4.4
+  sha256: 81f4a14bee47aec54f883e0cad2d73986640c1590eb9bfaaba7ad17394481e6e
   requires_python: '>=3.11'
-- pypi: https://files.pythonhosted.org/packages/a9/ed/6388632536f9788cea23a3a1b629f25b43eaacd7d7377e5d6bc7b9deb69b/numpy-2.4.3-cp312-cp312-macosx_10_13_x86_64.whl
+- pypi: https://files.pythonhosted.org/packages/28/05/32396bec30fb2263770ee910142f49c1476d08e8ad41abf8403806b520ce/numpy-2.4.4-cp312-cp312-macosx_10_13_x86_64.whl
   name: numpy
-  version: 2.4.3
-  sha256: 61b0cbabbb6126c8df63b9a3a0c4b1f44ebca5e12ff6997b80fcf267fb3150ef
+  version: 2.4.4
+  sha256: 15716cfef24d3a9762e3acdf87e27f58dc823d1348f765bbea6bef8c639bfa1b
   requires_python: '>=3.11'
-- pypi: https://files.pythonhosted.org/packages/bd/79/cc665495e4d57d0aa6fbcc0aa57aa82671dfc78fbf95fe733ed86d98f52a/numpy-2.4.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
+- pypi: https://files.pythonhosted.org/packages/c5/f3/a983d28637bfcd763a9c7aafdb6d5c0ebf3d487d1e1459ffdb57e2f01117/numpy-2.4.4-cp312-cp312-macosx_11_0_arm64.whl
   name: numpy
-  version: 2.4.3
-  sha256: e7dd01a46700b1967487141a66ac1a3cf0dd8ebf1f08db37d46389401512ca97
+  version: 2.4.4
+  sha256: 23cbfd4c17357c81021f21540da84ee282b9c8fba38a03b7b9d09ba6b951421e
   requires_python: '>=3.11'
 - pypi: https://files.pythonhosted.org/packages/b0/e0/760e73c111193db5ca37712a148e4807d1b0c60302ab31e4ada6528ca34d/numpy_groupies-0.11.3-py3-none-any.whl
   name: numpy-groupies
@@ -4251,10 +4254,10 @@ packages:
   - pyyaml>=5.1
   - virtualenv>=20.10.0
   requires_python: '>=3.10'
-- pypi: https://files.pythonhosted.org/packages/7a/33/0c3b28ff7dcb6b0bde145d6057785584bc1622d39bc48ea5af486faf4329/prefect-3.6.23-py3-none-any.whl
+- pypi: https://files.pythonhosted.org/packages/c9/34/5c660a1532f15a12defe83d097c55cb28c38872778399e8e9587c31bb3c2/prefect-3.6.24-py3-none-any.whl
   name: prefect
-  version: 3.6.23
-  sha256: 9ff1d82f399ced433ac794b23fb7b9426cd27b9e6e3610a1cdf5c4facb8975a2
+  version: 3.6.24
+  sha256: 5ac830a325f8775e8ddfdc27a5962bafccc6f26527f44361c2b1da703363650b
   requires_dist:
   - aiosqlite>=0.17.0,<1.0.0
   - alembic>=1.7.5,<2.0.0
@@ -4315,6 +4318,7 @@ packages:
   - prefect-aws>=0.5.8 ; extra == 'aws'
   - prefect-azure>=0.4.0 ; extra == 'azure'
   - prefect-bitbucket>=0.3.0 ; extra == 'bitbucket'
+  - python-on-whales>=0.81 ; extra == 'buildx'
   - uv>=0.6.0 ; extra == 'bundles'
   - prefect-dask>=0.3.0 ; extra == 'dask'
   - prefect-databricks>=0.3.0 ; extra == 'databricks'
@@ -4565,7 +4569,7 @@ packages:
 - pypi: ./
   name: pycmor
   version: 0.0.0
-  sha256: 7ff4ef49b14de74f505f07be3bf13cf3cdea8e54f879d9e0146dc94f1d69954f
+  sha256: 2c5279c2a843fd9f31f4cd28369a3adc8a0e86e2985f98dd6cdd4ebc71a2ffb6
   requires_dist:
   - bokeh>=3.4.3
   - cerberus>=1.3.5
@@ -4603,17 +4607,20 @@ packages:
   - dill>=0.3.8 ; extra == 'dev'
   - flake8>=7.1.1 ; extra == 'dev'
   - isort>=5.13.2 ; extra == 'dev'
+  - jinja2>=3.1.0 ; extra == 'dev'
   - pooch>=1.8.2 ; extra == 'dev'
   - pre-commit>=4.2.0 ; extra == 'dev'
   - pyfakefs>=5.6.0 ; extra == 'dev'
   - pytest>=8.3.2 ; extra == 'dev'
   - pytest-asyncio>=0.23.8 ; extra == 'dev'
   - pytest-cov>=5.0.0 ; extra == 'dev'
+  - pytest-github-actions-annotate-failures>=0.2.0 ; extra == 'dev'
   - pytest-mock>=3.14.0 ; extra == 'dev'
   - pytest-xdist>=3.6.1 ; extra == 'dev'
   - sphinx>=7.4.7 ; extra == 'dev'
   - sphinx-rtd-theme>=2.0.0 ; extra == 'dev'
   - yamllint>=1.37.1 ; extra == 'dev'
+  - sphinx>=7.4.7,<9 ; extra == 'doc'
   - sphinx-book-theme>=1.1.4 ; extra == 'doc'
   - sphinx-click>=6.0.0 ; extra == 'doc'
   - sphinx-copybutton>=0.5.2 ; extra == 'doc'
@@ -4624,6 +4631,7 @@ packages:
   - sphinxcontrib-napoleon>=0.7 ; extra == 'doc'
   - watchdog[watchmedo]>=4.0.1 ; extra == 'doc'
   - pyfesom2 ; extra == 'fesom'
+  - pycmor-test-data-fesom @ git+https://github.com/fesom/pycmor_test_data.git@main ; extra == 'fesom'
   - cmip7-data-request-api ; extra == 'cmip7'
   requires_python: '>=3.9'
   editable: true
@@ -4763,13 +4771,13 @@ packages:
   version: 3.4.0
   sha256: f742a7dbd0d9cb9ea41e9a24a918996e8170c799fa528688d40dd582c8265f4f
   requires_python: '>=3.9'
-- pypi: https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl
+- pypi: https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl
   name: pygments
-  version: 2.19.2
-  sha256: 86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b
+  version: 2.20.0
+  sha256: 81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176
   requires_dist:
   - colorama>=0.4.6 ; extra == 'windows-terminal'
-  requires_python: '>=3.8'
+  requires_python: '>=3.9'
 - conda: https://conda.anaconda.org/conda-forge/noarch/pygments-2.19.2-pyhd8ed1ab_0.conda
   sha256: 5577623b9f6685ece2697c6eb7511b4c9ac5fb607c9babc2646c811b428fd46a
   md5: 6b6ece66ebcae2d5f326c77ef2c5a066
@@ -4826,6 +4834,13 @@ packages:
   - pytest-xdist ; extra == 'testing'
   - virtualenv ; extra == 'testing'
   requires_python: '>=3.9'
+- pypi: https://files.pythonhosted.org/packages/0f/bd/11809f5c78d5d8da2d0e004845d2382768bc20798b3e0988bca61efd349f/pytest_github_actions_annotate_failures-0.4.0-py3-none-any.whl
+  name: pytest-github-actions-annotate-failures
+  version: 0.4.0
+  sha256: 285fed86e16b0b7a8eac6acdcde31913798fb739b15ef5b86895b4f5e32bf237
+  requires_dist:
+  - pytest>=7.0.0
+  requires_python: '>=3.10'
 - pypi: https://files.pythonhosted.org/packages/5a/cc/06253936f4a7fa2e0f48dfe6d851d9c56df896a9ab09ac019d70b760619c/pytest_mock-3.15.1-py3-none-any.whl
   name: pytest-mock
   version: 3.15.1
@@ -4949,12 +4964,11 @@ packages:
   requires_dist:
   - click>=5.0 ; extra == 'cli'
   requires_python: '>=3.10'
-- pypi: https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl
+- pypi: https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl
   name: python-json-logger
-  version: 4.0.0
-  sha256: af09c9daf6a813aa4cc7180395f50f2a9e5fa056034c9953aec92e381c5ba1e2
+  version: 4.1.0
+  sha256: 132994765cf75bf44554be9aa49b06ef2345d23661a96720262716438141b6b2
   requires_dist:
-  - typing-extensions ; python_full_version < '3.10'
   - orjson ; implementation_name != 'pypy' and extra == 'dev'
   - msgspec ; implementation_name != 'pypy' and extra == 'dev'
   - validate-pyproject[all] ; extra == 'dev'
@@ -4963,7 +4977,6 @@ packages:
   - mypy ; extra == 'dev'
   - pytest ; extra == 'dev'
   - freezegun ; extra == 'dev'
-  - backports-zoneinfo ; python_full_version < '3.9' and extra == 'dev'
   - tzdata ; extra == 'dev'
   - build ; extra == 'dev'
   - mkdocs ; extra == 'dev'
@@ -4974,7 +4987,7 @@ packages:
   - mkdocs-gen-files ; extra == 'dev'
   - mkdocs-literate-nav ; extra == 'dev'
   - mike ; extra == 'dev'
-  requires_python: '>=3.8'
+  requires_python: '>=3.10'
 - pypi: https://files.pythonhosted.org/packages/a4/62/02da182e544a51a5c3ccf4b03ab79df279f9c60c5e82d5e8bec7ca26ac11/python_slugify-8.0.4-py2.py3-none-any.whl
   name: python-slugify
   version: 8.0.4
@@ -5122,20 +5135,20 @@ packages:
   - rpds-py>=0.7.0
   - typing-extensions>=4.4.0 ; python_full_version < '3.13'
   requires_python: '>=3.10'
-- pypi: https://files.pythonhosted.org/packages/77/83/0c8a5623a233015595e3da499c5a1c13720ac63c107897a6037bb97af248/regex-2026.2.28-cp312-cp312-macosx_10_13_x86_64.whl
+- pypi: https://files.pythonhosted.org/packages/0a/fe/661043d1c263b0d9d10c6ff4e9c9745f3df9641c62b51f96a3473638e7ce/regex-2026.3.32-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
   name: regex
-  version: 2026.2.28
-  sha256: 02473c954af35dd2defeb07e44182f5705b30ea3f351a7cbffa9177beb14da5d
+  version: 2026.3.32
+  sha256: f54840bea73541652f1170dc63402a5b776fc851ad36a842da9e5163c1f504a0
   requires_python: '>=3.10'
-- pypi: https://files.pythonhosted.org/packages/9e/06/3ef1ac6910dc3295ebd71b1f9bfa737e82cfead211a18b319d45f85ddd09/regex-2026.2.28-cp312-cp312-macosx_11_0_arm64.whl
+- pypi: https://files.pythonhosted.org/packages/92/0a/7dcffeebe0fcac45a1f9caf80712002d3cbd66d7d69d719315ee142b280f/regex-2026.3.32-cp312-cp312-macosx_10_13_x86_64.whl
   name: regex
-  version: 2026.2.28
-  sha256: 9b65d33a17101569f86d9c5966a8b1d7fbf8afdda5a8aa219301b0a80f58cf7d
+  version: 2026.3.32
+  sha256: 3f5747501b69299c6b0b047853771e4ed390510bada68cb16da9c9c2078343f7
   requires_python: '>=3.10'
-- pypi: https://files.pythonhosted.org/packages/9e/40/bb226f203caa22c1043c1ca79b36340156eca0f6a6742b46c3bb222a3a57/regex-2026.2.28-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
+- pypi: https://files.pythonhosted.org/packages/e3/ec/988486058ef49eb931476419bae00f164c4ceb44787c45dc7a54b7de0ea4/regex-2026.3.32-cp312-cp312-macosx_11_0_arm64.whl
   name: regex
-  version: 2026.2.28
-  sha256: d6b08a06976ff4fb0d83077022fde3eca06c55432bb997d8c0495b9a4e9872f4
+  version: 2026.3.32
+  sha256: db976be51375bca900e008941639448d148c655c9545071965d0571ecc04f5d0
   requires_python: '>=3.10'
 - pypi: https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl
   name: requests
diff --git a/pyproject.toml b/pyproject.toml
index 6941a736..9f31a744 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -80,12 +80,14 @@ dev = [
     "dill>=0.3.8",
     "flake8>=7.1.1",
     "isort>=5.13.2",
+    "jinja2>=3.1.0",
     "pooch>=1.8.2",
     "pre-commit>=4.2.0",
     "pyfakefs>=5.6.0",
     "pytest>=8.3.2",
     "pytest-asyncio>=0.23.8",
     "pytest-cov>=5.0.0",
+    "pytest-github-actions-annotate-failures>=0.2.0",
     "pytest-mock>=3.14.0",
     "pytest-xdist>=3.6.1",
     "sphinx>=7.4.7",
@@ -112,6 +114,8 @@ fesom = [
     #
     #             $ gh pr view 215 --repo fesom/pyfesom2
     "pyfesom2",
+    # FESOM test datasets (external package)
+    "pycmor-test-data-fesom @ git+https://github.com/fesom/pycmor_test_data.git@v0.2.0",
 ]
 
 cmip7 = [
@@ -139,6 +143,13 @@ externals = "pycmor.core.externals:externals"
 plugins = "pycmor.core.plugins:plugins"
 externals = "pycmor.core.externals:externals"
 
+[project.entry-points."pycmor.fixtures.model_runs"]
+# Built-in model run fixtures shipped with pycmor
+# Note: These point to test fixtures for pytest compatibility, which re-export from pycmor.tutorial.datasets
+awicm_recom = "tests.contrib.models.awicm_recom.fixtures.model:AwicmRecomModelRun"
+# FESOM datasets are now in external package: pip install pycmor[fesom]
+# fesom_2p6 and fesom_dev entry points come from pycmor-test-data-fesom package
+
 [tool.setuptools]
 zip-safe = false
 include-package-data = true
@@ -151,7 +162,11 @@ exclude = ["tests*"]
 "" = "src"
 
 [tool.setuptools.package-data]
-pycmor = ["data/*.yaml", "data/cmip7/all_var_info.json"]
+pycmor = [
+    "data/*.yaml",
+    "data/cmip7/all_var_info.json",
+    "tutorial/datasets/*.yaml",
+]
 
 # Versioneer configuration
 [tool.versioneer]
diff --git a/src/pycmor/cli.py b/src/pycmor/cli.py
index c3c8d7bb..75fccef3 100644
--- a/src/pycmor/cli.py
+++ b/src/pycmor/cli.py
@@ -63,7 +63,12 @@ def find_subcommands():
     groups = ["pycmor.cli_subcommands", "pymor.cli_subcommands"]
     discovered_subcommands = {}
     for group in groups:
-        eps = entry_points(group=group) if hasattr(entry_points(), "__getitem__") else entry_points().get(group, [])
+        try:
+            # Python 3.10+ - use keyword argument
+            eps = entry_points(group=group)
+        except TypeError:
+            # Python 3.9 - returns dict-like object
+            eps = entry_points().get(group, [])
         for entry_point in eps:
             discovered_subcommands[entry_point.name] = {
                 "plugin_name": entry_point.value.split(":")[0].split(".")[0],
diff --git a/src/pycmor/tutorial/__init__.py b/src/pycmor/tutorial/__init__.py
index 3279e6d4..cdc7e84f 100644
--- a/src/pycmor/tutorial/__init__.py
+++ b/src/pycmor/tutorial/__init__.py
@@ -1,5 +1,25 @@
-"""Tutorial utilities for pycmor examples and testing."""
+"""Tutorial datasets for pycmor examples and testing.
 
-from .base_model_run import BaseModelRun
+This module provides an interface similar to xarray.tutorial for accessing
+pycmor's example datasets. It allows users and tests to easily load example
+climate model data for learning and experimentation.
 
-__all__ = ["BaseModelRun"]
+Examples
+--------
+Load a dataset from a registered model::
+
+    import pycmor.tutorial as tutorial
+    ds = tutorial.open_dataset("fesom_2p6")
+
+List available datasets::
+
+    tutorial.available_datasets()
+
+Get info about a dataset::
+
+    tutorial.info("fesom_2p6")
+"""
+
+from .loader import available_datasets, info, open_dataset
+
+__all__ = ["available_datasets", "info", "open_dataset"]
diff --git a/src/pycmor/tutorial/data_fetcher.py b/src/pycmor/tutorial/data_fetcher.py
new file mode 100644
index 00000000..a1b873d5
--- /dev/null
+++ b/src/pycmor/tutorial/data_fetcher.py
@@ -0,0 +1,191 @@
+"""
+Centralized test data fetcher using pooch.
+
+This module provides utilities to download and cache test data files
+defined in test_data_registry.yaml.
+"""
+
+import logging
+import os
+from pathlib import Path
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+
+def get_cache_dir() -> Path:
+    """Get the cache directory for test data."""
+    return Path(
+        os.getenv("PYCMOR_TEST_DATA_CACHE_DIR")
+        or Path(os.getenv("XDG_CACHE_HOME") or Path.home() / ".cache") / "pycmor" / "test_data"
+    )
+
+
+def load_registry(registry_path=None):
+    """Load the test data registry from YAML.
+
+    Parameters
+    ----------
+    registry_path : Path or str, optional
+        Path to a model-specific registry file. If not provided, uses the
+        default central registry at test_data_registry.yaml
+    """
+    if registry_path is None:
+        registry_file = Path(__file__).parent / "test_data_registry.yaml"
+    else:
+        registry_file = Path(registry_path)
+
+    with open(registry_file) as f:
+        return yaml.safe_load(f)
+
+
+def fetch_and_extract(filename: str, registry_path=None) -> Path:
+    """
+    Fetch and extract a test data tarball.
+
+    Uses pooch to download and cache the file, then extracts it.
+    The extracted directory is cached, so subsequent calls are fast.
+
+    Parameters
+    ----------
+    filename : str
+        Name of the file in the registry (e.g., "fesom_2p6_pimesh.tar")
+    registry_path : Path or str, optional
+        Path to a model-specific registry file. If not provided, uses the
+        default central registry.
+
+    Returns
+    -------
+    Path
+        Path to the extracted directory
+
+    Raises
+    ------
+    ValueError
+        If filename not found in registry or URL is not set
+    RuntimeError
+        If download or extraction fails
+
+    Examples
+    --------
+    >>> data_dir = fetch_and_extract("fesom_2p6_pimesh.tar")  # doctest: +SKIP
+    >>> print(data_dir)  # doctest: +SKIP
+    /home/user/.cache/pycmor/test_data/fesom_2p6_pimesh
+    """
+    import pooch
+
+    registry = load_registry(registry_path)
+    logger.info(f"Loaded registry from: {registry_path or 'default test_data_registry.yaml'}")
+
+    if filename not in registry:
+        raise ValueError(f"Unknown test data file: {filename}. " f"Available files: {list(registry.keys())}")
+
+    entry = registry[filename]
+    url = entry.get("url")
+    checksum = entry.get("sha256")
+    extract_dir = entry.get("extract_dir", filename.replace(".tar", ""))
+
+    logger.info(f"Registry entry for '{filename}':")
+    logger.info(f"  url: {url}")
+    logger.info(f"  sha256: {checksum}")
+    logger.info(f"  extract_dir: {extract_dir}")
+
+    if url is None:
+        raise ValueError(f"URL not set for {filename}. " f"Please update test_data_registry.yaml")
+
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    logger.info(f"Cache directory: {cache_dir}")
+
+    # Path where extracted data will be
+    extracted_path = cache_dir / extract_dir
+    logger.info(f"Expected extraction path: {extracted_path}")
+
+    # If already extracted, return it
+    if extracted_path.exists():
+        logger.info(f"Using cached extraction: {extracted_path}")
+        # List contents to verify
+        contents = list(extracted_path.iterdir())
+        logger.info(f"Cached directory contains {len(contents)} items:")
+        for item in contents[:10]:  # Show first 10 items
+            logger.info(f"  - {item.name} ({'dir' if item.is_dir() else 'file'})")
+        if len(contents) > 10:
+            logger.info(f"  ... and {len(contents) - 10} more items")
+        return extracted_path
+
+    # Download and extract
+    logger.info(f"Downloading and extracting {filename}...")
+
+    # Download the tarball with pooch (no extraction yet)
+    downloaded_path = pooch.retrieve(
+        url=url,
+        known_hash=f"sha256:{checksum}" if checksum else None,
+        path=cache_dir,
+        fname=filename,
+    )
+
+    # Extract manually into cache_dir directly -- tarballs already contain
+    # the extract_dir as their top-level directory prefix.
+    # Also handles absolute symlinks (Python 3.12+ rejects them with default filter).
+    import sys
+    import tarfile
+
+    extract_kwargs = {}
+    if sys.version_info >= (3, 12):
+        extract_kwargs["filter"] = "tar"
+
+    with tarfile.open(downloaded_path) as tar:
+        tar.extractall(path=cache_dir, **extract_kwargs)
+
+    logger.info(f"Data extracted to: {extracted_path}")
+    return extracted_path
+
+
+def fetch_tarball(filename: str, registry_path=None) -> Path:
+    """
+    Fetch a test data tarball without extracting.
+
+    Parameters
+    ----------
+    filename : str
+        Name of the file in the registry
+    registry_path : Path or str, optional
+        Path to a model-specific registry file. If not provided, uses the
+        default central registry.
+
+    Returns
+    -------
+    Path
+        Path to the downloaded tarball
+
+    Examples
+    --------
+    >>> tarball = fetch_tarball("fesom_2p6_pimesh.tar")  # doctest: +SKIP
+    """
+    import pooch
+
+    registry = load_registry(registry_path)
+
+    if filename not in registry:
+        raise ValueError(f"Unknown test data file: {filename}")
+
+    entry = registry[filename]
+    url = entry.get("url")
+    checksum = entry.get("sha256")
+
+    if url is None:
+        raise ValueError(f"URL not set for {filename}")
+
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+
+    # Download without processing
+    downloaded_path = pooch.retrieve(
+        url=url,
+        known_hash=f"sha256:{checksum}" if checksum else None,
+        path=cache_dir,
+        fname=filename,
+    )
+
+    return Path(downloaded_path)
diff --git a/src/pycmor/tutorial/datasets/__init__.py b/src/pycmor/tutorial/datasets/__init__.py
new file mode 100644
index 00000000..d9284e63
--- /dev/null
+++ b/src/pycmor/tutorial/datasets/__init__.py
@@ -0,0 +1,5 @@
+"""Tutorial datasets - model run fixtures for pycmor examples."""
+
+from .awicm_recom import AwicmRecomModelRun
+
+__all__ = ["AwicmRecomModelRun"]
diff --git a/src/pycmor/tutorial/datasets/awicm_recom.py b/src/pycmor/tutorial/datasets/awicm_recom.py
new file mode 100644
index 00000000..fd29cae9
--- /dev/null
+++ b/src/pycmor/tutorial/datasets/awicm_recom.py
@@ -0,0 +1,171 @@
+"""AWI-CM 1.0 RECOM biogeochemistry model run implementation."""
+
+import logging
+from pathlib import Path
+
+from ..base_model_run import BaseModelRun
+
+logger = logging.getLogger(__name__)
+
+
+class AwicmRecomModelRun(BaseModelRun):
+    """AWI-CM 1.0 RECOM biogeochemistry model run.
+
+    This model run includes FESOM ocean biogeochemistry output with RECOM.
+    """
+
+    @property
+    def registry_path(self) -> Path:
+        """Path to the pooch registry YAML file."""
+        return Path(__file__).parent / "awicm_recom_registry.yaml"
+
+    @property
+    def stub_manifest_path(self) -> Path:
+        """Path to the stub data manifest YAML file."""
+        return Path(__file__).parent / "awicm_recom_stub_manifest.yaml"
+
+    def fetch_real_datadir(self) -> Path:
+        """Download and extract real AWI-CM 1.0 RECOM data using pooch.
+
+        Returns
+        -------
+        Path
+            Path to the extracted data directory
+
+        Notes
+        -----
+        This method includes validation to check for corrupted extractions
+        by attempting to open a known NetCDF file.
+        """
+        from ..data_fetcher import fetch_and_extract
+
+        data_dir = fetch_and_extract("awicm_1p0_recom.tar", registry_path=self.registry_path)
+
+        # The tarball extracts to awicm_1p0_recom/awicm_1p0_recom
+        # Return the inner directory for consistency
+        final_data_path = data_dir / "awicm_1p0_recom"
+
+        if final_data_path.exists():
+            # Verify one of the known files exists and is valid
+            test_file = (
+                final_data_path
+                / "awi-esm-1-1-lr_kh800"
+                / "piControl"
+                / "outdata"
+                / "fesom"
+                / "thetao_fesom_2686-01-05.nc"
+            )
+            if test_file.exists():
+                try:
+                    # Try to open the file to verify it's not corrupted
+                    import xarray as xr
+
+                    with xr.open_dataset(test_file):
+                        logger.info(f"Validated extraction: {final_data_path}")
+                        return final_data_path
+                except (OSError, IOError) as e:
+                    logger.warning(f"Test file may be corrupted ({e}), but proceeding anyway")
+
+        return final_data_path if final_data_path.exists() else data_dir
+
+    def generate_stub_datadir(self, stub_dir: Path) -> Path:
+        """Generate stub data for awicm_recom from YAML manifest.
+
+        Parameters
+        ----------
+        stub_dir : Path
+            Temporary directory for stub data
+
+        Returns
+        -------
+        Path
+            Path to the stub data directory
+        """
+        from ..stub_generator import generate_stub_files
+
+        # Generate stub files
+        stub_dir = generate_stub_files(self.stub_manifest_path, stub_dir)
+
+        # Create mesh files (always generate them even if not all tests need them)
+        mesh_dir = stub_dir / "awi-esm-1-1-lr_kh800" / "piControl" / "input" / "fesom" / "mesh"
+        mesh_dir.mkdir(parents=True, exist_ok=True)
+        self._create_minimal_mesh_files(mesh_dir)
+
+        return stub_dir
+
+    def open_mfdataset(self, **kwargs):
+        """Open AWI-CM RECOM dataset from data directory.
+
+        Parameters
+        ----------
+        **kwargs
+            Additional keyword arguments for xr.open_mfdataset
+
+        Returns
+        -------
+        xr.Dataset
+            Opened dataset
+        """
+        import xarray as xr
+
+        # Find FESOM output files
+        fesom_output_dir = self.datadir / "awi-esm-1-1-lr_kh800" / "piControl" / "outdata" / "fesom"
+        nc_files = list(fesom_output_dir.glob("*.nc"))
+
+        if not nc_files:
+            raise FileNotFoundError(f"No NetCDF files found in {fesom_output_dir}")
+
+        return xr.open_mfdataset(nc_files, **kwargs)
+
+    @staticmethod
+    def _create_minimal_mesh_files(mesh_dir: Path):
+        """Create minimal FESOM mesh files for testing.
+
+        Parameters
+        ----------
+        mesh_dir : Path
+            Directory where mesh files will be created
+        """
+        # nod2d.out: 2D nodes (lon, lat)
+        with open(mesh_dir / "nod2d.out", "w") as f:
+            f.write("10\n")
+            for i in range(1, 11):
+                lon = 300.0 + i * 0.1
+                lat = 74.0 + i * 0.05
+                f.write(f"{i:8d} {lon:14.7f}  {lat:14.7f}        0\n")
+
+        # elem2d.out: 2D element connectivity
+        with open(mesh_dir / "elem2d.out", "w") as f:
+            f.write("5\n")
+            for i in range(1, 6):
+                n1, n2, n3 = i, i + 1, i + 2
+                f.write(f"{i:8d} {n1:8d} {n2:8d}\n")
+                f.write(f"{n2:8d} {n3:8d} {(i % 8) + 1:8d}\n")
+
+        # nod3d.out: 3D nodes (lon, lat, depth)
+        with open(mesh_dir / "nod3d.out", "w") as f:
+            f.write("30\n")
+            for i in range(1, 31):
+                lon = 300.0 + (i % 10) * 0.1
+                lat = 74.0 + (i % 10) * 0.05
+                depth = -100.0 * (i // 10)
+                f.write(f"{i:8d} {lon:14.7f}  {lat:14.7f} {depth:14.7f}        0\n")
+
+        # elem3d.out: 3D element connectivity (tetrahedra)
+        with open(mesh_dir / "elem3d.out", "w") as f:
+            f.write("10\n")  # 10 3D elements
+            for i in range(1, 11):
+                n1, n2, n3, n4 = i, i + 1, i + 2, i + 10
+                f.write(f"{n1:8d} {n2:8d} {n3:8d} {n4:8d}\n")
+
+        # aux3d.out: auxiliary 3D info (layer indices)
+        with open(mesh_dir / "aux3d.out", "w") as f:
+            f.write("3\n")  # 3 vertical layers
+            f.write("       1\n")  # Layer 1 starts at node 1
+            f.write("      11\n")  # Layer 2 starts at node 11
+            f.write("      21\n")  # Layer 3 starts at node 21
+
+        # depth.out: depth values at each node
+        with open(mesh_dir / "depth.out", "w") as f:
+            for i in range(10):
+                f.write(f"   {-100.0 - i * 50:.1f}\n")
diff --git a/src/pycmor/tutorial/datasets/awicm_recom_registry.yaml b/src/pycmor/tutorial/datasets/awicm_recom_registry.yaml
new file mode 100644
index 00000000..90a2c14a
--- /dev/null
+++ b/src/pycmor/tutorial/datasets/awicm_recom_registry.yaml
@@ -0,0 +1,10 @@
+# Test data registry for AWI-CM 1.0 RECOM model
+#
+# This file defines remote test data files that can be downloaded
+# and cached by the test suite using pooch.
+
+awicm_1p0_recom.tar:
+  url: https://nextcloud.awi.de/s/DaQjtTS9xB7o7pL/download/awicm_1p0_recom.tar
+  sha256: null  # TODO: Add checksum for validation
+  description: AWI-CM 1.0 RECOM biogeochemistry test data
+  extract_dir: awicm_1p0_recom
diff --git a/src/pycmor/tutorial/datasets/awicm_recom_stub_manifest.yaml b/src/pycmor/tutorial/datasets/awicm_recom_stub_manifest.yaml
new file mode 100644
index 00000000..d1e07973
--- /dev/null
+++ b/src/pycmor/tutorial/datasets/awicm_recom_stub_manifest.yaml
@@ -0,0 +1,363 @@
+source_directory: /Users/pgierz/.cache/pycmor/test_data/awicm_1p0_recom/awicm_1p0_recom
+files:
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-02.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-02 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-03.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-03 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-04.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-04 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-05.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-05 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-06.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-06 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-07.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-07 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-08.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-08 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-09.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-09 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-10.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-10 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-11.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-11 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+total_files: 10
diff --git a/src/pycmor/tutorial/loader.py b/src/pycmor/tutorial/loader.py
new file mode 100644
index 00000000..3c235a02
--- /dev/null
+++ b/src/pycmor/tutorial/loader.py
@@ -0,0 +1,227 @@
+"""Tutorial dataset loader implementation.
+
+This module handles loading tutorial datasets using the entry point system
+and the test fixture infrastructure for data generation.
+"""
+
+import importlib.metadata
+import os
+from pathlib import Path
+from typing import Optional
+
+import xarray as xr
+
+
+def _discover_model_runs() -> dict[str, type]:
+    """Discover all registered model run classes from entry points.
+
+    Returns
+    -------
+    dict[str, type]
+        Dictionary mapping model names to their ModelRun classes
+    """
+    model_runs = {}
+
+    # Python 3.9 vs 3.10+ compatibility
+    try:
+        # Try Python 3.10+ API first
+        eps = importlib.metadata.entry_points(group="pycmor.fixtures.model_runs")
+    except TypeError:
+        # Fall back to Python 3.9 API
+        all_eps = importlib.metadata.entry_points()
+        eps = all_eps.get("pycmor.fixtures.model_runs", [])
+
+    for ep in eps:
+        model_runs[ep.name] = ep.load()
+
+    return model_runs
+
+
+def available_datasets() -> list[str]:
+    """List all available tutorial datasets.
+
+    Returns
+    -------
+    list[str]
+        Names of available model datasets
+
+    Examples
+    --------
+    .. code-block:: python
+
+        import pycmor.tutorial as tutorial
+        tutorial.available_datasets()
+        # ['awicm_recom', 'fesom_2p6', ...]
+    """
+    model_runs = _discover_model_runs()
+    return sorted(model_runs.keys())
+
+
+def info(name: str) -> str:
+    """Get information about a tutorial dataset.
+
+    Parameters
+    ----------
+    name : str
+        Name of the dataset
+
+    Returns
+    -------
+    str
+        Description of the dataset (from model class docstring)
+
+    Raises
+    ------
+    KeyError
+        If the dataset name is not recognized
+
+    Examples
+    --------
+    .. code-block:: python
+
+        import pycmor.tutorial as tutorial
+        tutorial.info("fesom_2p6")
+    """
+    model_runs = _discover_model_runs()
+    if name not in model_runs:
+        available = ", ".join(available_datasets())
+        raise KeyError(
+            f"Dataset '{name}' not found. Available datasets: {available}. "
+            f"Use pycmor.tutorial.available_datasets() to see all options."
+        )
+
+    model_class = model_runs[name]
+    # Get the first line of the docstring
+    if model_class.__doc__:
+        return model_class.__doc__.strip().split("\n")[0]
+    return f"Model run: {name}"
+
+
+def open_dataset(
+    name: str,
+    *,
+    use_real: bool = False,
+    cache: bool = True,
+    cache_dir: Optional[Path] = None,
+    **kwargs,
+) -> xr.Dataset:
+    """Open a tutorial dataset from pycmor's collection.
+
+    This function provides easy access to example climate model datasets
+    for tutorials, examples, and testing. It uses the entry point system
+    to discover available models and the BaseModelRun pattern to handle
+    both real and stub data.
+
+    Available datasets are discovered via entry points registered under
+    'pycmor.fixtures.model_runs'. Use available_datasets() to see the
+    current list.
+
+    Parameters
+    ----------
+    name : str
+        Name of the dataset to load. Use available_datasets() to see options.
+    use_real : bool, optional
+        If True, download and use real data (requires internet and disk space).
+        If False (default), generate lightweight stub data for testing.
+        Can also be controlled via PYCMOR_USE_REAL_TEST_DATA environment variable.
+    cache : bool, optional
+        If True (default), cache downloaded data locally for reuse.
+        Only relevant when use_real=True.
+    cache_dir : Path, optional
+        Directory for caching data. If not specified, uses the default cache
+        location (~/.cache/pycmor/test_data on Unix).
+        Only relevant when use_real=True.
+    **kwargs
+        Additional keyword arguments passed to xarray's open_mfdataset.
+
+    Returns
+    -------
+    xr.Dataset
+        The loaded dataset
+
+    Raises
+    ------
+    KeyError
+        If the dataset name is not recognized
+
+    Examples
+    --------
+    .. code-block:: python
+
+        import pycmor.tutorial as tutorial
+        ds = tutorial.open_dataset("fesom_2p6")
+
+        # Open with real data (downloads if not cached):
+        ds = tutorial.open_dataset("fesom_2p6", use_real=True)
+
+        # Pass additional xarray options:
+        ds = tutorial.open_dataset("fesom_2p6", chunks={"time": 1})
+
+    See Also
+    --------
+    available_datasets : List all available tutorial datasets
+    info : Get information about a dataset
+
+    Notes
+    -----
+    For real data, the first load will download and cache the data,
+    subsequent loads will use the cached version.
+    """
+    model_runs = _discover_model_runs()
+
+    if name not in model_runs:
+        available = ", ".join(available_datasets())
+        raise KeyError(
+            f"Dataset '{name}' not found. Available datasets: {available}. "
+            f"Use pycmor.tutorial.available_datasets() to see all options."
+        )
+
+    model_class = model_runs[name]
+
+    # Check environment variable if not explicitly set
+    if not use_real:
+        use_real = os.getenv("PYCMOR_USE_REAL_TEST_DATA", "").lower() in ("1", "true", "yes")
+
+    # Find the model's fixtures directory
+    import inspect
+
+    module_file = inspect.getfile(model_class)
+
+    if use_real:
+        # Use real data with caching
+        instance = model_class.from_module(module_file, use_real=True, tmp_path_factory=None)
+
+        # If cache_dir is specified, we could override the default cache location
+        # For now, we use the default cache location from the test infrastructure
+
+        # Access the dataset (triggers download and caching if needed)
+        return instance.open_mfdataset(**kwargs)
+    else:
+        # Use stub data - need to create a temporary directory
+        import tempfile
+
+        # Create a temp directory that persists for the session
+        # Users can clean this up, or it will be cleaned by OS
+        stub_root = Path(tempfile.gettempdir()) / "pycmor_tutorial_stubs"
+        stub_root.mkdir(parents=True, exist_ok=True)
+
+        stub_dir = stub_root / name
+
+        # Simple TempPathFactory substitute for tutorial use
+        class SimpleTempFactory:
+            """Minimal temp path factory for tutorial datasets."""
+
+            def __init__(self, base_dir: Path):
+                self.base_dir = base_dir
+
+            def mktemp(self, basename: str) -> Path:
+                """Create a temporary directory."""
+                temp_dir = self.base_dir / basename
+                temp_dir.mkdir(parents=True, exist_ok=True)
+                return temp_dir
+
+        tmp_factory = SimpleTempFactory(stub_dir)
+
+        instance = model_class.from_module(module_file, use_real=False, tmp_path_factory=tmp_factory)
+
+        return instance.open_mfdataset(**kwargs)
diff --git a/src/pycmor/tutorial/stub_generator.py b/src/pycmor/tutorial/stub_generator.py
new file mode 100644
index 00000000..c9a42c50
--- /dev/null
+++ b/src/pycmor/tutorial/stub_generator.py
@@ -0,0 +1,273 @@
+"""
+Runtime library for generating NetCDF files from YAML stub manifests.
+
+This module provides functions to create xarray Datasets and NetCDF files
+from YAML manifests, filling them with random data that matches the
+metadata specifications.
+"""
+
+from pathlib import Path
+from typing import Any, Dict
+
+import numpy as np
+import pandas as pd
+import xarray as xr
+import yaml
+
+
+def parse_dtype(dtype_str: str) -> np.dtype:
+    """
+    Parse a dtype string into a numpy dtype.
+
+    Parameters
+    ----------
+    dtype_str : str
+        Dtype string (e.g., "float32", "datetime64[ns]")
+
+    Returns
+    -------
+    np.dtype
+        Numpy dtype object
+    """
+    return np.dtype(dtype_str)
+
+
+def generate_random_data(shape: tuple, dtype: np.dtype, fill_value: Any = None) -> np.ndarray:
+    """
+    Generate random data with the specified shape and dtype.
+
+    Parameters
+    ----------
+    shape : tuple
+        Shape of the array
+    dtype : np.dtype
+        Data type
+    fill_value : Any, optional
+        Fill value to use for masked/missing data
+
+    Returns
+    -------
+    np.ndarray
+        Random data array
+    """
+    if dtype.kind in ("U", "S"):  # String types
+        return np.array(["stub_data"] * np.prod(shape)).reshape(shape)
+    elif dtype.kind == "M":  # Datetime
+        # Generate datetime range
+        start = pd.Timestamp("2000-01-01")
+        return pd.date_range(start, periods=np.prod(shape), freq="D").values.reshape(shape)
+    elif dtype.kind == "m":  # Timedelta
+        return np.arange(np.prod(shape), dtype=dtype).reshape(shape)
+    elif dtype.kind in ("f", "c"):  # Float or complex
+        data = np.random.randn(*shape).astype(dtype)
+        if fill_value is not None:
+            # Randomly mask some values
+            mask = np.random.rand(*shape) < 0.01  # 1% missing
+            data[mask] = fill_value
+        return data
+    elif dtype.kind in ("i", "u"):  # Integer
+        return np.random.randint(0, 100, size=shape, dtype=dtype)
+    elif dtype.kind == "b":  # Boolean
+        return np.random.rand(*shape) > 0.5
+    else:
+        # Default: zeros
+        return np.zeros(shape, dtype=dtype)
+
+
+def create_coordinate(coord_meta: Dict[str, Any], file_index: int = 0) -> xr.DataArray:
+    """
+    Create a coordinate DataArray from metadata.
+
+    Parameters
+    ----------
+    coord_meta : Dict[str, Any]
+        Coordinate metadata (dtype, dims, shape, attrs)
+    file_index : int, optional
+        Index of the file being generated (for varying time coordinates)
+
+    Returns
+    -------
+    xr.DataArray
+        Coordinate DataArray
+    """
+    dtype = parse_dtype(coord_meta["dtype"])
+    shape = tuple(coord_meta["shape"])
+    dims = coord_meta["dims"]
+
+    # Special handling for time coordinates
+    if "sample_value" in coord_meta:
+        # Use sample value to infer time range
+        # Handle out-of-range dates by using a default range with file_index offset
+        try:
+            sample = pd.Timestamp(coord_meta["sample_value"])
+            # For out-of-range dates, this will fail and we'll use fallback
+            data = pd.date_range(sample, periods=shape[0], freq="D").values
+        except (ValueError, pd.errors.OutOfBoundsDatetime):
+            # Fallback to a default date range, but offset by file_index to ensure uniqueness
+            # Parse the sample value to extract day offset if possible
+            import re
+
+            sample_str = coord_meta["sample_value"]
+            # Try to extract day from date string like "2686-01-02 00:00:00"
+            match = re.search(r"\d{4}-\d{2}-(\d{2})", sample_str)
+            if match:
+                day_offset = int(match.group(1)) - 1  # Day 1 -> offset 0, Day 2 -> offset 1
+            else:
+                day_offset = file_index
+
+            # Create time coordinate with unique offset
+            base = pd.Timestamp("2000-01-01")
+            start = base + pd.Timedelta(days=day_offset)
+            data = pd.date_range(start, periods=shape[0], freq="D").values
+    else:
+        # Generate random data
+        data = generate_random_data(shape, dtype)
+
+    coord = xr.DataArray(
+        data,
+        dims=dims,
+        attrs=coord_meta.get("attrs", {}),
+    )
+
+    return coord
+
+
+def create_variable(var_meta: Dict[str, Any], coords: Dict[str, xr.DataArray]) -> xr.DataArray:
+    """
+    Create a variable DataArray from metadata.
+
+    Parameters
+    ----------
+    var_meta : Dict[str, Any]
+        Variable metadata (dtype, dims, shape, attrs, fill_value)
+    coords : Dict[str, xr.DataArray]
+        Coordinate arrays
+
+    Returns
+    -------
+    xr.DataArray
+        Variable DataArray
+    """
+    dtype = parse_dtype(var_meta["dtype"])
+    shape = tuple(var_meta["shape"])
+    dims = var_meta["dims"]
+    fill_value = var_meta.get("fill_value")
+
+    # Generate random data
+    data = generate_random_data(shape, dtype, fill_value)
+
+    # Create variable
+    var = xr.DataArray(
+        data,
+        dims=dims,
+        coords={dim: coords[dim] for dim in dims if dim in coords},
+        attrs=var_meta.get("attrs", {}),
+    )
+
+    # Set fill value if present
+    if fill_value is not None:
+        var.attrs["_FillValue"] = fill_value
+
+    return var
+
+
+def create_dataset_from_metadata(metadata: Dict[str, Any], file_index: int = 0) -> xr.Dataset:
+    """
+    Create an xarray Dataset from metadata dictionary.
+
+    Parameters
+    ----------
+    metadata : Dict[str, Any]
+        Dataset metadata (dimensions, coordinates, variables, attrs)
+    file_index : int, optional
+        Index of the file being generated (for varying time coordinates)
+
+    Returns
+    -------
+    xr.Dataset
+        Generated Dataset with random data
+    """
+    # Create coordinates
+    coords = {}
+    for coord_name, coord_meta in metadata.get("coordinates", {}).items():
+        coords[coord_name] = create_coordinate(coord_meta, file_index)
+
+    # Create variables
+    data_vars = {}
+    for var_name, var_meta in metadata.get("variables", {}).items():
+        data_vars[var_name] = create_variable(var_meta, coords)
+
+    # Create dataset
+    ds = xr.Dataset(
+        data_vars=data_vars,
+        coords=coords,
+        attrs=metadata.get("attrs", {}),
+    )
+
+    return ds
+
+
+def load_manifest(manifest_file: Path) -> Dict[str, Any]:
+    """
+    Load a YAML stub manifest.
+
+    Parameters
+    ----------
+    manifest_file : Path
+        Path to YAML manifest file
+
+    Returns
+    -------
+    Dict[str, Any]
+        Manifest dictionary
+    """
+    with open(manifest_file, "r") as f:
+        manifest = yaml.safe_load(f)
+    return manifest
+
+
+def generate_stub_files(manifest_file: Path, output_dir: Path) -> Path:
+    """
+    Generate stub NetCDF files from a YAML manifest.
+
+    Parameters
+    ----------
+    manifest_file : Path
+        Path to YAML manifest file
+    output_dir : Path
+        Output directory for generated NetCDF files
+
+    Returns
+    -------
+    Path
+        Output directory containing generated files
+    """
+    # Load manifest
+    manifest = load_manifest(manifest_file)
+
+    print(f"Generating stub data from {manifest_file}")
+    print(f"Output directory: {output_dir}")
+
+    # Create output directory
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    # Generate each file
+    for file_index, file_meta in enumerate(manifest.get("files", [])):
+        file_path = Path(file_meta["path"])
+        output_path = output_dir / file_path
+
+        print(f"  Creating {file_path}...")
+
+        # Create output subdirectories
+        output_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Generate dataset with file index for unique time coordinates
+        ds = create_dataset_from_metadata(file_meta["dataset"], file_index)
+
+        # Write NetCDF
+        ds.to_netcdf(output_path)
+        ds.close()
+
+    print(f"✓ Generated {len(manifest.get('files', []))} stub files")
+
+    return output_dir
diff --git a/tests/configs/test_config_awicm_1p0_recom.yaml b/tests/configs/test_config_awicm_1p0_recom.yaml
index 33dc9b82..47aa3bf8 100644
--- a/tests/configs/test_config_awicm_1p0_recom.yaml
+++ b/tests/configs/test_config_awicm_1p0_recom.yaml
@@ -19,7 +19,7 @@ rules:
     experiment_id: "piControl"
     activity_id: "CMIP"
     output_directory: "./output"
-    source_id: "FESOM"
+    source_id: "AWI-ESM-1-1-LR"
     grid_label: gn
     variant_label: "r1i1p1f1"
     model_component: "ocean"
diff --git a/tests/configs/test_config_awicm_1p0_recom_cmip7.yaml b/tests/configs/test_config_awicm_1p0_recom_cmip7.yaml
index b6d8d501..a584b905 100644
--- a/tests/configs/test_config_awicm_1p0_recom_cmip7.yaml
+++ b/tests/configs/test_config_awicm_1p0_recom_cmip7.yaml
@@ -19,7 +19,7 @@ rules:
     experiment_id: "piControl"
     activity_id: "CMIP"
     output_directory: "./output"
-    source_id: "FESOM"
+    source_id: "AWI-ESM-1-1-LR"
     institution_id: "AWI"
     grid_label: gn
     variant_label: "r1i1p1f1"
diff --git a/tests/configs/test_config_cmip6.yaml b/tests/configs/test_config_cmip6.yaml
index 6f077917..b2f9b98b 100644
--- a/tests/configs/test_config_cmip6.yaml
+++ b/tests/configs/test_config_cmip6.yaml
@@ -36,6 +36,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: AWI-CM-1-1-HR
     model_component: ocean
     grid_label: gn
@@ -53,6 +54,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: AWI-CM-1-1-HR
     model_component: ocean
     grid_label: gn
@@ -62,6 +64,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: AWI-CM-1-1-HR
     model_component: ocean
     grid_label: gn
diff --git a/tests/configs/test_config_cmip7.yaml b/tests/configs/test_config_cmip7.yaml
index 1c17e79f..40123d45 100644
--- a/tests/configs/test_config_cmip7.yaml
+++ b/tests/configs/test_config_cmip7.yaml
@@ -37,6 +37,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: "AWI-CM-1-1-HR"
     model_component: ocean
     grid_label: gn
@@ -55,6 +56,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: "AWI-CM-1-1-HR"
     model_component: ocean
     grid_label: gn
@@ -65,6 +67,7 @@ rules:
     output_directory: .
     variant_label: r1i1p1f1
     experiment_id: piControl
+    activity_id: "CMIP"
     source_id: "AWI-CM-1-1-HR"
     model_component: ocean
     grid_label: gn
diff --git a/tests/configs/test_config_fesom_2p6_pimesh.yaml b/tests/configs/test_config_fesom_2p6_pimesh.yaml
deleted file mode 100644
index a25ed138..00000000
--- a/tests/configs/test_config_fesom_2p6_pimesh.yaml
+++ /dev/null
@@ -1,31 +0,0 @@
-pycmor:
-  warn_on_no_rule: False
-  parallel: False
-general:
-  name: "fesom_2p6_pimesh"
-  description: "This is a test configuration using esm-tools generated test data on PI Mesh"
-  maintainer: "pgierz"
-  email: "pgierz@awi.de"
-  cmor_version: "CMIP6"
-  mip: "CMIP"
-  frequency: "mon"
-  CMIP_Tables_Dir: "./cmip6-cmor-tables/Tables"
-  CV_Dir: "./cmip6-cmor-tables/CMIP6_CVs"
-rules:
-  - name: "temp"
-    experiment_id: "piControl"
-    output_directory: "./output"
-    source_id: "AWI-CM-1-1-HR"
-    model_component: "ocean"
-    grid_label: gn
-    variant_label: "r1i1p1f1"
-    inputs:
-      - path: "REPLACE_ME/outdata/fesom"
-        pattern: "temp.fesom..*.nc"
-    cmor_variable: "thetao"
-    model_variable: "temp"
-    sort_dimensions_missing_dims: "warn"
-    model_dim:
-      nz1: "olevel"
-      time: "longitude" # This is fake and knowingly wrong! Just for the test...
-      nod2: "latitude" # Also fake!
diff --git a/tests/configs/test_config_fesom_2p6_pimesh_cmip7.yaml b/tests/configs/test_config_fesom_2p6_pimesh_cmip7.yaml
deleted file mode 100644
index 378d43b7..00000000
--- a/tests/configs/test_config_fesom_2p6_pimesh_cmip7.yaml
+++ /dev/null
@@ -1,34 +0,0 @@
-pycmor:
-  warn_on_no_rule: False
-  parallel: False
-general:
-  name: "fesom_2p6_pimesh"
-  description: "This is a test configuration using esm-tools generated test data on PI Mesh"
-  maintainer: "pgierz"
-  email: "pgierz@awi.de"
-  cmor_version: "CMIP7"
-  mip: "CMIP"
-  frequency: "mon"
-  # CV_Dir is optional - uses ResourceLoader fallback chain
-  # CMIP_Tables_Dir is not needed for CMIP7 (uses packaged data)
-rules:
-  - name: "temp"
-    experiment_id: "piControl"
-    activity_id: "CMIP"
-    output_directory: "./output"
-    source_id: "AWI-CM-1-1-HR"
-    institution_id: "AWI"
-    model_component: "ocean"
-    grid_label: gn
-    variant_label: "r1i1p1f1"
-    inputs:
-      - path: "REPLACE_ME/outdata/fesom"
-        pattern: "temp.fesom..*.nc"
-    cmor_variable: "thetao"
-    compound_name: "Omon.thetao"
-    model_variable: "temp"
-    sort_dimensions_missing_dims: "warn"
-    model_dim:
-      nz1: "olevel"
-      time: "longitude" # This is fake and knowingly wrong! Just for the test...
-      nod2: "latitude" # Also fake!
diff --git a/tests/configs/test_config_pi_uxarray.yaml b/tests/configs/test_config_pi_uxarray.yaml
deleted file mode 100644
index 5819ec33..00000000
--- a/tests/configs/test_config_pi_uxarray.yaml
+++ /dev/null
@@ -1,31 +0,0 @@
-pycmor:
-  warn_on_no_rule: False
-  parallel: False
-general:
-  name: "pi_uxarray"
-  description: "This is a test configuration using the UXArray test data on PI Mesh"
-  maintainer: "pgierz"
-  email: "pgierz@awi.de"
-  cmor_version: "CMIP6"
-  mip: "CMIP"
-  frequency: "mon"
-  CMIP_Tables_Dir: "./cmip6-cmor-tables/Tables"
-  CV_Dir: "./cmip6-cmor-tables/CMIP6_CVs"
-rules:
-  - name: "temp"
-    experiment_id: "piControl"
-    output_directory: "./output"
-    source_id: "AWI-CM-1-1-HR"
-    variant_label: "r1i1p1f1"
-    inputs:
-      - path: "REPLACE_ME"
-        pattern: "temp.fesom..*.nc"
-    cmor_variable: "thetao"
-    model_variable: "temp"
-    model_component: ocean
-    grid_label: gn
-    sort_dimensions_missing_dims: "warn"
-    model_dim:
-      nz1: "olevel"
-      time: "longitude" # This is fake and knowingly wrong! Just for the test...
-      nod2: "latitude" # Also fake!
diff --git a/tests/configs/test_config_pi_uxarray_cmip7.yaml b/tests/configs/test_config_pi_uxarray_cmip7.yaml
deleted file mode 100644
index 815d4efd..00000000
--- a/tests/configs/test_config_pi_uxarray_cmip7.yaml
+++ /dev/null
@@ -1,28 +0,0 @@
-pycmor:
-  warn_on_no_rule: False
-  parallel: False
-general:
-  name: "pi_uxarray"
-  description: "This is a test configuration using the UXArray test data on PI Mesh"
-  maintainer: "pgierz"
-  email: "pgierz@awi.de"
-  cmor_version: "CMIP7"
-  mip: "CMIP"
-  frequency: "mon"
-  # CV_Dir is optional - uses ResourceLoader fallback chain
-  # CMIP_Tables_Dir is not needed for CMIP7 (uses packaged data)
-rules:
-  - name: "temp"
-    experiment_id: "piControl"
-    activity_id: "CMIP"
-    output_directory: "./output"
-    source_id: "AWI-CM-1-1-HR"
-    variant_label: "r1i1p1f1"
-    inputs:
-      - path: "REPLACE_ME"
-        pattern: "temp.fesom..*.nc"
-    cmor_variable: "thetao"
-    compound_name: "Omon.thetao"
-    model_variable: "temp"
-    model_component: ocean
-    grid_label: gn
diff --git a/tests/contrib/__init__.py b/tests/contrib/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/contrib/models/__init__.py b/tests/contrib/models/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/contrib/models/awicm_recom/__init__.py b/tests/contrib/models/awicm_recom/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/contrib/models/awicm_recom/fixtures/__init__.py b/tests/contrib/models/awicm_recom/fixtures/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/contrib/models/awicm_recom/fixtures/config.py b/tests/contrib/models/awicm_recom/fixtures/config.py
new file mode 100644
index 00000000..ba74530e
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/config.py
@@ -0,0 +1,47 @@
+"""Configuration fixtures for awicm_recom model."""
+
+import pytest
+
+
+@pytest.fixture
+def awicm_recom_model_run(tmp_path_factory, request):
+    """AWI-CM RECOM model run instance.
+
+    Returns
+    -------
+    AwicmRecomModelRun
+        Model run instance with data and config access
+    """
+    from tests.contrib.models.awicm_recom.fixtures.model import AwicmRecomModelRun
+
+    use_real = AwicmRecomModelRun.should_use_real_data(request)
+    return AwicmRecomModelRun.from_module(__file__, use_real=use_real, tmp_path_factory=tmp_path_factory)
+
+
+@pytest.fixture
+def awicm_recom_config_path(awicm_recom_model_run):
+    """Path to AWI-CM RECOM CMIP6 config file.
+
+    Returns
+    -------
+    Path
+        Path to config_cmip6.yaml
+    """
+    return awicm_recom_model_run.config_path_cmip6
+
+
+@pytest.fixture
+def awicm_recom_config_path_cmip7(awicm_recom_model_run):
+    """Path to AWI-CM RECOM CMIP7 config file.
+
+    Returns
+    -------
+    Path
+        Path to config_cmip7.yaml
+    """
+    return awicm_recom_model_run.config_path_cmip7
+
+
+# Legacy fixture names for backwards compatibility
+awicm_1p0_recom_config = awicm_recom_config_path
+awicm_1p0_recom_config_cmip7 = awicm_recom_config_path_cmip7
diff --git a/tests/contrib/models/awicm_recom/fixtures/config_cmip6.yaml b/tests/contrib/models/awicm_recom/fixtures/config_cmip6.yaml
new file mode 100644
index 00000000..70ea55d6
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/config_cmip6.yaml
@@ -0,0 +1,73 @@
+pycmor:
+  version: "unreleased"
+  use_xarray_backend: True
+  warn_on_no_rule: False
+  minimum_jobs: 8
+  maximum_jobs: 10
+general:
+  name: "fesom_2p6_pimesh"
+  description: "This is a test configuration using esm-tools generated test data on PI Mesh"
+  maintainer: "pgierz"
+  email: "pgierz@awi.de"
+  cmor_version: "CMIP6"
+  mip: "CMIP"
+  frequency: "mon"
+  CMIP_Tables_Dir: "./cmip6-cmor-tables/Tables"
+  CV_Dir: "./cmip6-cmor-tables/CMIP6_CVs"
+rules:
+  - name: "temp_with_levels"
+    experiment_id: "piControl"
+    activity_id: "CMIP"
+    output_directory: "./output"
+    source_id: "AWI-ESM-1-1-LR"
+    grid_label: gn
+    variant_label: "r1i1p1f1"
+    model_component: "ocean"
+    inputs:
+      - path: "{{ datadir }}/awi-esm-1-1-lr_kh800/piControl/outdata/fesom"
+        pattern: "thetao.fesom..*.nc"
+    cmor_variable: "thetao"
+    model_variable: "thetao"
+    mesh_path: "{{ datadir }}/awi-esm-1-1-lr_kh800/piControl/input/fesom/mesh"
+    pipelines:
+      - level_regridder
+pipelines:
+  - name: level_regridder
+    steps:
+      - pycmor.core.gather_inputs.load_mfdataset
+      - pycmor.std_lib.generic.get_variable
+      - pycmor.fesom_1p4.nodes_to_levels
+      - pycmor.core.caching.manual_checkpoint
+      - pycmor.std_lib.generic.trigger_compute
+      - pycmor.std_lib.generic.show_data
+distributed:
+  worker:
+    memory:
+      target: 0.6 # Target 60% of worker memory usage
+      spill: 0.7 # Spill to disk when 70% of memory is used
+      pause: 0.8 # Pause workers if memory usage exceeds 80%
+      terminate: 0.95 # Terminate workers at 95% memory usage
+    resources:
+      CPU: 4 # Assign 4 CPUs per worker
+    death-timeout: 60 # Worker timeout if no heartbeat (seconds)
+# SLURM-specific settings for launching workers
+jobqueue:
+  slurm:
+    queue: compute # SLURM queue/partition to submit jobs
+    project: ab0246 # SLURM project/account name
+    cores: 4 # Number of cores per worker
+    memory: 128GB # Memory per worker
+    walltime: '00:30:00' # Maximum walltime per job
+    # interface: ib0 # Network interface for communication
+    job-extra: # Additional SLURM job options
+      - '--exclusive' # Run on exclusive nodes
+    # How to launch workers and scheduler
+    worker-template:
+      # Command to launch a Dask worker via SLURM
+      command: |
+        srun --ntasks=1 --cpus-per-task=4 --mem=128G dask-worker \
+          --nthreads 4 --memory-limit 128GB --death-timeout 60
+    # Command to launch the Dask scheduler
+    scheduler-template:
+      command: |
+        srun --ntasks=1 --cpus-per-task=1 dask-scheduler
diff --git a/tests/contrib/models/awicm_recom/fixtures/config_cmip7.yaml b/tests/contrib/models/awicm_recom/fixtures/config_cmip7.yaml
new file mode 100644
index 00000000..4b5f5391
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/config_cmip7.yaml
@@ -0,0 +1,75 @@
+pycmor:
+  version: "unreleased"
+  use_xarray_backend: True
+  warn_on_no_rule: False
+  minimum_jobs: 8
+  maximum_jobs: 10
+general:
+  name: "fesom_2p6_pimesh"
+  description: "This is a test configuration using esm-tools generated test data on PI Mesh"
+  maintainer: "pgierz"
+  email: "pgierz@awi.de"
+  cmor_version: "CMIP7"
+  mip: "CMIP"
+  frequency: "mon"
+  # CV_Dir is optional - uses ResourceLoader fallback chain
+  # CMIP_Tables_Dir is not needed for CMIP7 (uses packaged data)
+rules:
+  - name: "temp_with_levels"
+    experiment_id: "piControl"
+    activity_id: "CMIP"
+    output_directory: "./output"
+    source_id: "AWI-ESM-1-1-LR"
+    institution_id: "AWI"
+    grid_label: gn
+    variant_label: "r1i1p1f1"
+    model_component: "ocean"
+    compound_name: "ocean.thetao.mean.mon.gn"
+    inputs:
+      - path: "{{ datadir }}/awi-esm-1-1-lr_kh800/piControl/outdata/fesom"
+        pattern: "thetao.fesom..*.nc"
+    cmor_variable: "thetao"
+    model_variable: "thetao"
+    mesh_path: "{{ datadir }}/awi-esm-1-1-lr_kh800/piControl/input/fesom/mesh"
+    pipelines:
+      - level_regridder
+pipelines:
+  - name: level_regridder
+    steps:
+      - pycmor.core.gather_inputs.load_mfdataset
+      - pycmor.std_lib.generic.get_variable
+      - pycmor.fesom_1p4.nodes_to_levels
+      - pycmor.core.caching.manual_checkpoint
+      - pycmor.std_lib.generic.trigger_compute
+      - pycmor.std_lib.generic.show_data
+distributed:
+  worker:
+    memory:
+      target: 0.6 # Target 60% of worker memory usage
+      spill: 0.7 # Spill to disk when 70% of memory is used
+      pause: 0.8 # Pause workers if memory usage exceeds 80%
+      terminate: 0.95 # Terminate workers at 95% memory usage
+    resources:
+      CPU: 4 # Assign 4 CPUs per worker
+    death-timeout: 60 # Worker timeout if no heartbeat (seconds)
+# SLURM-specific settings for launching workers
+jobqueue:
+  slurm:
+    queue: compute # SLURM queue/partition to submit jobs
+    project: ab0246 # SLURM project/account name
+    cores: 4 # Number of cores per worker
+    memory: 128GB # Memory per worker
+    walltime: '00:30:00' # Maximum walltime per job
+    # interface: ib0 # Network interface for communication
+    job-extra: # Additional SLURM job options
+      - '--exclusive' # Run on exclusive nodes
+    # How to launch workers and scheduler
+    worker-template:
+      # Command to launch a Dask worker via SLURM
+      command: |
+        srun --ntasks=1 --cpus-per-task=4 --mem=128G dask-worker \
+          --nthreads 4 --memory-limit 128GB --death-timeout 60
+    # Command to launch the Dask scheduler
+    scheduler-template:
+      command: |
+        srun --ntasks=1 --cpus-per-task=1 dask-scheduler
diff --git a/tests/contrib/models/awicm_recom/fixtures/datadir.py b/tests/contrib/models/awicm_recom/fixtures/datadir.py
new file mode 100644
index 00000000..25404ac3
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/datadir.py
@@ -0,0 +1,109 @@
+"""Data directory fixtures for AWI-CM 1.0 RECOM biogeochemistry model.
+
+This module provides fixtures for accessing AWI-CM RECOM model run data,
+using the BaseModelRun pattern for consistency across model contributions.
+"""
+
+import warnings
+
+import pytest
+
+from .model import AwicmRecomModelRun
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_model_run(request, tmp_path_factory):
+    """AWI-CM 1.0 RECOM model run instance.
+
+    This fixture creates an AwicmRecomModelRun instance that handles:
+    - Routing between real and stub data based on environment/markers
+    - Lazy-loading of data directories and datasets
+    - Caching of downloaded/generated resources
+
+    Returns
+    -------
+    AwicmRecomModelRun
+        Model run instance with data access
+    """
+    use_real = AwicmRecomModelRun.should_use_real_data(request)
+    return AwicmRecomModelRun.from_module(
+        __file__,
+        use_real=use_real,
+        tmp_path_factory=tmp_path_factory,
+    )
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_datadir(awicm_1p0_recom_model_run):
+    """Data directory for AWI-CM 1.0 RECOM.
+
+    Returns stub data by default, or real data if:
+    1. The PYCMOR_USE_REAL_TEST_DATA environment variable is set
+    2. The real_data pytest marker is present
+
+    Returns
+    -------
+    Path
+        Path to the data directory
+    """
+    return awicm_1p0_recom_model_run.datadir
+
+
+# Deprecated aliases for backward compatibility
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_real_datadir(tmp_path_factory):
+    """Deprecated: Use awicm_1p0_recom_model_run with use_real=True instead."""
+    warnings.warn(
+        "awicm_1p0_recom_real_datadir is deprecated, use awicm_1p0_recom_model_run",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    model_run = AwicmRecomModelRun.from_module(__file__, use_real=True, tmp_path_factory=tmp_path_factory)
+    return model_run.datadir
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_real_data(awicm_1p0_recom_real_datadir):
+    """Deprecated: Use awicm_1p0_recom_datadir instead."""
+    warnings.warn(
+        "awicm_1p0_recom_real_data is deprecated, use awicm_1p0_recom_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_real_datadir
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_stub_datadir(tmp_path_factory):
+    """Deprecated: Use awicm_1p0_recom_model_run with use_real=False instead."""
+    warnings.warn(
+        "awicm_1p0_recom_stub_datadir is deprecated, use awicm_1p0_recom_model_run",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    model_run = AwicmRecomModelRun.from_module(__file__, use_real=False, tmp_path_factory=tmp_path_factory)
+    return model_run.datadir
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_stub_data(awicm_1p0_recom_stub_datadir):
+    """Deprecated: Use awicm_1p0_recom_datadir instead."""
+    warnings.warn(
+        "awicm_1p0_recom_stub_data is deprecated, use awicm_1p0_recom_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_stub_datadir
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_data(awicm_1p0_recom_datadir):
+    """Deprecated: Use awicm_1p0_recom_datadir instead."""
+    warnings.warn(
+        "awicm_1p0_recom_data is deprecated, use awicm_1p0_recom_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_datadir
diff --git a/tests/contrib/models/awicm_recom/fixtures/datasets.py b/tests/contrib/models/awicm_recom/fixtures/datasets.py
new file mode 100644
index 00000000..cd07f338
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/datasets.py
@@ -0,0 +1,19 @@
+"""Dataset fixtures for AWI-CM 1.0 RECOM biogeochemistry model.
+
+This module provides xarray dataset fixtures that load AWI-CM RECOM data
+using the BaseModelRun pattern.
+"""
+
+import pytest
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_ds(awicm_1p0_recom_model_run):
+    """Open AWI-CM 1.0 RECOM dataset with xarray.
+
+    Returns
+    -------
+    xr.Dataset
+        Opened dataset from the model run
+    """
+    return awicm_1p0_recom_model_run.ds
diff --git a/tests/contrib/models/awicm_recom/fixtures/model.py b/tests/contrib/models/awicm_recom/fixtures/model.py
new file mode 100644
index 00000000..6b6e8af3
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/model.py
@@ -0,0 +1,10 @@
+"""AWI-CM 1.0 RECOM model run implementation.
+
+DEPRECATED: This module is kept for backward compatibility.
+New code should import from pycmor.tutorial.datasets.awicm_recom instead.
+"""
+
+# Re-export from new location for backward compatibility
+from pycmor.tutorial.datasets.awicm_recom import AwicmRecomModelRun  # noqa: F401
+
+__all__ = ["AwicmRecomModelRun"]
diff --git a/tests/contrib/models/awicm_recom/fixtures/registry.yaml b/tests/contrib/models/awicm_recom/fixtures/registry.yaml
new file mode 100644
index 00000000..90a2c14a
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/registry.yaml
@@ -0,0 +1,10 @@
+# Test data registry for AWI-CM 1.0 RECOM model
+#
+# This file defines remote test data files that can be downloaded
+# and cached by the test suite using pooch.
+
+awicm_1p0_recom.tar:
+  url: https://nextcloud.awi.de/s/DaQjtTS9xB7o7pL/download/awicm_1p0_recom.tar
+  sha256: null  # TODO: Add checksum for validation
+  description: AWI-CM 1.0 RECOM biogeochemistry test data
+  extract_dir: awicm_1p0_recom
diff --git a/tests/contrib/models/awicm_recom/fixtures/stub_manifest.yaml b/tests/contrib/models/awicm_recom/fixtures/stub_manifest.yaml
new file mode 100644
index 00000000..d1e07973
--- /dev/null
+++ b/tests/contrib/models/awicm_recom/fixtures/stub_manifest.yaml
@@ -0,0 +1,363 @@
+source_directory: /Users/pgierz/.cache/pycmor/test_data/awicm_1p0_recom/awicm_1p0_recom
+files:
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-02.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-02 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-03.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-03 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-04.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-04 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-05.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-05 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-06.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-06 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-07.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-07 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-08.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-08 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-09.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-09 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-10.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-10 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+  - path: awi-esm-1-1-lr_kh800/piControl/outdata/fesom/thetao_fesom_2686-01-11.nc
+    dataset:
+      dimensions:
+        time: 1
+        nodes_3d: 3668773
+      coordinates:
+        time:
+          dtype: object
+          dims:
+            - time
+          shape:
+            - 1
+          attrs:
+            standard_name: time
+            long_name: time
+            axis: T
+          sample_value: '2686-01-11 00:00:00'
+      variables:
+        thetao:
+          dtype: float32
+          dims:
+            - time
+            - nodes_3d
+          shape:
+            - 1
+            - 3668773
+          attrs:
+            units: degC
+            CDI_grid_type: unstructured
+            description: sea water potential temperature
+      attrs:
+        CDI: Climate Data Interface version 2.2.1 (https://mpimet.mpg.de/cdi)
+        Conventions: CF-1.6
+        output_schedule: 'unit: d first: 1 rate: 1'
+        history: 'Wed Nov 20 09:22:35 2024: cdo splitdate thetao_fesom_26860101.nc thetao_fesom_'
+        CDO: Climate Data Operators version 2.2.0 (https://mpimet.mpg.de/cdo)
+total_files: 10
diff --git a/tests/doctest_sanity_check.py b/tests/doctest_sanity_check.py
new file mode 100644
index 00000000..c46fbb3d
--- /dev/null
+++ b/tests/doctest_sanity_check.py
@@ -0,0 +1,50 @@
+"""
+Sanity check for doctest infrastructure.
+
+This module verifies that the doctest fixture setup in conftest.py is working correctly.
+"""
+
+import os
+import pathlib
+
+import yaml
+
+
+def test_doctest_infrastructure_core_config_get_inherit_section():
+    """
+    Test that doctest infrastructure is set up correctly.
+
+    In the CI environment, this test should work fine, as the relevant
+    config file is injected by pytest_configure in conftest.py.
+    """
+    xdg_config_home = pathlib.Path(os.environ["XDG_CONFIG_HOME"])
+    config_file = xdg_config_home / "pycmor" / "pycmor.yaml"
+
+    with open(config_file) as f:
+        cfg = yaml.safe_load(f)
+
+    # Verify the config file has the expected inherit section
+    assert "inherit" in cfg
+    assert cfg["inherit"]["source_id"] == "FESOM2"
+    assert cfg["inherit"]["experiment_id"] == "historical"
+
+
+def get_test_config():
+    """
+    Helper function for doctests to get the test config.
+
+    Examples
+    --------
+    >>> config = get_test_config()
+    >>> config['inherit']['source_id']
+    'FESOM2'
+    >>> config['inherit']['experiment_id']
+    'historical'
+    """
+    xdg_config_home = pathlib.Path(os.environ["XDG_CONFIG_HOME"])
+    config_file = xdg_config_home / "pycmor" / "pycmor.yaml"
+
+    with open(config_file) as f:
+        cfg = yaml.safe_load(f)
+
+    return cfg
diff --git a/tests/fixtures/CMIP_Tables_Dir.py b/tests/fixtures/CMIP_Tables_Dir.py
index 7b4b61d0..c27a01e4 100644
--- a/tests/fixtures/CMIP_Tables_Dir.py
+++ b/tests/fixtures/CMIP_Tables_Dir.py
@@ -1,13 +1,15 @@
 import pytest
 
-from tests.utils.constants import TEST_ROOT
-
 
 @pytest.fixture
 def CMIP_Tables_Dir():
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "data" / "cmip6-cmor-tables" / "Tables"
 
 
 @pytest.fixture
 def CMIP6_Oclim():
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "data" / "difmxybo2d" / "CMIP6_Oclim.json"
diff --git a/tests/fixtures/CV_Dir.py b/tests/fixtures/CV_Dir.py
index 747e7081..583b8ff6 100644
--- a/tests/fixtures/CV_Dir.py
+++ b/tests/fixtures/CV_Dir.py
@@ -1,8 +1,8 @@
 import pytest
 
-from tests.utils.constants import TEST_ROOT
-
 
 @pytest.fixture
 def CV_dir():
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "data" / "CV" / "CMIP6_CVs"
diff --git a/tests/fixtures/base_model_run.py b/tests/fixtures/base_model_run.py
new file mode 100644
index 00000000..01c3070a
--- /dev/null
+++ b/tests/fixtures/base_model_run.py
@@ -0,0 +1,10 @@
+"""Base class for model-specific test run fixtures.
+
+DEPRECATED: This module is kept for backward compatibility.
+New code should import from pycmor.tutorial.base_model_run instead.
+"""
+
+# Re-export from new location for backward compatibility
+from pycmor.tutorial.base_model_run import BaseModelRun  # noqa: F401
+
+__all__ = ["BaseModelRun"]
diff --git a/tests/fixtures/config_files.py b/tests/fixtures/config_files.py
index 278756e0..82b372d7 100644
--- a/tests/fixtures/config_files.py
+++ b/tests/fixtures/config_files.py
@@ -1,53 +1,39 @@
-import pytest
+"""Generic configuration file fixtures.
+
+Model-specific config fixtures have been moved to their respective
+model fixture modules in tests/contrib/models/<model>/fixtures/config.py
+"""
 
-from tests.utils.constants import TEST_ROOT
+import pytest
 
 
 @pytest.fixture
 def test_config():
+    """Generic test config file path."""
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "configs" / "test_config.yaml"
 
 
 @pytest.fixture
 def fesom_pi_mesh_config_file():
+    """FESOM PI mesh config file path (legacy)."""
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "configs/fesom_pi_mesh_run.yaml"
 
 
 @pytest.fixture
 def test_config_cmip6():
+    """Generic CMIP6 test config file path."""
+    from tests.utils.constants import TEST_ROOT
+
     return TEST_ROOT / "configs" / "test_config_cmip6.yaml"
 
 
 @pytest.fixture
 def test_config_cmip7():
-    return TEST_ROOT / "configs" / "test_config_cmip7.yaml"
-
-
-@pytest.fixture
-def pi_uxarray_config():
-    return TEST_ROOT / "configs" / "test_config_pi_uxarray.yaml"
-
-
-@pytest.fixture
-def pi_uxarray_config_cmip7():
-    return TEST_ROOT / "configs" / "test_config_pi_uxarray_cmip7.yaml"
+    """Generic CMIP7 test config file path."""
+    from tests.utils.constants import TEST_ROOT
 
-
-@pytest.fixture
-def fesom_2p6_pimesh_esm_tools_config():
-    return TEST_ROOT / "configs" / "test_config_fesom_2p6_pimesh.yaml"
-
-
-@pytest.fixture
-def awicm_1p0_recom_config():
-    return TEST_ROOT / "configs" / "test_config_awicm_1p0_recom.yaml"
-
-
-@pytest.fixture
-def awicm_1p0_recom_config_cmip7():
-    return TEST_ROOT / "configs" / "test_config_awicm_1p0_recom_cmip7.yaml"
-
-
-@pytest.fixture
-def fesom_2p6_pimesh_esm_tools_config_cmip7():
-    return TEST_ROOT / "configs" / "test_config_fesom_2p6_pimesh_cmip7.yaml"
+    return TEST_ROOT / "configs" / "test_config_cmip7.yaml"
diff --git a/tests/fixtures/configs.py b/tests/fixtures/configs.py
index a6bb191f..1fdcd91a 100644
--- a/tests/fixtures/configs.py
+++ b/tests/fixtures/configs.py
@@ -1,5 +1,4 @@
 import pytest
-import ruamel.yaml
 
 
 @pytest.fixture
@@ -42,5 +41,7 @@ def config_pattern_env_var_name_and_value():
 
 @pytest.fixture
 def fesom_pi_mesh_config(fesom_pi_mesh_config_file):
+    import ruamel.yaml
+
     yaml = ruamel.yaml.YAML()
     return yaml.load(fesom_pi_mesh_config_file.open())
diff --git a/tests/fixtures/data_requests.py b/tests/fixtures/data_requests.py
index 389075ba..ed25589c 100644
--- a/tests/fixtures/data_requests.py
+++ b/tests/fixtures/data_requests.py
@@ -1,10 +1,17 @@
 import pytest
 
-from pycmor.data_request.variable import CMIP7DataRequestVariable, DataRequestVariable
+from pycmor.data_request.variable import CMIP7DataRequestVariable
 
 
 @pytest.fixture
 def dr_sos():
+    """Fixture for ocean salinity DataRequestVariable.
+
+    Import is done inside the fixture to avoid pulling in heavy dependencies
+    during pytest collection phase.
+    """
+    from pycmor.data_request.variable import DataRequestVariable
+
     return DataRequestVariable(
         variable_id="sos",
         unit="0.001",
diff --git a/tests/fixtures/datasets.py b/tests/fixtures/datasets.py
index 0e2ca168..fa960c37 100644
--- a/tests/fixtures/datasets.py
+++ b/tests/fixtures/datasets.py
@@ -1,9 +1,16 @@
-import pytest
-import xarray as xr
+"""Fixtures for xarray datasets.
+
+Note: Heavy dependencies (xarray) are imported lazily inside fixtures
+to avoid slowing down test collection.
+"""
 
-from tests.utils.constants import TEST_ROOT
+import pytest
 
 
 @pytest.fixture
 def fesom_pi_sst_ds():
+    import xarray as xr
+
+    from tests.utils.constants import TEST_ROOT
+
     return xr.open_dataset(TEST_ROOT / "data/test_experiments/piControl_on_PI/output_pi/sst.fesom.1948.nc")
diff --git a/tests/fixtures/example_data/awicm_recom.py b/tests/fixtures/example_data/awicm_recom.py
index a3266f4e..88a38166 100644
--- a/tests/fixtures/example_data/awicm_recom.py
+++ b/tests/fixtures/example_data/awicm_recom.py
@@ -1,132 +1,44 @@
-"""Example data for the FESOM model."""
+"""Example data for AWI-CM 1.0 RECOM biogeochemistry model.
 
-import hashlib
+This module provides fixtures for both real downloaded data and lightweight
+stub data for testing.
+"""
+
+import logging
 import os
-import tarfile
 from pathlib import Path
 
 import pytest
-import requests
-
-from tests.fixtures.stub_generator import generate_stub_files
-
-URL = "https://nextcloud.awi.de/s/DaQjtTS9xB7o7pL/download/awicm_1p0_recom.tar"
-"""str : URL to download the example data from."""
-
-# Expected SHA256 checksum of the tar file (update this when data changes)
-# Set to None to skip validation
-EXPECTED_SHA256 = None
-"""str : Expected SHA256 checksum of the downloaded tar file."""
 
-PYCMOR_TEST_DATA_CACHE_DIR = Path(
-    os.getenv("PYCMOR_TEST_DATA_CACHE_DIR")
-    or Path(os.getenv("XDG_CACHE_HOME") or Path.home() / ".cache") / "pycmor" / "test_data"
-)
+logger = logging.getLogger(__name__)
 
 
-def verify_file_integrity(file_path, expected_sha256=None):
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_real_datadir():
     """
-    Verify file integrity using SHA256 checksum.
-
-    Parameters
-    ----------
-    file_path : Path
-        Path to the file to verify
-    expected_sha256 : str, optional
-        Expected SHA256 checksum. If None, verification is skipped.
+    Download and extract real AWI-CM 1.0 RECOM data using pooch.
 
     Returns
     -------
-    bool
-        True if file is valid, False otherwise
-    """
-    if expected_sha256 is None:
-        return True
-
-    sha256_hash = hashlib.sha256()
-    with open(file_path, "rb") as f:
-        for byte_block in iter(lambda: f.read(4096), b""):
-            sha256_hash.update(byte_block)
-
-    actual_sha256 = sha256_hash.hexdigest()
-    is_valid = actual_sha256 == expected_sha256
-
-    if not is_valid:
-        print(f"Checksum mismatch for {file_path}")
-        print(f"Expected: {expected_sha256}")
-        print(f"Got:      {actual_sha256}")
-
-    return is_valid
-
-
-@pytest.fixture(scope="session")
-def awicm_1p0_recom_download_data(tmp_path_factory):
-    # Use persistent cache in $HOME/.cache/pycmor instead of ephemeral /tmp
-    cache_dir = PYCMOR_TEST_DATA_CACHE_DIR
-    cache_dir.mkdir(parents=True, exist_ok=True)
-    data_path = cache_dir / "awicm_1p0_recom.tar"
-
-    # Check if cached file exists and is valid
-    if data_path.exists():
-        if verify_file_integrity(data_path, EXPECTED_SHA256):
-            print(f"Using cached data: {data_path}.")
-            return data_path
-        else:
-            print("Cached data is corrupted. Re-downloading...")
-            data_path.unlink()
-
-    # Download the file
-    print(f"Downloading test data from {URL}...")
-    try:
-        response = requests.get(URL, stream=True, timeout=30)
-        response.raise_for_status()
-    except requests.exceptions.RequestException as e:
-        error_msg = (
-            f"Failed to download test data from {URL}\n"
-            f"Error type: {type(e).__name__}\n"
-            f"Error details: {str(e)}\n"
-        )
-        if hasattr(e, "response") and e.response is not None:
-            error_msg += (
-                f"HTTP Status Code: {e.response.status_code}\n"
-                f"Response Headers: {dict(e.response.headers)}\n"
-                f"Response Content (first 500 chars): {e.response.text[:500]}\n"
-            )
-        print(error_msg)
-        raise RuntimeError(error_msg) from e
-
-    # Download with progress indication
-    total_size = int(response.headers.get("content-length", 0))
-    with open(data_path, "wb") as f:
-        if total_size == 0:
-            f.write(response.content)
-        else:
-            downloaded = 0
-            for chunk in response.iter_content(chunk_size=8192):
-                downloaded += len(chunk)
-                f.write(chunk)
-                if downloaded % (1024 * 1024) == 0:  # Print every MB
-                    print(f"Downloaded {downloaded / (1024 * 1024):.1f} MB / {total_size / (1024 * 1024):.1f} MB")
-
-    print(f"Data downloaded: {data_path}.")
-
-    # Verify the downloaded file
-    if not verify_file_integrity(data_path, EXPECTED_SHA256):
-        raise RuntimeError(f"Downloaded file {data_path} failed integrity check!")
-
-    return data_path
+    Path
+        Path to the extracted data directory
 
+    Notes
+    -----
+    This fixture includes validation to check for corrupted extractions
+    by attempting to open a known NetCDF file.
+    """
+    # Lazy import to avoid loading pooch during test collection
+    from tests.fixtures.example_data.data_fetcher import fetch_and_extract
 
-@pytest.fixture(scope="session")
-def awicm_1p0_recom_real_data(awicm_1p0_recom_download_data):
-    import shutil
+    data_dir = fetch_and_extract("awicm_1p0_recom.tar")
 
-    data_dir = Path(awicm_1p0_recom_download_data).parent / "awicm_1p0_recom"
+    # The tarball extracts to awicm_1p0_recom/awicm_1p0_recom
+    # Return the inner directory for consistency
     final_data_path = data_dir / "awicm_1p0_recom"
 
-    # Check if extraction already exists
-    if data_dir.exists():
-        # Verify one of the known problematic files exists and is valid
+    if final_data_path.exists():
+        # Verify one of the known files exists and is valid
         test_file = (
             final_data_path / "awi-esm-1-1-lr_kh800" / "piControl" / "outdata" / "fesom" / "thetao_fesom_2686-01-05.nc"
         )
@@ -136,33 +48,33 @@ def awicm_1p0_recom_real_data(awicm_1p0_recom_download_data):
                 import h5py
 
                 with h5py.File(test_file, "r"):
-                    print(f"Using cached extraction: {data_dir}.")
-                    print(f">>> RETURNING: {final_data_path}")
+                    logger.info(f"Validated extraction: {final_data_path}")
                     return final_data_path
             except (OSError, IOError) as e:
-                print(f"Cached extraction is corrupted ({e}). Re-extracting...")
-                shutil.rmtree(data_dir)
+                logger.warning(f"Test file may be corrupted ({e}), but proceeding anyway")
 
-    # Extract the tar file
-    print(f"Extracting test data to: {data_dir}...")
-    data_dir.mkdir(parents=True, exist_ok=True)
-    with tarfile.open(awicm_1p0_recom_download_data, "r") as tar:
-        tar.extractall(data_dir)
-    print(f"Data extracted to: {data_dir}.")
+    return final_data_path if final_data_path.exists() else data_dir
 
-    # List extracted files for debugging
-    for root, dirs, files in os.walk(data_dir):
-        print(f"Root: {root}")
-        for file in files:
-            print(f"File: {os.path.join(root, file)}")
 
-    print(f">>> RETURNING: {final_data_path}")
-    return final_data_path
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_real_data(awicm_1p0_recom_real_datadir):
+    """Deprecated: Use awicm_1p0_recom_real_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "awicm_1p0_recom_real_data is deprecated, use awicm_1p0_recom_real_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_real_datadir
 
 
 @pytest.fixture(scope="session")
-def awicm_1p0_recom_stub_data(tmp_path_factory):
+def awicm_1p0_recom_stub_datadir(tmp_path_factory):
     """Generate stub data from YAML manifest."""
+    # Lazy import to avoid loading numpy/xarray during test collection
+    from tests.fixtures.stub_generator import generate_stub_files
+
     manifest_file = Path(__file__).parent.parent / "stub_data" / "awicm_1p0_recom.yaml"
     output_dir = tmp_path_factory.mktemp("awicm_1p0_recom")
 
@@ -175,11 +87,24 @@ def awicm_1p0_recom_stub_data(tmp_path_factory):
     _create_minimal_mesh_files(mesh_dir)
 
     # Return the equivalent path structure that real data returns
-    # (should match what awicm_1p0_recom_real_data returns)
+    # (should match what awicm_1p0_recom_real_datadir returns)
     # The stub_dir contains awi-esm-1-1-lr_kh800/piControl/... structure
     return stub_dir
 
 
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_stub_data(awicm_1p0_recom_stub_datadir):
+    """Deprecated: Use awicm_1p0_recom_stub_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "awicm_1p0_recom_stub_data is deprecated, use awicm_1p0_recom_stub_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_stub_datadir
+
+
 def _create_minimal_mesh_files(mesh_dir: Path):
     """Create minimal FESOM mesh files for testing."""
     # nod2d.out: 2D nodes (lon, lat)
@@ -229,7 +154,7 @@ def _create_minimal_mesh_files(mesh_dir: Path):
 
 
 @pytest.fixture(scope="session")
-def awicm_1p0_recom_data(request):
+def awicm_1p0_recom_datadir(request):
     """Router fixture: return stub or real data based on marker/env var."""
     # Check for environment variable
     use_real = os.getenv("PYCMOR_USE_REAL_TEST_DATA", "").lower() in ("1", "true", "yes")
@@ -239,10 +164,23 @@ def awicm_1p0_recom_data(request):
         use_real = True
 
     if use_real:
-        print("Using real downloaded test data")
+        logger.info("Using real downloaded test data for awicm_1p0_recom")
         # Request real data fixture lazily
-        return request.getfixturevalue("awicm_1p0_recom_real_data")
+        return request.getfixturevalue("awicm_1p0_recom_real_datadir")
     else:
-        print("Using stub test data")
+        logger.info("Using stub test data for awicm_1p0_recom")
         # Request stub data fixture lazily
-        return request.getfixturevalue("awicm_1p0_recom_stub_data")
+        return request.getfixturevalue("awicm_1p0_recom_stub_datadir")
+
+
+@pytest.fixture(scope="session")
+def awicm_1p0_recom_data(awicm_1p0_recom_datadir):
+    """Deprecated: Use awicm_1p0_recom_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "awicm_1p0_recom_data is deprecated, use awicm_1p0_recom_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return awicm_1p0_recom_datadir
diff --git a/tests/fixtures/example_data/data_fetcher.py b/tests/fixtures/example_data/data_fetcher.py
new file mode 100644
index 00000000..8eba5138
--- /dev/null
+++ b/tests/fixtures/example_data/data_fetcher.py
@@ -0,0 +1,179 @@
+"""
+Centralized test data fetcher using pooch.
+
+This module provides utilities to download and cache test data files
+defined in test_data_registry.yaml.
+
+Environment variables:
+    PYCMOR_TEST_DATA_CACHE_DIR: Override the cache directory location.
+    PYCMOR_FORCE_REEXTRACT: Set to "1" to force re-extraction of cached
+        tarballs (useful when tarball contents or extraction logic change).
+"""
+
+import logging
+import os
+import shutil
+import sys
+import tarfile
+from pathlib import Path
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+
+def get_cache_dir() -> Path:
+    """Get the cache directory for test data."""
+    return Path(
+        os.getenv("PYCMOR_TEST_DATA_CACHE_DIR")
+        or Path(os.getenv("XDG_CACHE_HOME") or Path.home() / ".cache") / "pycmor" / "test_data"
+    )
+
+
+def load_registry(registry_path=None):
+    """Load the test data registry from YAML.
+
+    Parameters
+    ----------
+    registry_path : Path or str, optional
+        Path to a model-specific registry file. If not provided, uses the
+        default central registry at test_data_registry.yaml
+    """
+    if registry_path is None:
+        registry_file = Path(__file__).parent / "test_data_registry.yaml"
+    else:
+        registry_file = Path(registry_path)
+
+    with open(registry_file) as f:
+        return yaml.safe_load(f)
+
+
+def _should_force_reextract() -> bool:
+    """Check if forced re-extraction is requested via environment variable."""
+    return os.getenv("PYCMOR_FORCE_REEXTRACT", "").lower() in ("1", "true", "yes")
+
+
+def fetch_and_extract(filename: str, registry_path=None) -> Path:
+    """
+    Fetch and extract a test data tarball.
+
+    Uses pooch to download and cache the file, then extracts it.
+    The extracted directory is cached, so subsequent calls are fast.
+
+    Parameters
+    ----------
+    filename : str
+        Name of the tarball file (must exist in the registry)
+    registry_path : Path or str, optional
+        Path to a model-specific registry YAML file
+
+    Returns
+    -------
+    Path
+        Path to the extracted data directory
+
+    Examples
+    --------
+    >>> data_dir = fetch_and_extract("fesom_2p6_pimesh.tar")
+    >>> data_dir
+    /home/user/.cache/pycmor/test_data/fesom_2p6_pimesh
+    """
+    import pooch
+
+    registry = load_registry(registry_path)
+
+    if filename not in registry:
+        raise ValueError(f"Unknown test data file: {filename}. " f"Available files: {list(registry.keys())}")
+
+    entry = registry[filename]
+    url = entry.get("url")
+    checksum = entry.get("sha256")
+    extract_dir = entry.get("extract_dir", filename.replace(".tar", ""))
+
+    if url is None:
+        raise ValueError(f"URL not set for {filename}. " f"Please update test_data_registry.yaml")
+
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+
+    # Path where extracted data will be
+    extracted_path = cache_dir / extract_dir
+
+    # Force re-extraction if requested
+    if _should_force_reextract() and extracted_path.exists():
+        logger.info(f"PYCMOR_FORCE_REEXTRACT set, removing cached extraction: {extracted_path}")
+        shutil.rmtree(extracted_path)
+
+    # If already extracted, return it
+    if extracted_path.exists():
+        logger.info(f"Using cached extraction: {extracted_path}")
+        return extracted_path
+
+    # Download and extract
+    logger.info(f"Downloading and extracting {filename}...")
+
+    # Download the tarball with pooch (no extraction yet)
+    downloaded_path = pooch.retrieve(
+        url=url,
+        known_hash=f"sha256:{checksum}" if checksum else None,
+        path=cache_dir,
+        fname=filename,
+    )
+
+    # Extract manually to handle absolute symlinks in tarballs.
+    # Python 3.12+ default "data" filter rejects absolute symlink targets,
+    # so we use filter="tar" where available, otherwise no filter (pre-3.12).
+    extract_kwargs = {}
+    if sys.version_info >= (3, 12):
+        extract_kwargs["filter"] = "tar"
+
+    with tarfile.open(downloaded_path) as tar:
+        # Extract into cache_dir directly -- tarballs already contain
+        # the extract_dir as their top-level directory prefix
+        tar.extractall(path=cache_dir, **extract_kwargs)
+
+    logger.info(f"Data extracted to: {extracted_path}")
+    return extracted_path
+
+
+def fetch_tarball(filename: str, registry_path=None) -> Path:
+    """
+    Fetch a tarball without extracting it.
+
+    Parameters
+    ----------
+    filename : str
+        Name of the tarball file (must exist in the registry)
+    registry_path : Path or str, optional
+        Path to a model-specific registry YAML file
+
+    Returns
+    -------
+    Path
+        Path to the downloaded tarball
+    """
+    import pooch
+
+    registry = load_registry(registry_path)
+
+    if filename not in registry:
+        raise ValueError(f"Unknown test data file: {filename}. " f"Available files: {list(registry.keys())}")
+
+    entry = registry[filename]
+    url = entry.get("url")
+    checksum = entry.get("sha256")
+
+    if url is None:
+        raise ValueError(f"URL not set for {filename}. " f"Please update test_data_registry.yaml")
+
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+
+    downloaded_path = pooch.retrieve(
+        url=url,
+        known_hash=f"sha256:{checksum}" if checksum else None,
+        path=cache_dir,
+        fname=filename,
+    )
+
+    return Path(downloaded_path)
diff --git a/tests/fixtures/example_data/fesom_2p6_pimesh.py b/tests/fixtures/example_data/fesom_2p6_pimesh.py
index ae613b05..ed3a13f8 100644
--- a/tests/fixtures/example_data/fesom_2p6_pimesh.py
+++ b/tests/fixtures/example_data/fesom_2p6_pimesh.py
@@ -1,76 +1,60 @@
-"""Example data for the FESOM model."""
+"""Example data for the FESOM 2.6 PI mesh model.
 
+This module provides fixtures for both real downloaded data and lightweight
+stub data for testing.
+"""
+
+import logging
 import os
-import tarfile
 from pathlib import Path
 
 import pytest
-import requests
 
-from tests.fixtures.stub_generator import generate_stub_files
+logger = logging.getLogger(__name__)
 
-URL = "https://nextcloud.awi.de/s/AL2cFQx5xGE473S/download/fesom_2p6_pimesh.tar"
-"""str : URL to download the example data from."""
 
-PYCMOR_TEST_DATA_CACHE_DIR = Path(
-    os.getenv("PYCMOR_TEST_DATA_CACHE_DIR")
-    or Path(os.getenv("XDG_CACHE_HOME") or Path.home() / ".cache") / "pycmor" / "test_data"
-)
+@pytest.fixture(scope="session")
+def fesom_2p6_pimesh_esm_tools_real_datadir():
+    """
+    Download and extract real FESOM 2.6 PI mesh data using pooch.
 
+    Returns
+    -------
+    Path
+        Path to the extracted data directory
+    """
+    # Lazy import to avoid loading pooch during test collection
+    from tests.fixtures.example_data.data_fetcher import fetch_and_extract
 
-@pytest.fixture(scope="session")
-def fesom_2p6_esm_tools_download_data(tmp_path_factory):
-    # Use persistent cache in $HOME/.cache/pycmor instead of ephemeral /tmp
-    cache_dir = PYCMOR_TEST_DATA_CACHE_DIR
-    cache_dir.mkdir(parents=True, exist_ok=True)
-    data_path = cache_dir / "fesom_2p6_pimesh.tar"
-
-    if not data_path.exists():
-        print(f"Downloading test data from {URL}...")
-        try:
-            response = requests.get(URL, timeout=30)
-            response.raise_for_status()
-        except requests.exceptions.RequestException as e:
-            error_msg = (
-                f"Failed to download test data from {URL}\n"
-                f"Error type: {type(e).__name__}\n"
-                f"Error details: {str(e)}\n"
-            )
-            if hasattr(e, "response") and e.response is not None:
-                error_msg += (
-                    f"HTTP Status Code: {e.response.status_code}\n"
-                    f"Response Headers: {dict(e.response.headers)}\n"
-                    f"Response Content (first 500 chars): {e.response.text[:500]}\n"
-                )
-            print(error_msg)
-            raise RuntimeError(error_msg) from e
-
-        with open(data_path, "wb") as f:
-            f.write(response.content)
-        print(f"Data downloaded: {data_path}.")
-    else:
-        print(f"Using cached data: {data_path}.")
+    data_dir = fetch_and_extract("fesom_2p6_pimesh.tar")
 
-    return data_path
+    # The tarball extracts to fesom_2p6_pimesh/fesom_2p6_pimesh
+    # Return the inner directory for consistency
+    inner_dir = data_dir / "fesom_2p6_pimesh"
+    if inner_dir.exists():
+        return inner_dir
+    return data_dir
 
 
 @pytest.fixture(scope="session")
-def fesom_2p6_pimesh_esm_tools_real_data(fesom_2p6_esm_tools_download_data):
-    data_dir = Path(fesom_2p6_esm_tools_download_data).parent / "fesom_2p6_pimesh"
-    if not data_dir.exists():
-        with tarfile.open(fesom_2p6_esm_tools_download_data, "r") as tar:
-            tar.extractall(data_dir)
-        print(f"Data extracted to: {data_dir}.")
-    else:
-        print(f"Using cached extraction: {data_dir}.")
+def fesom_2p6_pimesh_esm_tools_real_data(fesom_2p6_pimesh_esm_tools_real_datadir):
+    """Deprecated: Use fesom_2p6_pimesh_esm_tools_real_datadir instead."""
+    import warnings
 
-    print(f">>> RETURNING: {data_dir / 'fesom_2p6_pimesh' }")
-    return data_dir / "fesom_2p6_pimesh"
+    warnings.warn(
+        "fesom_2p6_pimesh_esm_tools_real_data is deprecated, use fesom_2p6_pimesh_esm_tools_real_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return fesom_2p6_pimesh_esm_tools_real_datadir
 
 
 @pytest.fixture(scope="session")
-def fesom_2p6_pimesh_esm_tools_stub_data(tmp_path_factory):
+def fesom_2p6_pimesh_esm_tools_stub_datadir(tmp_path_factory):
     """Generate stub data from YAML manifest."""
+    # Lazy import to avoid loading numpy/xarray during test collection
+    from tests.fixtures.stub_generator import generate_stub_files
+
     manifest_file = Path(__file__).parent.parent / "stub_data" / "fesom_2p6_pimesh.yaml"
     output_dir = tmp_path_factory.mktemp("fesom_2p6_pimesh")
 
@@ -83,10 +67,23 @@ def fesom_2p6_pimesh_esm_tools_stub_data(tmp_path_factory):
     _create_minimal_mesh_files(mesh_dir)
 
     # Return the equivalent path structure that real data returns
-    # (should match what fesom_2p6_pimesh_esm_tools_real_data returns)
+    # (should match what fesom_2p6_pimesh_esm_tools_real_datadir returns)
     return stub_dir
 
 
+@pytest.fixture(scope="session")
+def fesom_2p6_pimesh_esm_tools_stub_data(fesom_2p6_pimesh_esm_tools_stub_datadir):
+    """Deprecated: Use fesom_2p6_pimesh_esm_tools_stub_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "fesom_2p6_pimesh_esm_tools_stub_data is deprecated, use fesom_2p6_pimesh_esm_tools_stub_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return fesom_2p6_pimesh_esm_tools_stub_datadir
+
+
 def _create_minimal_mesh_files(mesh_dir: Path):
     """Create minimal FESOM mesh files for testing."""
     # nod2d.out: 2D nodes (lon, lat)
@@ -136,7 +133,7 @@ def _create_minimal_mesh_files(mesh_dir: Path):
 
 
 @pytest.fixture(scope="session")
-def fesom_2p6_pimesh_esm_tools_data(request):
+def fesom_2p6_pimesh_esm_tools_datadir(request):
     """Router fixture: return stub or real data based on marker/env var."""
     # Check for environment variable
     use_real = os.getenv("PYCMOR_USE_REAL_TEST_DATA", "").lower() in ("1", "true", "yes")
@@ -146,8 +143,21 @@ def fesom_2p6_pimesh_esm_tools_data(request):
         use_real = True
 
     if use_real:
-        print("Using real downloaded test data")
-        return request.getfixturevalue("fesom_2p6_pimesh_esm_tools_real_data")
+        logger.info("Using real downloaded test data for fesom_2p6_pimesh")
+        return request.getfixturevalue("fesom_2p6_pimesh_esm_tools_real_datadir")
     else:
-        print("Using stub test data")
-        return request.getfixturevalue("fesom_2p6_pimesh_esm_tools_stub_data")
+        logger.info("Using stub test data for fesom_2p6_pimesh")
+        return request.getfixturevalue("fesom_2p6_pimesh_esm_tools_stub_datadir")
+
+
+@pytest.fixture(scope="session")
+def fesom_2p6_pimesh_esm_tools_data(fesom_2p6_pimesh_esm_tools_datadir):
+    """Deprecated: Use fesom_2p6_pimesh_esm_tools_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "fesom_2p6_pimesh_esm_tools_data is deprecated, use fesom_2p6_pimesh_esm_tools_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return fesom_2p6_pimesh_esm_tools_datadir
diff --git a/tests/fixtures/example_data/pi_uxarray.py b/tests/fixtures/example_data/pi_uxarray.py
index 3938ad50..85743494 100644
--- a/tests/fixtures/example_data/pi_uxarray.py
+++ b/tests/fixtures/example_data/pi_uxarray.py
@@ -1,80 +1,61 @@
-"""Example data for the FESOM model."""
+"""Example data for PI control UXarray tests.
 
+This module provides fixtures for both real downloaded data and lightweight
+stub data for testing, including both data files and mesh files.
+"""
+
+import logging
 import os
 import shutil
 import subprocess
-import tarfile
 from pathlib import Path
 
 import pytest
-import requests
-
-from tests.fixtures.stub_generator import generate_stub_files
 
-URL = "https://nextcloud.awi.de/s/o2YQy2i9BR97Rge/download/pi_uxarray.tar"
-"""str : URL to download the example data from."""
+logger = logging.getLogger(__name__)
 
 MESH_GIT_REPO = "https://gitlab.awi.de/fesom/pi"
 """str : Git repository URL for the FESOM PI mesh data."""
 
-PYCMOR_TEST_DATA_CACHE_DIR = Path(
-    os.getenv("PYCMOR_TEST_DATA_CACHE_DIR")
-    or Path(os.getenv("XDG_CACHE_HOME") or Path.home() / ".cache") / "pycmor" / "test_data"
-)
-
 
 @pytest.fixture(scope="session")
-def pi_uxarray_download_data(tmp_path_factory):
-    # Use persistent cache in $HOME/.cache/pycmor instead of ephemeral /tmp
-    cache_dir = PYCMOR_TEST_DATA_CACHE_DIR
-    cache_dir.mkdir(parents=True, exist_ok=True)
-    data_path = cache_dir / "pi_uxarray.tar"
-
-    if not data_path.exists():
-        print(f"Downloading test data from {URL}...")
-        try:
-            response = requests.get(URL, timeout=30)
-            response.raise_for_status()
-        except requests.exceptions.RequestException as e:
-            error_msg = (
-                f"Failed to download test data from {URL}\n"
-                f"Error type: {type(e).__name__}\n"
-                f"Error details: {str(e)}\n"
-            )
-            if hasattr(e, "response") and e.response is not None:
-                error_msg += (
-                    f"HTTP Status Code: {e.response.status_code}\n"
-                    f"Response Headers: {dict(e.response.headers)}\n"
-                    f"Response Content (first 500 chars): {e.response.text[:500]}\n"
-                )
-            print(error_msg)
-            raise RuntimeError(error_msg) from e
-
-        with open(data_path, "wb") as f:
-            f.write(response.content)
-        print(f"Data downloaded: {data_path}.")
-    else:
-        print(f"Using cached data: {data_path}.")
+def pi_uxarray_real_datadir():
+    """
+    Download and extract real PI control UXarray data using pooch.
 
-    return data_path
+    Returns
+    -------
+    Path
+        Path to the extracted data directory
+    """
+    # Lazy import to avoid loading pooch during test collection
+    from tests.fixtures.example_data.data_fetcher import fetch_and_extract
 
+    return fetch_and_extract("pi_uxarray.tar")
 
-@pytest.fixture(scope="session")
-def pi_uxarray_real_data(pi_uxarray_download_data):
 
-    data_dir = Path(pi_uxarray_download_data).parent
-    with tarfile.open(pi_uxarray_download_data, "r") as tar:
-        tar.extractall(data_dir)
+@pytest.fixture(scope="session")
+def pi_uxarray_real_data(pi_uxarray_real_datadir):
+    """Deprecated: Use pi_uxarray_real_datadir instead."""
+    import warnings
 
-    return data_dir / "pi_uxarray"
+    warnings.warn(
+        "pi_uxarray_real_data is deprecated, use pi_uxarray_real_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_real_datadir
 
 
 @pytest.fixture(scope="session")
-def pi_uxarray_stub_data(tmp_path_factory):
+def pi_uxarray_stub_datadir(tmp_path_factory):
     """
     Generate stub data for pi_uxarray from YAML manifest.
     Returns the data directory containing generated NetCDF files.
     """
+    # Lazy import to avoid loading numpy/xarray during test collection
+    from tests.fixtures.stub_generator import generate_stub_files
+
     # Create temporary directory for stub data
     stub_dir = tmp_path_factory.mktemp("pi_uxarray_stub")
 
@@ -88,7 +69,20 @@ def pi_uxarray_stub_data(tmp_path_factory):
 
 
 @pytest.fixture(scope="session")
-def pi_uxarray_data(request):
+def pi_uxarray_stub_data(pi_uxarray_stub_datadir):
+    """Deprecated: Use pi_uxarray_stub_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "pi_uxarray_stub_data is deprecated, use pi_uxarray_stub_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_stub_datadir
+
+
+@pytest.fixture(scope="session")
+def pi_uxarray_datadir(request):
     """
     Router fixture that returns stub data by default, or real data if:
     1. The PYCMOR_USE_REAL_TEST_DATA environment variable is set
@@ -102,11 +96,24 @@ def pi_uxarray_data(request):
         use_real = True
 
     if use_real:
-        print("Using REAL data for pi_uxarray")
-        return request.getfixturevalue("pi_uxarray_real_data")
+        logger.info("Using real data for pi_uxarray")
+        return request.getfixturevalue("pi_uxarray_real_datadir")
     else:
-        print("Using STUB data for pi_uxarray")
-        return request.getfixturevalue("pi_uxarray_stub_data")
+        logger.info("Using stub data for pi_uxarray")
+        return request.getfixturevalue("pi_uxarray_stub_datadir")
+
+
+@pytest.fixture(scope="session")
+def pi_uxarray_data(pi_uxarray_datadir):
+    """Deprecated: Use pi_uxarray_datadir instead."""
+    import warnings
+
+    warnings.warn(
+        "pi_uxarray_data is deprecated, use pi_uxarray_datadir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_datadir
 
 
 @pytest.fixture(scope="session")
@@ -115,17 +122,19 @@ def pi_uxarray_download_mesh(tmp_path_factory):
     Clone FESOM PI mesh from GitLab using git-lfs.
     Uses persistent cache in $HOME/.cache/pycmor instead of ephemeral /tmp.
     """
+    from tests.fixtures.example_data.data_fetcher import get_cache_dir
+
     # Use persistent cache in $HOME/.cache/pycmor instead of ephemeral /tmp
-    cache_dir = PYCMOR_TEST_DATA_CACHE_DIR
+    cache_dir = get_cache_dir()
     cache_dir.mkdir(parents=True, exist_ok=True)
     mesh_dir = cache_dir / "pi_mesh_git"
 
     if mesh_dir.exists() and (mesh_dir / ".git").exists():
-        print(f"Using cached git mesh repository: {mesh_dir}")
+        logger.info(f"Using cached git mesh repository: {mesh_dir}")
         return mesh_dir
 
     # Clone the repository with git-lfs
-    print(f"Cloning FESOM PI mesh from {MESH_GIT_REPO}...")
+    logger.info(f"Cloning FESOM PI mesh from {MESH_GIT_REPO}...")
     try:
         # Check if git-lfs is available
         result = subprocess.run(["git", "lfs", "version"], capture_output=True, text=True, timeout=10, check=False)
@@ -153,10 +162,10 @@ def pi_uxarray_download_mesh(tmp_path_factory):
                 f"Git error: {result.stderr}\n"
                 f"Git output: {result.stdout}\n"
             )
-            print(error_msg)
+            logger.error(error_msg)
             raise RuntimeError(error_msg)
 
-        print(f"Mesh repository cloned to: {mesh_dir}")
+        logger.info(f"Mesh repository cloned to: {mesh_dir}")
     except subprocess.TimeoutExpired as e:
         raise RuntimeError(f"Git clone timed out after {e.timeout} seconds") from e
     except FileNotFoundError as e:
@@ -166,17 +175,33 @@ def pi_uxarray_download_mesh(tmp_path_factory):
 
 
 @pytest.fixture(scope="session")
-def pi_uxarray_real_mesh(pi_uxarray_download_mesh):
+def pi_uxarray_real_meshdir(pi_uxarray_download_mesh):
     """Return the cloned git repository directory containing FESOM PI mesh files."""
     return pi_uxarray_download_mesh
 
 
 @pytest.fixture(scope="session")
-def pi_uxarray_stub_mesh(tmp_path_factory):
+def pi_uxarray_real_mesh(pi_uxarray_real_meshdir):
+    """Deprecated: Use pi_uxarray_real_meshdir instead."""
+    import warnings
+
+    warnings.warn(
+        "pi_uxarray_real_mesh is deprecated, use pi_uxarray_real_meshdir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_real_meshdir
+
+
+@pytest.fixture(scope="session")
+def pi_uxarray_stub_meshdir(tmp_path_factory):
     """
     Generate stub mesh for pi_uxarray from YAML manifest.
     Returns the mesh directory containing fesom.mesh.diag.nc.
     """
+    # Lazy import to avoid loading numpy/xarray during test collection
+    from tests.fixtures.stub_generator import generate_stub_files
+
     # Create temporary directory for stub mesh
     stub_dir = tmp_path_factory.mktemp("pi_uxarray_stub_mesh")
 
@@ -193,6 +218,19 @@ def pi_uxarray_stub_mesh(tmp_path_factory):
     return stub_dir
 
 
+@pytest.fixture(scope="session")
+def pi_uxarray_stub_mesh(pi_uxarray_stub_meshdir):
+    """Deprecated: Use pi_uxarray_stub_meshdir instead."""
+    import warnings
+
+    warnings.warn(
+        "pi_uxarray_stub_mesh is deprecated, use pi_uxarray_stub_meshdir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_stub_meshdir
+
+
 def _create_minimal_mesh_files(mesh_dir: Path):
     """Create minimal FESOM mesh files for testing."""
     # nod2d.out: 2D nodes (lon, lat)
@@ -242,7 +280,7 @@ def _create_minimal_mesh_files(mesh_dir: Path):
 
 
 @pytest.fixture(scope="session")
-def pi_uxarray_mesh(request):
+def pi_uxarray_meshdir(request):
     """
     Router fixture that returns stub mesh by default, or real mesh if:
     1. The PYCMOR_USE_REAL_TEST_DATA environment variable is set
@@ -256,8 +294,21 @@ def pi_uxarray_mesh(request):
         use_real = True
 
     if use_real:
-        print("Using REAL mesh for pi_uxarray")
-        return request.getfixturevalue("pi_uxarray_real_mesh")
+        logger.info("Using real mesh for pi_uxarray")
+        return request.getfixturevalue("pi_uxarray_real_meshdir")
     else:
-        print("Using STUB mesh for pi_uxarray")
-        return request.getfixturevalue("pi_uxarray_stub_mesh")
+        logger.info("Using stub mesh for pi_uxarray")
+        return request.getfixturevalue("pi_uxarray_stub_meshdir")
+
+
+@pytest.fixture(scope="session")
+def pi_uxarray_mesh(pi_uxarray_meshdir):
+    """Deprecated: Use pi_uxarray_meshdir instead."""
+    import warnings
+
+    warnings.warn(
+        "pi_uxarray_mesh is deprecated, use pi_uxarray_meshdir",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return pi_uxarray_meshdir
diff --git a/tests/fixtures/example_data/test_data_registry.yaml b/tests/fixtures/example_data/test_data_registry.yaml
new file mode 100644
index 00000000..e8a2751e
--- /dev/null
+++ b/tests/fixtures/example_data/test_data_registry.yaml
@@ -0,0 +1,32 @@
+# Test data registry for pycmor
+#
+# This file defines all remote test data files that can be downloaded
+# and cached by the test suite using pooch.
+#
+# Each entry represents a tarball containing directory structures
+# exactly as they appear on the HPC systems.
+#
+# Format:
+#   filename:
+#     url: <download URL>
+#     sha256: <checksum or null>
+#     description: <human-readable description>
+#     extract_dir: <directory name after extraction>
+
+fesom_2p6_pimesh.tar:
+  url: https://nextcloud.awi.de/s/AL2cFQx5xGE473S/download/fesom_2p6_pimesh.tar
+  sha256: null  # TODO: Add checksum for validation
+  description: FESOM 2.6 PI mesh test data with ocean output
+  extract_dir: fesom_2p6_pimesh
+
+awicm_1p0_recom.tar:
+  url: https://nextcloud.awi.de/s/DaQjtTS9xB7o7pL/download/awicm_1p0_recom.tar
+  sha256: null  # TODO: Add checksum for validation
+  description: AWI-CM 1.0 RECOM biogeochemistry test data
+  extract_dir: awicm_1p0_recom
+
+pi_uxarray.tar:
+  url: https://nextcloud.awi.de/s/o2YQy2i9BR97Rge/download/pi_uxarray.tar
+  sha256: null
+  description: PI control UXarray test data
+  extract_dir: pi_uxarray
diff --git a/tests/fixtures/fake_data/fesom_mesh.py b/tests/fixtures/fake_data/fesom_mesh.py
index 62d7a9e9..a0ece3ee 100644
--- a/tests/fixtures/fake_data/fesom_mesh.py
+++ b/tests/fixtures/fake_data/fesom_mesh.py
@@ -1,6 +1,4 @@
-import numpy as np
 import pytest
-import xarray as xr
 
 
 def make_fake_grid():
@@ -9,6 +7,9 @@ def make_fake_grid():
     The dimension lengths are made up to reduce the size. Dummy values are used for variables.
     The purpose of this fake grid is just to test the setgrid functionality.
     """
+    import numpy as np
+    import xarray as xr
+
     # dimensions
     ncells = 100
     vertices = 18
diff --git a/tests/fixtures/filecache.py b/tests/fixtures/filecache.py
index dd75427b..43223258 100644
--- a/tests/fixtures/filecache.py
+++ b/tests/fixtures/filecache.py
@@ -1,19 +1,23 @@
-"""Fixtures for filecache tests."""
+"""Fixtures for filecache tests.
+
+Note: Heavy dependencies (numpy, pandas, xarray) are imported lazily inside
+fixtures to avoid slowing down test collection and unrelated test runs.
+"""
 
 import os
 import tempfile
 
-import numpy as np
-import pandas as pd
 import pytest
-import xarray as xr
-
-from pycmor.core.filecache import Filecache
 
 
 @pytest.fixture
 def sample_netcdf_file():
     """Create a temporary NetCDF file for testing."""
+    # Lazy imports to avoid loading heavy dependencies during test collection
+    import numpy as np
+    import pandas as pd
+    import xarray as xr
+
     with tempfile.NamedTemporaryFile(suffix=".nc", delete=False) as tmp:
         # Create sample data
         time = pd.date_range("2000-01-01", periods=12, freq="ME")
@@ -48,12 +52,16 @@ def sample_netcdf_file():
 @pytest.fixture
 def empty_filecache():
     """Create an empty filecache instance."""
+    from pycmor.core.filecache import Filecache
+
     return Filecache()
 
 
 @pytest.fixture
 def sample_cache_data():
     """Create sample cache data for testing."""
+    import pandas as pd
+
     return pd.DataFrame(
         {
             "variable": ["temperature", "precipitation"],
diff --git a/tests/fixtures/sample_rules.py b/tests/fixtures/sample_rules.py
index ffdfc410..cf2a2730 100644
--- a/tests/fixtures/sample_rules.py
+++ b/tests/fixtures/sample_rules.py
@@ -1,17 +1,19 @@
-import pytest
+"""Fixtures for Rule objects and related test data.
+
+Note: All pycmor imports are done lazily inside fixtures to avoid pulling in
+heavy dependencies during pytest collection phase. This prevents import errors
+when dependencies like 'deprecation' are not available in minimal test environments.
+"""
 
-from pycmor.core.aux_files import AuxiliaryFile
-from pycmor.core.config import PycmorConfigManager
-from pycmor.core.controlled_vocabularies import ControlledVocabularies
-from pycmor.core.factory import create_factory
-from pycmor.core.rule import Rule
-from pycmor.data_request.collection import CMIP6DataRequest
-from pycmor.data_request.table import CMIP6DataRequestTable
-from pycmor.data_request.variable import CMIP6DataRequestVariable
+import pytest
 
 
 @pytest.fixture
-def fesom_2p6_esmtools_temp_rule(fesom_2p6_pimesh_esm_tools_data):
+def fesom_2p6_esmtools_temp_rule(fesom_2p6_pimesh_esm_tools_datadir):
+    """Rule object for FESOM 2.6 temperature using new datadir fixture."""
+    from pycmor.core.config import PycmorConfigManager
+    from pycmor.core.rule import Rule
+
     pycmor_config = PycmorConfigManager.from_pycmor_cfg({})
     return Rule.from_dict(
         {
@@ -24,7 +26,7 @@ def fesom_2p6_esmtools_temp_rule(fesom_2p6_pimesh_esm_tools_data):
             "variant_label": "r1i1p1f1",
             "inputs": [
                 {
-                    "path": fesom_2p6_pimesh_esm_tools_data / "outdata/fesom",
+                    "path": fesom_2p6_pimesh_esm_tools_datadir / "outdata/fesom",
                     "pattern": "temp.fesom..*.nc",
                 },
             ],
@@ -37,13 +39,16 @@ def fesom_2p6_esmtools_temp_rule(fesom_2p6_pimesh_esm_tools_data):
 
 @pytest.fixture
 def fesom_2p6_esmtools_temp_rule_without_data():
+    from pycmor.core.config import PycmorConfigManager
+    from pycmor.core.rule import Rule
+
     pycmor_config = PycmorConfigManager.from_pycmor_cfg({})
     return Rule.from_dict(
         {
             "name": "temp",
             "experiment_id": "piControl",
             "output_directory": "./output",
-            "source_id": "FESOM",
+            "source_id": "AWI-ESM-1-1-LR",
             "variant_label": "r1i1p1f1",
             "inputs": [
                 {
@@ -59,7 +64,11 @@ def fesom_2p6_esmtools_temp_rule_without_data():
 
 
 @pytest.fixture
-def pi_uxarray_temp_rule(pi_uxarray_data):
+def pi_uxarray_temp_rule(pi_uxarray_datadir):
+    """Rule object for PI UXarray temperature using new datadir fixture."""
+    from pycmor.core.config import PycmorConfigManager
+    from pycmor.core.rule import Rule
+
     pycmor_config = PycmorConfigManager.from_pycmor_cfg({})
     return Rule.from_dict(
         {
@@ -72,7 +81,7 @@ def pi_uxarray_temp_rule(pi_uxarray_data):
             "variant_label": "r1i1p1f1",
             "inputs": [
                 {
-                    "path": pi_uxarray_data,
+                    "path": pi_uxarray_datadir,
                     "pattern": "temp.fesom..*.nc",
                 },
             ],
@@ -85,6 +94,9 @@ def pi_uxarray_temp_rule(pi_uxarray_data):
 
 @pytest.fixture
 def simple_rule():
+    from pycmor.core.config import PycmorConfigManager
+    from pycmor.core.rule import Rule
+
     r = Rule(
         inputs=[
             {
@@ -105,6 +117,9 @@ def simple_rule():
 
 @pytest.fixture
 def rule_with_mass_units():
+    from pycmor.core.rule import Rule
+    from pycmor.data_request.variable import CMIP6DataRequestVariable
+
     r = Rule(
         inputs=[
             {
@@ -152,6 +167,9 @@ def rule_with_mass_units():
 
 @pytest.fixture
 def rule_with_data_request():
+    from pycmor.core.rule import Rule
+    from pycmor.data_request.variable import CMIP6DataRequestVariable
+
     r = Rule(
         name="temp",
         source_id="AWI-CM-1-1-HR",
@@ -201,6 +219,9 @@ def rule_with_data_request():
 
 @pytest.fixture
 def rule_with_unsorted_data():
+    from pycmor.core.rule import Rule
+    from pycmor.data_request.variable import CMIP6DataRequestVariable
+
     r = Rule(
         array_order=["time", "lat", "lon"],
         inputs=[
@@ -261,6 +282,7 @@ def dummy_array():
 
 @pytest.fixture
 def rule_sos():
+    from pycmor.core.rule import Rule
     from tests.utils.constants import TEST_ROOT
 
     sos_path = TEST_ROOT / "data" / "dummy_data"
@@ -272,13 +294,19 @@ def rule_sos():
 
 @pytest.fixture
 def rule_after_cmip6_cmorizer_init(tmp_path, CMIP_Tables_Dir, CV_dir):
+    from pycmor.core.aux_files import AuxiliaryFile
+    from pycmor.core.controlled_vocabularies import ControlledVocabularies
+    from pycmor.core.factory import create_factory
+    from pycmor.core.rule import Rule
+    from pycmor.data_request.collection import CMIP6DataRequest
+    from pycmor.data_request.table import CMIP6DataRequestTable
+
     # Slimmed down version of what the CMORizer does.
     # This is somewhat of an integration test by itself.
     #
     # `inputs` requires:
     #  - concrete `path` to exist
     #  - a file to exist matching the `pattern`
-
     # Set the temporary directory and nc file
     d = tmp_path / "inputs"
     d.mkdir(exist_ok=True)
diff --git a/tests/integration/test_awicm_recom.py b/tests/integration/test_awicm_recom.py
deleted file mode 100644
index d145bdd6..00000000
--- a/tests/integration/test_awicm_recom.py
+++ /dev/null
@@ -1,32 +0,0 @@
-import pytest
-import yaml
-
-from pycmor.core.cmorizer import CMORizer
-from pycmor.core.logging import logger
-
-
-@pytest.mark.parametrize(
-    "config_fixture",
-    [
-        pytest.param("awicm_1p0_recom_config", id="CMIP6"),
-        pytest.param("awicm_1p0_recom_config_cmip7", id="CMIP7"),
-    ],
-)
-def test_process(config_fixture, awicm_1p0_recom_data, request):
-    config = request.getfixturevalue(config_fixture)
-    logger.info(f"Processing {config}")
-    with open(config, "r") as f:
-        cfg = yaml.safe_load(f)
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace(
-                "REPLACE_ME",
-                str(f"{awicm_1p0_recom_data}/awi-esm-1-1-lr_kh800/piControl/"),
-            )
-        if "mesh_path" in rule:
-            rule["mesh_path"] = rule["mesh_path"].replace(
-                "REPLACE_ME",
-                str(f"{awicm_1p0_recom_data}/awi-esm-1-1-lr_kh800/piControl/"),
-            )
-    cmorizer = CMORizer.from_dict(cfg)
-    cmorizer.process()
diff --git a/tests/integration/test_cli_process.py b/tests/integration/test_cli_process.py
new file mode 100644
index 00000000..0baf2c17
--- /dev/null
+++ b/tests/integration/test_cli_process.py
@@ -0,0 +1,135 @@
+"""CLI integration tests for pycmor process command.
+
+This module tests the CLI interface (`pycmor process`) for all registered
+model runs with both CMIP6 and CMIP7 configurations. Tests are organized
+as a matrix of [model] x [cmip_version].
+"""
+
+import subprocess
+from pathlib import Path
+
+import pytest
+import yaml
+from jinja2 import Template
+
+from tests.utils.entry_points import discover_model_runs
+
+# Discover all registered model runs
+MODEL_RUNS = discover_model_runs()
+MODEL_NAMES = sorted(MODEL_RUNS.keys())
+
+
+@pytest.fixture(params=MODEL_NAMES)
+def model_run_instance(request, tmp_path_factory):
+    """Fixture that provides model run instances for all registered models.
+
+    Parameters
+    ----------
+    request : pytest.FixtureRequest
+        Pytest request object with model name as parameter
+    tmp_path_factory : pytest.TempPathFactory
+        Factory for creating temporary directories
+
+    Returns
+    -------
+    BaseModelRun
+        Model run instance with data and config access
+    """
+    model_name = request.param
+    model_class = MODEL_RUNS[model_name]
+
+    # Determine if we should use real data
+    use_real = model_class.should_use_real_data(request)
+
+    # Create instance
+    import inspect
+
+    module_file = inspect.getfile(model_class)
+    return model_class.from_module(module_file, use_real=use_real, tmp_path_factory=tmp_path_factory)
+
+
+@pytest.mark.parametrize("cmip_version", ["cmip6", "cmip7"])
+@pytest.mark.parametrize(
+    "orchestrator_config",
+    [
+        pytest.param({"pipeline_workflow_orchestrator": "prefect", "enable_dask": "yes"}, id="prefect-dask"),
+        pytest.param({"pipeline_workflow_orchestrator": "native", "enable_dask": "yes"}, id="native-dask"),
+        pytest.param({"pipeline_workflow_orchestrator": "native", "enable_dask": "no"}, id="native-nodask"),
+    ],
+)
+def test_cli_process(model_run_instance, cmip_version, orchestrator_config, tmp_path):
+    """Test pycmor process CLI command with model configurations.
+
+    This test creates a temporary config file with updated paths and runs
+    the pycmor CLI process command. Tests multiple orchestrator configurations.
+
+    Parameters
+    ----------
+    model_run_instance : BaseModelRun
+        Model run instance with data and config
+    cmip_version : str
+        CMIP version to test (cmip6 or cmip7)
+    orchestrator_config : dict
+        Orchestrator configuration to test (pipeline_workflow_orchestrator, enable_dask)
+    tmp_path : Path
+        Temporary directory for test artifacts
+    """
+    # Mark as xfail if config is not available (will show XPASS when implemented)
+    if cmip_version not in model_run_instance.configs:
+        pytest.xfail(f"{cmip_version.upper()} config not available for this model")
+
+    # Get the appropriate config path
+    config_path = model_run_instance.configs[cmip_version]
+
+    # Load config as Jinja2 template and render with datadir
+    with open(config_path, "r") as f:
+        template = Template(f.read())
+
+    rendered_config = template.render(datadir=str(model_run_instance.datadir))
+    cfg = yaml.safe_load(rendered_config)
+
+    # Update output directory to tmp_path (both general and per-rule)
+    output_dir = str(tmp_path / "output")
+    if "general" not in cfg:
+        cfg["general"] = {}
+    cfg["general"]["output_directory"] = output_dir
+    for rule in cfg.get("rules", []):
+        rule["output_directory"] = output_dir
+
+    # Apply orchestrator configuration
+    if "pycmor" not in cfg:
+        cfg["pycmor"] = {}
+    cfg["pycmor"].update(orchestrator_config)
+
+    # Write modified config to temporary file
+    orch_type = orchestrator_config["pipeline_workflow_orchestrator"]
+    dask_status = "dask" if orchestrator_config["enable_dask"] == "yes" else "nodask"
+    orchestrator_desc = f"{orch_type}-{dask_status}"
+    temp_config = tmp_path / f"config_{cmip_version}_{orchestrator_desc}.yaml"
+    with open(temp_config, "w") as f:
+        yaml.dump(cfg, f)
+
+    # Run CLI command
+    result = subprocess.run(
+        ["pycmor", "process", str(temp_config)],
+        capture_output=True,
+        text=True,
+        timeout=300,  # 5 minutes timeout
+        check=False,  # Don't raise exception on non-zero exit, we'll check manually
+    )
+
+    # Check that command succeeded - if it fails, provide detailed error info
+    if result.returncode != 0:
+        error_msg = (
+            f"CLI command 'pycmor process' failed with exit code {result.returncode}\n"
+            f"Command: pycmor process {temp_config}\n"
+            f"\n=== STDERR ===\n{result.stderr}\n"
+            f"\n=== STDOUT ===\n{result.stdout}"
+        )
+        pytest.fail(error_msg)
+
+    # Verify output was created
+    output_dir = Path(cfg["general"]["output_directory"])
+    assert output_dir.exists(), f"Output directory not created: {output_dir}"
+    output_files = list(output_dir.rglob("*.nc"))
+    assert len(output_files) > 0, f"No NetCDF output files created in {output_dir}"
diff --git a/tests/integration/test_fesom_2p6_pimesh_esm_tools.py b/tests/integration/test_fesom_2p6_pimesh_esm_tools.py
deleted file mode 100644
index 4ebc6429..00000000
--- a/tests/integration/test_fesom_2p6_pimesh_esm_tools.py
+++ /dev/null
@@ -1,49 +0,0 @@
-import pytest
-import yaml
-
-from pycmor.core.cmorizer import CMORizer
-from pycmor.core.logging import logger
-from pycmor.core.pipeline import DefaultPipeline
-
-STEPS = DefaultPipeline.STEPS
-PROGRESSIVE_STEPS = [STEPS[: i + 1] for i in range(len(STEPS))]
-
-
-@pytest.mark.parametrize(
-    "config_fixture",
-    [
-        pytest.param("fesom_2p6_pimesh_esm_tools_config", id="CMIP6"),
-        pytest.param("fesom_2p6_pimesh_esm_tools_config_cmip7", id="CMIP7"),
-    ],
-)
-def test_init(config_fixture, fesom_2p6_pimesh_esm_tools_data, request):
-    config = request.getfixturevalue(config_fixture)
-    logger.info(f"Processing {config}")
-    with open(config, "r") as f:
-        cfg = yaml.safe_load(f)
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace("REPLACE_ME", str(fesom_2p6_pimesh_esm_tools_data))
-    CMORizer.from_dict(cfg)
-    # If we get this far, it was possible to construct
-    # the object, so this test passes:
-    assert True
-
-
-@pytest.mark.parametrize(
-    "config_fixture",
-    [
-        pytest.param("fesom_2p6_pimesh_esm_tools_config", id="CMIP6"),
-        pytest.param("fesom_2p6_pimesh_esm_tools_config_cmip7", id="CMIP7"),
-    ],
-)
-def test_process(config_fixture, fesom_2p6_pimesh_esm_tools_data, request):
-    config = request.getfixturevalue(config_fixture)
-    logger.info(f"Processing {config}")
-    with open(config, "r") as f:
-        cfg = yaml.safe_load(f)
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace("REPLACE_ME", str(fesom_2p6_pimesh_esm_tools_data))
-    cmorizer = CMORizer.from_dict(cfg)
-    cmorizer.process()
diff --git a/tests/integration/test_model_runs.py b/tests/integration/test_model_runs.py
new file mode 100644
index 00000000..5a1b84b3
--- /dev/null
+++ b/tests/integration/test_model_runs.py
@@ -0,0 +1,261 @@
+"""Library integration tests for pycmor CMORizer class.
+
+This module tests the library interface (CMORizer API) for all registered
+model runs with both CMIP6 and CMIP7 configurations. Tests are organized
+as a matrix of [model] x [cmip_version].
+"""
+
+import pytest
+import yaml
+from jinja2 import Template
+
+from pycmor.core.cmorizer import CMORizer
+from pycmor.core.logging import logger
+from tests.utils.entry_points import discover_model_runs
+
+# Discover all registered model runs
+MODEL_RUNS = discover_model_runs()
+MODEL_NAMES = sorted(MODEL_RUNS.keys())
+
+
+@pytest.fixture(params=MODEL_NAMES)
+def model_run_instance(request, tmp_path_factory):
+    """Fixture that provides model run instances for all registered models.
+
+    Parameters
+    ----------
+    request : pytest.FixtureRequest
+        Pytest request object with model name as parameter
+    tmp_path_factory : pytest.TempPathFactory
+        Factory for creating temporary directories
+
+    Returns
+    -------
+    BaseModelRun
+        Model run instance with data and config access
+    """
+    model_name = request.param
+    model_class = MODEL_RUNS[model_name]
+
+    # Determine if we should use real data based on markers or env var
+    use_real = model_class.should_use_real_data(request)
+
+    # Create instance using from_module (pass the model.py path)
+    # We need to find where the model class is defined
+    import inspect
+
+    module_file = inspect.getfile(model_class)
+    return model_class.from_module(module_file, use_real=use_real, tmp_path_factory=tmp_path_factory)
+
+
+@pytest.mark.parametrize("cmip_version", ["cmip6", "cmip7"])
+def test_library_initialization(model_run_instance, cmip_version):
+    """Test that CMORizer can be initialized from model config (library API).
+
+    This test validates that the CMORizer class can be instantiated from
+    configuration without executing the processing pipeline.
+
+    Parameters
+    ----------
+    model_run_instance : BaseModelRun
+        Model run instance with data and config
+    cmip_version : str
+        CMIP version to test (cmip6 or cmip7)
+    """
+    # Mark as xfail if config is not available (will show XPASS when implemented)
+    if cmip_version not in model_run_instance.configs:
+        pytest.xfail(f"{cmip_version.upper()} config not available for this model")
+
+    # Get the appropriate config path
+    config_path = model_run_instance.configs[cmip_version]
+
+    model_name = model_run_instance.__class__.__name__
+    logger.info(f"Testing library initialization for {model_name} with {cmip_version.upper()}")
+
+    # Load config as Jinja2 template and render with datadir
+    with open(config_path, "r") as f:
+        template = Template(f.read())
+
+    rendered_config = template.render(datadir=str(model_run_instance.datadir))
+    cfg = yaml.safe_load(rendered_config)
+
+    # Test that CMORizer can be constructed
+    cmorizer = CMORizer.from_dict(cfg)
+    assert cmorizer is not None
+    assert len(cmorizer.rules) > 0, "CMORizer should have at least one rule"
+
+
+@pytest.mark.parametrize("cmip_version", ["cmip6", "cmip7"])
+@pytest.mark.parametrize(
+    "orchestrator_config",
+    [
+        pytest.param({"pipeline_workflow_orchestrator": "prefect", "enable_dask": "yes"}, id="prefect-dask"),
+        pytest.param({"pipeline_workflow_orchestrator": "native", "enable_dask": "yes"}, id="native-dask"),
+        pytest.param({"pipeline_workflow_orchestrator": "native", "enable_dask": "no"}, id="native-nodask"),
+    ],
+)
+def test_library_process(model_run_instance, cmip_version, orchestrator_config, tmp_path):
+    """Test that CMORizer can process data from model config (library API).
+
+    This test validates the full processing pipeline using the CMORizer
+    library interface, from initialization through data processing to
+    output file creation. Tests multiple orchestrator configurations.
+
+    Parameters
+    ----------
+    model_run_instance : BaseModelRun
+        Model run instance with data and config
+    cmip_version : str
+        CMIP version to test (cmip6 or cmip7)
+    orchestrator_config : dict
+        Orchestrator configuration to test (pipeline_workflow_orchestrator, enable_dask)
+    tmp_path : Path
+        Temporary directory for test artifacts
+    """
+    # Mark as xfail if config is not available (will show XPASS when implemented)
+    if cmip_version not in model_run_instance.configs:
+        pytest.xfail(f"{cmip_version.upper()} config not available for this model")
+
+    # Get the appropriate config path
+    config_path = model_run_instance.configs[cmip_version]
+
+    model_name = model_run_instance.__class__.__name__
+    orch_type = orchestrator_config["pipeline_workflow_orchestrator"]
+    dask_status = "dask" if orchestrator_config["enable_dask"] == "yes" else "nodask"
+    orchestrator_desc = f"{orch_type}-{dask_status}"
+    logger.info(f"Testing library processing for {model_name} with {cmip_version.upper()} using {orchestrator_desc}")
+
+    # Load config as Jinja2 template and render with datadir
+    with open(config_path, "r") as f:
+        template = Template(f.read())
+
+    rendered_config = template.render(datadir=str(model_run_instance.datadir))
+    cfg = yaml.safe_load(rendered_config)
+
+    # Update output directory to tmp_path
+    if "general" not in cfg:
+        cfg["general"] = {}
+    cfg["general"]["output_directory"] = str(tmp_path / "output")
+
+    # Apply orchestrator configuration
+    if "pycmor" not in cfg:
+        cfg["pycmor"] = {}
+    cfg["pycmor"].update(orchestrator_config)
+
+    # Process the data
+    cmorizer = CMORizer.from_dict(cfg)
+    result = cmorizer.process()
+
+    # Verify processing completed successfully
+    # Result should be a list of processed datasets (one per rule)
+    assert result is not None, "Processing returned None"
+    assert len(result) > 0, "Processing returned empty result"
+
+    # Verify each result is a valid xarray Dataset or DataArray
+    import xarray as xr
+
+    for i, dataset in enumerate(result):
+        assert isinstance(
+            dataset, (xr.Dataset, xr.DataArray)
+        ), f"Result {i} is not an xarray Dataset or DataArray: {type(dataset)}"
+
+
+@pytest.mark.parametrize("cmip_version", ["cmip6", "cmip7"])
+def test_library_accessor(model_run_instance, cmip_version):
+    """Test dataset accessor API (ds.pycmor.process) for model data.
+
+    This test validates the accessor interface, which provides a simpler
+    API for one-shot in-memory processing of datasets without needing full
+    CMORizer configuration. The accessor processes data and returns the
+    result without saving to disk.
+
+    Parameters
+    ----------
+    model_run_instance : BaseModelRun
+        Model run instance with data and config
+    cmip_version : str
+        CMIP version to test (cmip6 or cmip7)
+    """
+    import xarray as xr
+
+    import pycmor
+
+    pycmor.enable_xarray_accessor()
+
+    model_name = model_run_instance.__class__.__name__
+    logger.info(f"Testing accessor API for {model_name} with {cmip_version.upper()}")
+
+    # Get the appropriate config to extract a variable name
+    if cmip_version not in model_run_instance.configs:
+        pytest.xfail(f"{cmip_version.upper()} config not available for this model")
+
+    config_path = model_run_instance.configs[cmip_version]
+
+    with open(config_path, "r") as f:
+        cfg = yaml.safe_load(f)
+
+    # Extract first rule to get variable info
+    if not cfg.get("rules"):
+        pytest.skip(f"No rules found in {config_path}")
+
+    first_rule = cfg["rules"][0]
+
+    # Get the variable identifier based on CMIP version
+    if cmip_version == "cmip6":
+        # For CMIP6, use cmor_variable
+        variable_id = first_rule.get("cmor_variable")
+        if not variable_id:
+            pytest.skip(f"No cmor_variable in first rule of {config_path}")
+    else:
+        # For CMIP7, use compound_name
+        variable_id = first_rule.get("compound_name")
+        if not variable_id:
+            pytest.skip(f"No compound_name in first rule of {config_path}")
+
+    # Load a dataset from the model run data
+    # Replace REPLACE_ME in input paths
+    if not first_rule.get("inputs"):
+        pytest.skip("First rule has no inputs")
+
+    first_input = first_rule["inputs"][0]
+    input_path = first_input["path"].replace("REPLACE_ME", str(model_run_instance.datadir))
+
+    # Try to open the dataset
+    try:
+        ds = xr.open_dataset(input_path)
+    except Exception as e:
+        pytest.skip(f"Could not open dataset {input_path}: {e}")
+
+    # Get inherit defaults from config (source_id, experiment_id, etc.)
+    inherit_defaults = cfg.get("inherit", {})
+
+    # Process using accessor API - this does in-memory processing
+    # The accessor inherits metadata from ~/.pycmor.yaml config, but we can
+    # also pass explicit kwargs that override the config
+    try:
+        result = ds.pycmor.process(
+            variable_id,
+            cmor_version=cmip_version.upper(),
+            **inherit_defaults,
+        )
+    except Exception as e:
+        # Some models may not have all metadata required for accessor API
+        # or the data structure may not be compatible
+        pytest.skip(f"Accessor processing failed (may be expected): {e}")
+
+    # Verify result is an xarray Dataset or DataArray
+    assert isinstance(result, (xr.Dataset, xr.DataArray)), f"Result should be xarray object, got {type(result)}"
+
+    # If result is a Dataset, it should have data variables
+    if isinstance(result, xr.Dataset):
+        assert len(result.data_vars) > 0, "Result Dataset should have at least one data variable"
+
+    # Verify the result has expected CMOR attributes
+    # The accessor should have applied metadata from the data request
+    if isinstance(result, xr.DataArray):
+        assert hasattr(result, "attrs"), "Result should have attributes"
+    else:
+        # For Dataset, check that at least one variable has attributes
+        assert any(
+            hasattr(var, "attrs") for var in result.data_vars.values()
+        ), "Result variables should have attributes"
diff --git a/tests/integration/test_uxarray_pi.py b/tests/integration/test_uxarray_pi.py
deleted file mode 100644
index b1f4c904..00000000
--- a/tests/integration/test_uxarray_pi.py
+++ /dev/null
@@ -1,46 +0,0 @@
-import yaml
-
-from pycmor.core.cmorizer import CMORizer
-from pycmor.core.logging import logger
-from pycmor.core.pipeline import DefaultPipeline
-
-STEPS = DefaultPipeline.STEPS
-PROGRESSIVE_STEPS = [STEPS[: i + 1] for i in range(len(STEPS))]
-
-
-def test_process(pi_uxarray_config, pi_uxarray_data):
-    logger.info(f"Processing {pi_uxarray_config}")
-    with open(pi_uxarray_config, "r") as f:
-        cfg = yaml.safe_load(f)
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace("REPLACE_ME", str(pi_uxarray_data))
-    cmorizer = CMORizer.from_dict(cfg)
-    cmorizer.process()
-
-
-def test_process_native(pi_uxarray_config, pi_uxarray_data):
-    logger.info(f"Processing {pi_uxarray_config}")
-    with open(pi_uxarray_config, "r") as f:
-        cfg = yaml.safe_load(f)
-    cfg["pycmor"]["pipeline_workflow_orchestrator"] = "native"
-    cfg["pycmor"]["dask_cluster"] = "local"
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace("REPLACE_ME", str(pi_uxarray_data))
-    cmorizer = CMORizer.from_dict(cfg)
-    cmorizer.process()
-
-
-def test_process_cmip7(pi_uxarray_config_cmip7, pi_uxarray_data):
-    logger.info(f"Processing {pi_uxarray_config_cmip7}")
-    with open(pi_uxarray_config_cmip7, "r") as f:
-        cfg = yaml.safe_load(f)
-
-    # CMIP7 uses packaged data - no CMIP_Tables_Dir needed
-
-    for rule in cfg["rules"]:
-        for input in rule["inputs"]:
-            input["path"] = input["path"].replace("REPLACE_ME", str(pi_uxarray_data))
-    cmorizer = CMORizer.from_dict(cfg)
-    cmorizer.process()
diff --git a/tests/meta/test_h5py_threadsafe.py b/tests/meta/test_h5py_threadsafe.py
index 3b883b0a..aa27ab21 100644
--- a/tests/meta/test_h5py_threadsafe.py
+++ b/tests/meta/test_h5py_threadsafe.py
@@ -210,30 +210,11 @@ def test_xarray_open_mfdataset_with_dask_client(engine):
         cluster.close()
 
 
-@pytest.mark.skipif(
-    not (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
-        / "awicm_1p0_recom"
-        / "awi-esm-1-1-lr_kh800"
-        / "piControl"
-        / "outdata"
-        / "fesom"
-        / "thetao_fesom_2686-01-05.nc"
-    ).exists(),
-    reason="FESOM test file not available",
-)
-def test_actual_fesom_file_with_h5py():
+@pytest.mark.xfail(reason="Expected to fail without thread-safe HDF5", strict=False)
+def test_actual_fesom_file_with_h5py(awicm_1p0_recom_datadir):
     """Test opening the actual problematic FESOM file with h5py."""
     test_file = (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
+        awicm_1p0_recom_datadir
         / "awicm_1p0_recom"
         / "awi-esm-1-1-lr_kh800"
         / "piControl"
@@ -242,38 +223,23 @@ def test_actual_fesom_file_with_h5py():
         / "thetao_fesom_2686-01-05.nc"
     )
 
+    # Skip if file doesn't exist
+    if not test_file.exists():
+        pytest.skip("FESOM test file not available")
+
     # Try with h5py directly
     with h5py.File(test_file, "r") as f:
         assert len(f.keys()) > 0, "File should contain datasets"
 
 
-@pytest.mark.skipif(
-    not (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
-        / "awicm_1p0_recom"
-        / "awi-esm-1-1-lr_kh800"
-        / "piControl"
-        / "outdata"
-        / "fesom"
-        / "thetao_fesom_2686-01-05.nc"
-    ).exists(),
-    reason="FESOM test file not available",
-)
+@pytest.mark.xfail(reason="Expected to fail without thread-safe HDF5", strict=False)
 @pytest.mark.parametrize("engine", ["h5netcdf", "netcdf4"])
-def test_actual_fesom_file_with_xarray(engine):
+def test_actual_fesom_file_with_xarray(awicm_1p0_recom_datadir, engine):
     """Test opening the actual problematic FESOM file with different xarray engines."""
     import xarray as xr
 
     test_file = (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
+        awicm_1p0_recom_datadir
         / "awicm_1p0_recom"
         / "awi-esm-1-1-lr_kh800"
         / "piControl"
@@ -282,30 +248,20 @@ def test_actual_fesom_file_with_xarray(engine):
         / "thetao_fesom_2686-01-05.nc"
     )
 
+    # Skip if file doesn't exist
+    if not test_file.exists():
+        pytest.skip("FESOM test file not available")
+
     # Try with specified engine
     ds = xr.open_dataset(test_file, engine=engine)
     assert ds is not None, f"Should successfully open dataset with {engine}"
     ds.close()
 
 
-@pytest.mark.skipif(
-    not (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
-        / "awicm_1p0_recom"
-        / "awi-esm-1-1-lr_kh800"
-        / "piControl"
-        / "outdata"
-        / "fesom"
-    ).exists(),
-    reason="FESOM test files not available",
-)
+@pytest.mark.xfail(reason="Expected to fail without thread-safe HDF5", strict=False)
 @pytest.mark.parametrize("engine", ["h5netcdf", "netcdf4"])
 @pytest.mark.parametrize("parallel", [True, False])
-def test_actual_fesom_files_with_open_mfdataset(engine, parallel):
+def test_actual_fesom_files_with_open_mfdataset(awicm_1p0_recom_datadir, engine, parallel):
     """Test opening actual FESOM files with open_mfdataset using different engines and parallel settings."""
     import glob
 
@@ -314,20 +270,13 @@ def test_actual_fesom_files_with_open_mfdataset(engine, parallel):
     # Both engines require thread-safe HDF5/NetCDF-C for parallel file opening
     # System packages are NOT compiled with thread-safety
     if parallel:
-        pytest.skip("parallel=True requires thread-safe HDF5/NetCDF-C libraries (not available in system packages)")
+        pytest.skip("parallel=True requires thread-safe HDF5/NetCDF-C libraries")
 
-    fesom_dir = (
-        Path.home()
-        / ".cache"
-        / "pycmor"
-        / "test_data"
-        / "awicm_1p0_recom"
-        / "awicm_1p0_recom"
-        / "awi-esm-1-1-lr_kh800"
-        / "piControl"
-        / "outdata"
-        / "fesom"
-    )
+    fesom_dir = awicm_1p0_recom_datadir / "awicm_1p0_recom" / "awi-esm-1-1-lr_kh800" / "piControl" / "outdata" / "fesom"
+
+    # Skip if directory doesn't exist
+    if not fesom_dir.exists():
+        pytest.skip("FESOM test files not available")
 
     # Get all FESOM NetCDF files
     files = sorted(glob.glob(str(fesom_dir / "*.nc")))
diff --git a/tests/test_generic_models.py b/tests/test_generic_models.py
new file mode 100644
index 00000000..dfdb550c
--- /dev/null
+++ b/tests/test_generic_models.py
@@ -0,0 +1,119 @@
+"""Generic tests that run against all registered model runs.
+
+This test module runs against all model runs registered via:
+- Built-in models in tests/contrib/models/
+- External plugins registered via 'pycmor.models' entry points
+
+External plugin developers can extend pycmor's test coverage by:
+1. Creating a model run class inheriting from BaseModelRun
+2. Registering it via entry points in their package
+3. Installing their package with [test] extra: pip install pycmor-plugin-foo[test]
+
+Example plugin setup:
+
+    [project.entry-points."pycmor.models"]
+    my_model = "pycmor_plugin_foo.model:MyModelRun"
+
+When the plugin is installed, these tests will automatically run against
+the plugin's model, ensuring compatibility with pycmor.
+"""
+
+import pytest
+
+
+def test_model_run_has_datadir(model_run):
+    """Test that model run can provide a data directory."""
+    datadir = model_run.datadir
+    assert datadir is not None
+    assert datadir.exists(), f"Data directory {datadir} does not exist"
+
+
+def test_model_run_can_open_dataset(model_run):
+    """Test that model run can open an xarray dataset."""
+    ds = model_run.ds
+    assert ds is not None
+    assert hasattr(ds, "data_vars"), "Dataset does not have data_vars attribute"
+    assert len(ds.data_vars) > 0, "Dataset has no data variables"
+
+
+def test_model_run_has_registry_path(model_run):
+    """Test that model run has a registry path property."""
+    registry_path = model_run.registry_path
+    assert registry_path is not None
+    assert str(registry_path).endswith("registry.yaml")
+
+
+def test_model_run_has_stub_manifest_path(model_run):
+    """Test that model run has a stub manifest path property."""
+    stub_manifest_path = model_run.stub_manifest_path
+    assert stub_manifest_path is not None
+    assert str(stub_manifest_path).endswith("stub_manifest.yaml")
+
+
+def test_model_run_has_model_name(model_run):
+    """Test that model run has a model_name attribute."""
+    assert hasattr(model_run, "model_name")
+    assert isinstance(model_run.model_name, str)
+    assert len(model_run.model_name) > 0
+
+
+def test_model_run_datadir_is_lazy_loaded(model_run_class, request, tmp_path_factory):
+    """Test that datadir is lazy-loaded (not fetched until accessed)."""
+    use_real = model_run_class.should_use_real_data(request)
+
+    # Create instance
+    import importlib
+
+    model_module = model_run_class.__module__
+    if model_module.startswith("tests.contrib.models."):
+        module = importlib.import_module(model_module)
+        if hasattr(module, "__file__"):
+            instance = model_run_class.from_module(
+                module.__file__,
+                use_real=use_real,
+                tmp_path_factory=tmp_path_factory,
+            )
+        else:
+            pytest.skip("Cannot test lazy loading for this model")
+    else:
+        pytest.skip("Cannot test lazy loading for plugin models")
+
+    # Check that _datadir is None before access
+    assert instance._datadir is None, "datadir should not be loaded yet"
+
+    # Access datadir
+    _ = instance.datadir
+
+    # Check that _datadir is now set
+    assert instance._datadir is not None, "datadir should be loaded after access"
+
+
+def test_model_run_ds_is_lazy_loaded(model_run_class, request, tmp_path_factory):
+    """Test that dataset is lazy-loaded (not opened until accessed)."""
+    use_real = model_run_class.should_use_real_data(request)
+
+    # Create instance
+    import importlib
+
+    model_module = model_run_class.__module__
+    if model_module.startswith("tests.contrib.models."):
+        module = importlib.import_module(model_module)
+        if hasattr(module, "__file__"):
+            instance = model_run_class.from_module(
+                module.__file__,
+                use_real=use_real,
+                tmp_path_factory=tmp_path_factory,
+            )
+        else:
+            pytest.skip("Cannot test lazy loading for this model")
+    else:
+        pytest.skip("Cannot test lazy loading for plugin models")
+
+    # Check that _ds is None before access
+    assert instance._ds is None, "dataset should not be loaded yet"
+
+    # Access ds
+    _ = instance.ds
+
+    # Check that _ds is now set
+    assert instance._ds is not None, "dataset should be loaded after access"
diff --git a/tests/unit/test_tutorial.py b/tests/unit/test_tutorial.py
new file mode 100644
index 00000000..ce21bc55
--- /dev/null
+++ b/tests/unit/test_tutorial.py
@@ -0,0 +1,78 @@
+"""Tests for pycmor.tutorial module."""
+
+import pytest
+
+
+def test_tutorial_available_datasets():
+    """Test that tutorial datasets can be discovered."""
+    import pycmor.tutorial as tutorial
+
+    datasets = tutorial.available_datasets()
+    assert isinstance(datasets, list)
+    assert len(datasets) > 0
+    # Should have at least the built-in datasets
+    assert "fesom_2p6" in datasets
+    assert "awicm_recom" in datasets
+    assert "fesom_dev" in datasets
+
+
+def test_tutorial_info():
+    """Test that tutorial.info returns dataset information."""
+    import pycmor.tutorial as tutorial
+
+    info_text = tutorial.info("fesom_2p6")
+    assert isinstance(info_text, str)
+    assert len(info_text) > 0
+
+
+def test_tutorial_info_invalid_dataset():
+    """Test that tutorial.info raises KeyError for invalid dataset."""
+    import pycmor.tutorial as tutorial
+
+    with pytest.raises(KeyError, match="Dataset 'invalid' not found"):
+        tutorial.info("invalid")
+
+
+def test_tutorial_open_dataset_stub(tmp_path_factory):
+    """Test opening a tutorial dataset with stub data."""
+    import pycmor.tutorial as tutorial
+
+    ds = tutorial.open_dataset("fesom_2p6", use_real=False)
+    assert ds is not None
+    # Should be an xarray Dataset
+    import xarray as xr
+
+    assert isinstance(ds, xr.Dataset)
+
+
+@pytest.mark.real_data
+def test_tutorial_open_dataset_real():
+    """Test opening a tutorial dataset with real data.
+
+    This test requires internet connection and will download data.
+    Only runs when marked with real_data marker.
+    """
+    import pycmor.tutorial as tutorial
+
+    ds = tutorial.open_dataset("fesom_2p6", use_real=True)
+    assert ds is not None
+    import xarray as xr
+
+    assert isinstance(ds, xr.Dataset)
+
+
+def test_tutorial_open_dataset_invalid():
+    """Test that open_dataset raises KeyError for invalid dataset."""
+    import pycmor.tutorial as tutorial
+
+    with pytest.raises(KeyError, match="Dataset 'invalid' not found"):
+        tutorial.open_dataset("invalid")
+
+
+def test_tutorial_open_dataset_with_kwargs():
+    """Test that open_dataset passes kwargs to xarray."""
+    import pycmor.tutorial as tutorial
+
+    # Pass chunks argument to xarray
+    ds = tutorial.open_dataset("fesom_2p6", use_real=False, chunks={"time": 1})
+    assert ds is not None
diff --git a/tests/utils/entry_points.py b/tests/utils/entry_points.py
new file mode 100644
index 00000000..0c5eb486
--- /dev/null
+++ b/tests/utils/entry_points.py
@@ -0,0 +1,58 @@
+"""Utilities for working with entry points in tests."""
+
+import importlib.metadata
+from typing import Type
+
+from tests.fixtures.base_model_run import BaseModelRun
+
+
+def discover_model_runs() -> dict[str, Type[BaseModelRun]]:
+    """Discover all registered model run classes from entry points.
+
+    Returns
+    -------
+    dict[str, Type[BaseModelRun]]
+        Dictionary mapping model names to their ModelRun classes
+    """
+    model_runs = {}
+
+    # Python 3.9 vs 3.10+ compatibility
+    # In 3.9: entry_points() returns dict[str, list[EntryPoint]]
+    # In 3.10+: entry_points() returns EntryPoints object with select() method
+    try:
+        # Try Python 3.10+ API first
+        eps = importlib.metadata.entry_points(group="pycmor.fixtures.model_runs")
+    except TypeError:
+        # Fall back to Python 3.9 API
+        all_eps = importlib.metadata.entry_points()
+        eps = all_eps.get("pycmor.fixtures.model_runs", [])
+
+    for ep in eps:
+        model_runs[ep.name] = ep.load()
+
+    return model_runs
+
+
+def get_model_run_class(model_name: str) -> Type[BaseModelRun]:
+    """Get a specific model run class by name.
+
+    Parameters
+    ----------
+    model_name : str
+        Name of the model run (entry point name)
+
+    Returns
+    -------
+    Type[BaseModelRun]
+        The model run class
+
+    Raises
+    ------
+    KeyError
+        If the model name is not found in registered entry points
+    """
+    model_runs = discover_model_runs()
+    if model_name not in model_runs:
+        available = ", ".join(model_runs.keys())
+        raise KeyError(f"Model '{model_name}' not found. Available models: {available}")
+    return model_runs[model_name]