Skip to content

Installation

module-manager expects two external command-line tools for a full workflow:

  • uv, when deploying Python tools with --execute-install
  • Environment Modules, when loading generated modulefiles

Install uv

Install uv with the official installer:

curl -LsSf https://astral.sh/uv/install.sh | sh

Verify it is available:

uv --version

Install Environment Modules on macOS

On macOS, install Environment Modules with Homebrew:

brew install modules

Initialize it for zsh:

source "$HOMEBREW_PREFIX/opt/modules/init/zsh"

Add that source line to ~/.zshrc if you want the module command available in every new shell.

Install module-manager

From PyPI with pip:

pip install env-module-manager

As a uv-managed tool:

uv tool install env-module-manager

From a local checkout:

uv tool install .

During development, use:

uv run module-manager --help