Linux, Mac or Windows OS

Most users run GENEC on Linux servers or Mac laptops.

If you are new to Linux, it is worth learning about it and things like Bash/shell. Here are some resources:

https://learn.microsoft.com/en-us/windows/wsl/tutorials/linux

If you want to learn more about git, bash and high-performance computing (HPC), DiRAC has great courses and tutorials that people everyone can take: https://training-academy.dirac.ac.uk/.

While we maintain the code on Linux (and Mac) OS, it is also possible to run the code on a Windows device by installing and using "Windows sub-Linux" (WSL).

You can find WSL installation instructions here: https://learn.microsoft.com/en-us/windows/wsl/install.

To start WSL, use the Windows PowerShell terminal and run the command "wsl" to start WSL. You can open windows from WSL. More info on GUI and X11 forwarding here: https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps.

Once WSL is installed, you can save the relevant environment variables (see GENEC manual) in your ~/.bashrc file like you would do on Linux and carry on with the main manual and the main Wiki page: https://github.com/GESEG/GENEC/wiki.