Alternative installation methods#

hpcFlow CLI#

The hpcFlow CLI can be installed on Linux, macOS, and Windows through a terminal or shell prompt:

Open a terminal, paste the command shown below and press enter.

(touch tmp.sh && curl -fsSL https://raw.githubusercontent.com/hpcflow/install-scripts/main/src/install-hpcflow.sh > tmp.sh && bash tmp.sh --prerelease --path --univlink) ; rm tmp.sh

Open a Powershell terminal, paste the command shown below and press enter.

& $([scriptblock]::Create((New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/hpcflow/install-scripts/main/src/install-hpcflow.ps1'))) -PreRelease -UnivLink

What does this script do?

The above command downloads a script from the hpcFlow GitHub repository and runs it. The script does the following:

  1. It downloads the latest prerelease version of hpcFlow zip archived in a single folder.

  2. The archive is extracted and the folder placed in an accessible location. The location depends on the operating system. In Linux it is /.local/share/hpcflow. In macOS it is ~/Library/Application Support/hpcflow. In Windows it is Username\AppData\Local\hpcflow.

  3. A symbolic link (Linux/macOS) or an alias pointing to the file is created. This allows hpcFlow to be run by entering a simple command.

  4. A command is added to .bashrc/.zshrc (linux/macOS) or the Powershell profile (Windows) that allows hpcFlow to be run from any folder.

If the script detects that the version of hpcFlow it is trying to install is already there, it will stop running and exit.

Hint

If you are installing hpcFlow on an HPC resource, check that you can connect to the internet first. You might need to load a proxy module, for example.

Download CLI binaries (advanced)#

Binaries are available in two formats, corresponding to the two different formats that PyInstaller can generate:

  • A single executable file containing everything.

  • A folder containing an executable and supporting files.

Click below to download the hpcFlow binary for your platform:

Linux executablehpcflow-v0.2.0a236-linux
Linux folderhpcflow-v0.2.0a236-linux-dir.zip
macOS executablehpcflow-v0.2.0a236-macOS
macOS folderhpcflow-v0.2.0a236-macOS-dir.zip
Windows folderhpcflow-v0.2.0a236-win-dir.zip
Windows executablehpcflow-v0.2.0a236-win.exe

Note

These two installation methods (via the shell command above or via manually downloading a binary executable) do not require any system dependencies like Python. However, the Linux versions do require a minimum version of the GNU C library (GLIBC). Currently, this minimum version is 2.28 (dated 2018). To find out which version of GLIBC you have, run ldd --version on your Linux machine.