Installation¶
Requirements:
- Linux, macOS or Windows. Supported Platforms explains what differs between them.
- Python ≥ 3.11.
On Windows, use Python 3.12.4 or later, or a 3.11 release from 3.11.10 on,
so that other users of the computer cannot connect to a running build,
see
STEPUP_RPC_TRANSPORT. Older versions are only safe whenTEMPlies in your user profile, which is the default. - Pip
- On Windows, a POSIX shell for the steps that need one, see POSIX Shell on Windows below.
It is assumed that you know how to use Pip. We recommend performing the installation in a Python virtual environment and activating such environments with direnv.
The core package can be installed with:
On Windows with Python 3.15, as of November 2026, the dependency PyYAML has no wheels yet, and building it from source fails without a C compiler. Its C extension, which StepUp does not use, can be left out of that build:
The StepUp RepRep extension (for reproducible reporting) is installed with:
POSIX Shell on Windows¶
A step created with shell=True runs its command in a POSIX shell,
and so does a local script whose shebang line names sh or bash.
Linux and macOS have such a shell as /bin/sh, but Windows has none.
A workflow without shell steps and shell scripts runs on Windows without a POSIX shell.
When a step needs a shell and StepUp finds none,
that step fails with a message that lists where StepUp looked.
The shell must be a POSIX shell that finds the usual Unix tools,
such as sed and grep, on its PATH.
Any of the following will do:
- Git for Windows, installed with its default options.
StepUp finds its shell through the
gitcommand onPATH, or through the registry whengitis not onPATH, so nothing needs to be configured. - MSYS2 or Cygwin,
with the directory that holds their
sh.exeonPATH, e.g.C:\msys64\usr\bin. - Any other POSIX shell, named by the environment variable
STEPUP_SHELL.
When STEPUP_SHELL is set, StepUp uses that shell and does not search.
The configuration reference
lists the order of the search.
To select the shell of Git for Windows with this variable, name its bin\sh.exe,
e.g. C:\Program Files\Git\bin\sh.exe.
Do not select Git’s usr\bin\sh.exe:
it does not add Git’s Unix tools to PATH,
so the commands of your steps would not find sed or grep.
StepUp never uses the bash.exe in the Windows directory (C:\Windows\System32),
because that program starts WSL and would run the command in Linux.
The shell of Git for Windows has a few peculiarities, which Supported Platforms describes.