HEAinstaller is a platform-agnostic (WSL/Linux/Darwin) and XDG-compliant Python script that automates the installation of HEASoft.

Note: Only supported on platforms using glibc.

If you want the script to automatically manage and install a temporary virtual environment:

git clone https://github.com/Anish-Sarkar-1001/HEAinstaller.git
cd HEAinstaller
python3 user_install.py

If you want to manually create or use an existing environment, follow the guide below.

• Virtual Environment Setup Guide
• Conda Environment Setup Guide

Note: If no active Conda/Virtual environment is detected, the script will use pip to install Python libraries. However, using a Conda/Virtual environment is preferred.

git clone https://github.com/Anish-Sarkar-1001/HEAinstaller.git
cd HEAinstaller
python3 heainstaller.py

Note: You will be prompted for your superuser password and asked to provide the heasoft-x.xx.x.tar.gz path if you have already downloaded it.

After installation, initialize HEASoft with:

heainit

• sudo is used. Install it manually on Alpine or other minimal systems.
• Setup is done without lynx to avoid errors in some distributions.

• The script is XDG-compliant and installs HEASoft at: $HOME/.local/bin/heasoft
• The downloaded tarball will be stored at: $XDG_CACHE_HOME/heasoft.tar.gz
• Edit user.json to skip installing specific HEASoft packages by setting values from yes to no.
• Refer to the HEASoft official documentation for dependency information.
• Progress bars are approximate (±1%).