Windows

Windows#

HTTomo requires Linux and cannot run directly on Windows. On supported versions of Windows, HTTomo can be run using Windows Subsystem for Linux 2 (WSL 2).

These instructions require Windows 10 version 2004 (build 19041) or later, or Windows 11. GPU acceleration additionally requires a supported NVIDIA GPU and an NVIDIA Windows driver that supports CUDA in WSL.

See the following documentation before continuing:

Installation steps#

Open PowerShell or Windows Terminal as an administrator.
Install WSL and its default Ubuntu distribution:
```
wsl --install
```
Restart Windows when prompted. Then open Ubuntu from the Start menu and complete the initial Linux user setup.
Confirm that the distribution is using WSL 2:
```
wsl --list --verbose
```
If necessary, replace Ubuntu below with the distribution name shown by the preceding command:
```
wsl --set-version Ubuntu 2
```
Inside the WSL terminal, update the package index and install the required build tools:
```
$ sudo apt update
$ sudo apt install build-essential wget
```

Download and install Miniforge inside WSL:

$ wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh
$ bash Miniforge3-Linux-x86_64.sh
$ source ~/.bashrc

The installer shown above is for x86-64 systems. Select a different Miniforge installer when using another architecture.

Follow the Conda instructions in Installation to create an environment and install HTTomo.
Run the verification commands in Installation.

Windows

Contents

Windows#

Installation steps#