SCC Continued

SCC Continued

We’ll now delve into three more topics on SCC:

  1. SCC Modules
  2. Python environments on SCC
  3. Batch computing on SCC

SCC Modules

SCC Modules Intro

When you connect to an SCC login or compute node, you are running in a default environment with some default software installed.

On SCC you use the module command to load software you need for your project.

There’s a nice Module Basics webpage on the BU TechWeb.

We’ll cover some of the most command commands here.

module list

To see what modules are currently loaded:

$ module list
No modules loaded

To see what modules are available:

$ module avail

---------------------------------- /share/module.8/bioinformatics ----------------------------------
   admixture/1.3.0                               maker/3.01.04
   agat/0.7.0                                    manta/1.6.0
   angsd/0.923                                   maps/1.1.0
   angsd/0.935                            (D)    maxbin/2.2.7
   annovar/2018apr                               maxentscan/20Apr2004
   annovar/2019oct24                      (D)    maxquant/1.6.14
   anvio/7.1                                     maxquant/1.6.17.0                    (D)
   artemis/18.0.3                                megahit/1.2.9
   atacgraph/2021-04-15_gitf5dc970               melt/2.1.5
   augustus/3.3.2                                meme/5.3.0
   bakta/1.5.1                                   meme/5.3.3
   bamtools/2.5.1                                meme/5.5.5                           (D)
       ...                                         ...

…which is not that helpful since it lists all the available modules, and each available version of each module.


But let’s look at python specifically. First let’s see which version is installed by default:

$ which python
/usr/bin/python

$ python --version
Python 3.6.8

$ which python3
/usr/bin/python3

$ python3 --version
Python 3.6.8

$ which pip
/usr/bin/which: no pip in (/usr/java/default/jre/bin:/usr/java/default/bin:/usr/local/bin:/usr/bin:/
usr/local/sbin:/usr/sbin:/opt/dell/srvadmin/bin:/opt/TurboVNC/bin:/usr2/faculty/tgardos/bin:.:/usr2/
faculty/tgardos/.local/share/JetBrains/Toolbox/scripts)

$ which pip3
/usr/bin/pip3

$ pip3 --version
pip 9.0.3 from /usr/lib/python3.6/site-packages (python 3.6)

We can list modules that match a name pattern:

$ module avail python

----------------------------------- /share/module.8/programming ------------------------------------
   python2-intel/2019.4.088        python3/3.6.5     python3/3.7.9           python3/3.9.4
   python2-intel/2019.5.098 (D)    python3/3.6.9     python3/3.7.10          python3/3.9.9
   python2/2.7.13                  python3/3.6.10    python3/3.8.3           python3/3.10.5
   python2/2.7.15                  python3/3.6.12    python3/3.8.6           python3/3.10.12
   python2/2.7.16           (D)    python3/3.7.3     python3/3.8.10.clean    python3/3.12.4  (D)
   python3-intel/2021.1.1          python3/3.7.5     python3/3.8.10
   python3-intel/2022.2.0   (D)    python3/3.7.7     python3/3.8.16

  Where:
   D:  Default Module

If the avail list is too long consider trying:

"module --default avail" or "ml -d av" to just list the default modules.
"module overview" or "ml ov" to display the number of modules for each name.

Use "module spider" to find all possible modules and extensions.
Use "module keyword key1 key2 ..." to search for all possible modules matching any of the "keys".

We see many versions of python3 and even python2.

Note the (D) next to some versions. These are the default versions.

If we want to load a specific version, we can type:

$ module load python3/3.10.12

Or we can load the default version with:

$ module load python3

So let’s load the default version which happens to be the latest version:

$ module load python3

Now let’s check our python version:

$ python --version
Python 3.12.4

$ python3 --version
Python 3.12.4

$ pip --version
pip 24.1.1 from /share/pkg.8/python3/3.12.4/install/lib/python3.12/site-packages/pip (python 3.12)

$ pip3 --version
pip 24.1.1 from /share/pkg.8/python3/3.12.4/install/lib/python3.12/site-packages/pip (python 3.12)

$ which python3
/share/pkg.8/python3/3.12.4/install/bin/python3

And we can see that the module is loaded:

$ module list
Currently Loaded Modules:
  1) python3/3.12.4

Note that you can even load some python packages as modules. These tend to be the bigger packages like pytorch, tensorflow, etc.

$ module avail pytorch

--------------------------------- /share/module.8/machine-learning ---------------------------------
   pytorch/1.1    pytorch/1.5.1    pytorch/1.8.1     pytorch/1.11.0
   pytorch/1.3    pytorch/1.6.0    pytorch/1.9.0     pytorch/1.12.1
   pytorch/1.5    pytorch/1.7.0    pytorch/1.10.2    pytorch/1.13.1 (D)

---------------------------------- /share/module.8/visualization -----------------------------------
   pytorch3d/0.7.0    pytorch3d/0.7.3 (D)

  Where:
   D:  Default Module

Just be careful because module doesn’t load package dependencies and or check for conflicts.

But it may be more efficient to load large packages this way, rather than pip or conda install.

Prepackaged ML Module

SCC also has a prepackaged machine learning super module called academic-ml.

Let’s see what’s available.

$ module avail academic-ml

--------------------------------------------------- /share/module.8/programming ---------------------------------------------------
   academic-ml/fall-2024    academic-ml/spring-2024    academic-ml/spring-2026 (D)
   academic-ml/fall-2025    academic-ml/spring-2025

There will be a new, updated version added every semester.

To get detailed information about the module, you can type:

$ module show academic-ml/spring-2026

Which will output something like:

-------------------------------------------------------------------------------------------------------------------------------
   /share/module.8/programming/academic-ml/spring-2026.lua:
-------------------------------------------------------------------------------------------------------------------------------
academic-ml spring-2026: This provides a Python 3.12 conda environment with popular machine learning libraries pre-loaded. New versions will be created for the start of the Spring and Fall semesters.

This module provides a trio of conda environments. All of these will correctly use GPUs when run on GPU-equipped compute nodes, and will run on CPU-only compute nodes as well. 

*** Note ***
The environments have minimum CUDA compute capabilities. The compute capabilty can be selected in the menu options for OnDemand jobs. For batch jobs, use the following flag:

    # This sets a minimum of 6.0
    #$ -l gpu_c=6.0

Requirements for each environment are:
    * PyTorch:    >= 7.0
    * Tensorflow: >= 6.0
    * Jax:        >= 6.0

To activate the PyTorch-based environment do:

    module load miniconda
    conda activate spring-2026-pyt
    
To activate the Tensorflow-based environment do:

    module load miniconda
    conda activate spring-2026-tf

And finally, to activate the Jax-based environment do:

    module load miniconda
    conda activate spring-2026-jax

The PyTorch environment provides:
    * PyTorch v2.9.1 (https://pytorch.org/)
    * torchaudio, torchvision, torchtext, torchdata (https://pytorch.org/)
    * PyTorch Lightning (https://lightning.ai/docs/pytorch/stable/)
    * Magma (https://icl.utk.edu/magma/)
    * Whisper (https://github.com/openai/whisper)
    * JAX v0.8.2 (CPU-only) (https://jax.readthedocs.io)

    
The Tensorflow environment provides:
    * Tensorflow v2.20.0 (https://www.tensorflow.org)
    * tensorflow-probability, tensorflow-similarity, tensorflow-estimator,
      tensorflow-datasets, tensorflow-hub, tensorflow-recommenders (https://www.tensorflow.org)
    * JAX v0.8.2 (CPU-only) (https://jax.readthedocs.io)
    * For tips on setting Tensorflow parallelism, see: https://dl.acm.org/doi/pdf/10.1145/3431388
    
The Jax environment provides:
    * Jax v0.8.2 (https://jax.readthedocs.io)
    * PyTorch v2.9.1 (CPU-only) (https://pytorch.org/)
    * Tensorflow v2.20.0 (CPU-only) (https://www.tensorflow.org)
    
Jax-based programs typically use the dataloaders from PyTorch or Tensorflow, which is why those
libraries are installed with this environment.
    
The following lists of libraries and software are common to all environments:

    * Machine learning and CUDA GPU libraries:
        ** Tensorboard (https://www.tensorflow.org)
        ** Transformers (https://huggingface.co/)
        ** Numba (https://numba.pydata.org)
        ** NLTK (https://www.nltk.org/)
        ** Gensim (https://radimrehurek.com/gensim/)
        ** Spacy (https://spacy.io/)
        ** scikit-learn (https://scikit-learn.org)
        ** scikit-image (https://scikit-image.org)
        ** OpenAI models (https://platform.openai.com)
        ** Nvidia NCCL (https://developer.nvidia.com/nccl)

    
    * Popular libraries:
        ** Numpy (https://numpy.org)
        ** Scipy (https://scipy.org)
        ** Pandas (https://pandas.pydata.org)
        ** OpenCV (https://opencv.org)
        ** Pillow (https://python-pillow.org)
        ** NetworkX (https://networkx.org)
        ** Dask (https://www.dask.org)
        ** Polars (https://pola.rs)
        ** Ray (https://docs.ray.io/)
    
    * Development tools:
        ** gcc and g++ compilers v13.3.0 (https://gcc.gnu.org/)
        ** Nvidia CUDA SDK (https://developer.nvidia.com/)
        ** Jupyter Lab and Notebook (https://jupyter.org)
        ** Spyder (https://www.spyder-ide.org)
    
To see the complete list and specific versions of all libraries that are installed, first activate the environment and then run:

    conda list
    
For more information on academic-ml, please see https://www.bu.edu/tech/support/research/software-and-programming/common-languages/python/python-ml/academic-machine-learning-environment/

The following environment variables are provided for convenience:
$SCC_ACADEMIC_ML_DIR -- Base Package Directory
$SCC_ACADEMIC_ML_ENV_PYT -- Conda Environment (PyTorch)
$SCC_ACADEMIC_ML_ENV_TF -- Conda Environment (Tensorflow)
$SCC_ACADEMIC_ML_ENV_JAX -- Conda Environment (Jax)

The following environment variables provide the location of .yml files for cloning these
environments:

$SCC_ACADEMIC_ML_YML_PYT -- Conda .yml File for PyTorch Environment
$SCC_ACADEMIC_ML_YML_TF -- Conda .yml File for Tensorflow Environment
$SCC_ACADEMIC_ML_YML_JAX -- Conda .yml File for Jax Environment

$SCC_ACADEMIC_ML_YML_BASIC_PYT -- Simpler conda .yml File for PyTorch Environment
$SCC_ACADEMIC_ML_YML_BASIC_TF -- Simpler conda .yml File for Tensorflow Environment
$SCC_ACADEMIC_ML_YML_BASIC_JAX -- Simpler conda .yml File for Jax Environment

  

prereq("miniconda")
whatis("Name:         academic-ml")
whatis("Version:      spring-2026")
whatis("Categories:   programming")
whatis("Keywords:     alma8, programming, ai, machine, learning, python, pytorch, tensorflow, jax")
whatis("URL:          https://www.bu.edu/tech/support/research/software-and-programming/common-languages/python/python-ml/academic-machine-learning-environment/")
whatis("Description:  This provides a Python 3.12 conda environment with popular machine learning libraries pre-loaded. New versions will be created for the start of the Spring and Fall semesters.")
setenv("SCC_ACADEMIC_ML_BASE","/share/pkg.8/academic-ml/spring-2026")
setenv("SCC_ACADEMIC_ML_DIR","/share/pkg.8/academic-ml/spring-2026/install")
setenv("SCC_ACADEMIC_ML_ENV_PYT","/share/pkg.8/academic-ml/spring-2026/install/spring-2026-pyt")
setenv("SCC_ACADEMIC_ML_ENV_TF","/share/pkg.8/academic-ml/spring-2026/install/spring-2026-tf")
setenv("SCC_ACADEMIC_ML_ENV_JAX","/share/pkg.8/academic-ml/spring-2026/install/spring-2026-jax")
setenv("SCC_ACADEMIC_ML_YML_PYT","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-pyt.yml")
setenv("SCC_ACADEMIC_ML_YML_TF","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-tf.yml")
setenv("SCC_ACADEMIC_ML_YML_JAX","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-jax.yml")
setenv("SCC_ACADEMIC_ML_YML_BASIC_PYT","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-pyt-basic.yml")
setenv("SCC_ACADEMIC_ML_YML_BASIC_TF","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-tf-basic.yml")
setenv("SCC_ACADEMIC_ML_YML_BASIC_JAX","/share/pkg.8/academic-ml/spring-2026/install/academic-ml-spring-2026-jax-basic.yml")
setenv("TF_CPP_MIN_LOG_LEVEL","2")
prepend_path("CONDA_ENVS_PATH","/share/pkg.8/academic-ml/spring-2026/install")
setenv("TF_NUM_INTEROP_THREADS","1")
setenv("TF_NUM_INTRAOP_THREADS","1")
setenv("JAX_PLATFORMS","cpu")

You can also see this page for better formatted content.

Interactive Sessions with Specific Modules

From TechWeb:

When requesting a Jupyter Notebook, Jupyter Lab, or Spyder OnDemand session, enter the conda activation command in the Pre-Launch Command field. This screenshot shows an example of starting a Jupyter Lab session with the spring-2026-pyt environment.

module unload

To remove modules from your environment you can use the

module unload [modulename]

command.

Python Envs on SCC

Python Environments on SCC

It is highly recommended to use the prepackaged academic-ml module if you can because it saves you from some storage quota limitations as we’ll show here.

But sometimes, you need more control over the python packages you use, for example if an open source project needs specific package versions.

Important

You cannot install python packages to the system python installation. You have to create a python virtual environment and install packages to that.

Caution

Be careful when installing packages, because you may accidentally fill up your home folder storage quota.

Here’s how to avoid that.

Python and Virtual Environments

So let’s assume we loaded and started an academic-ml environment as described above or at the very leastran

$ module load python3

Note that it comes with many packages already installed, but not necessarily the version or packages you need for your project.

Run pip list to find out.

To install additional packages, you first have to create a virtual environment and then install the packages there.

Installing Packages into Virtual Environment

In this process, you will create a python virtual environment outside of your home directory and invoke it.

The SCC instructions use virtualenv. Below we use venv. You may also consider using the pipenv framework. The process is similar for each.

Load the python version you plan to use.

$ module load python3

Now create the virtual environment in the /projectnb/dl4ds/students/<your-username> space.

$ python3 -m venv .venv

Then you can activate the virtual environment

$ source .venv/bin/activate

To install additional packages you only need to run a simple pip command:

$ pip install packagename

and finally to deactivate the virtual environment, just type

$ deactivate

as usual.

Package Caches

You may find that even though you create and run virtual environments on your project folder, you get quote exceeded error for your home directory. This could be because conda or pip are caching python installation packages in your home directory.

Note: As of February 4, 2026, caching in PIP seems to be disabled.

Package Caches – Conda

For Conda, try running

conda info

And look for the section called package cache :. See shared-pkg-cache for a little more info.

As example, for me:

$ conda info
     active environment : base
    active env location : /share/pkg.8/miniconda/24.5.0/install
            shell level : 1
       user config file : /usr2/faculty/tgardos/.condarc
 populated config files : /share/pkg.8/miniconda/24.5.0/install/.condarc
                          /usr2/faculty/tgardos/.condarc
          conda version : 24.5.0
    conda-build version : not installed
         python version : 3.12.4.final.0
   
   ...

          package cache : /projectnb/ds549/tgardos/.conda/pkgs
                          /usr2/faculty/tgardos/.conda/pkgs
       envs directories : /share/pkg.8/academic-ml/fall-2024/install
                          /projectnb/ds549/tgardos/.conda/envs
                          /usr2/faculty/tgardos/.conda/envs
                          /share/pkg.8/miniconda/24.5.0/install/envs
...

Package Caches – PIP

Note: As of February 4, 2026, caching in PIP seems to be disabled.

For PIP, try running

pip cache dir
pip cache info

to find out more about where pip is caching. See caching for more info.

Back to top