From 96bf4e81f6c12170969e296cf9bf8577d419a5d1 Mon Sep 17 00:00:00 2001 From: Taralytics Date: Thu, 7 May 2026 13:22:06 -0400 Subject: [PATCH] Update installation.md docs: add HPC/SLURM apptainer usage note. Tested with v0.13.2.sif. --- docs/installation.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/installation.md b/docs/installation.md index 2487613d..9dd5deb3 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -202,7 +202,17 @@ Then run the following command to execute the container: ```bash apptainer run --nv rsc.sif ``` +### Running on HPC systems with SLURM +When running on HPC systems via SLURM, conda must be explicitly activated before running Python scripts. Use `apptainer exec` instead of `apptainer run`: + +```bash +apptainer exec --nv \ + --bind /path/to/your/data:/path/to/your/data \ + rsc.sif \ + bash -c "source /opt/conda/etc/profile.d/conda.sh && conda activate base && python" +``` +Without sourcing conda first, `CONDA_PREFIX` will be unset and CuPy will fail to locate the CUDA libraries inside the container, resulting in a `TypeError: expected str, bytes or os.PathLike object, not NoneType` error. # System requirements