Skip to content

# Installation Guide

PG-RAD is a Python 3.12 package and is only tested on x86_64 Linux systems. The following installation instructions were testing for a fresh virtual machine running Ubuntu 26.04 LTS.

### Conda installation (Tested and recommended)

1. Install git by `sudo apt update && sudo apt install git`
2. Install miniforge by following these instructions.

3. Create a file called `environment.yml`, and paste the following in there:

       name: my-pgrad-env
       channels:
         - conda-forge
       dependencies:
         - python=3.12
         - pip:
           - git+ssh://git@github.com/pim-n/pg-rad.git@v0.1.1

   You can replace the name of the environment if desired.

4. Run `conda env create -f environment.yml` to create the environment

5. Run `conda activate my-pgrad-env`. You should now be in the conda environment `my-pgrad-env`.
6. To test if installation was succesful, run `pgrad --example --show`. If this runs without errors and produces visual output, PG-RAD is correctly installed.

### Manual installation

If you prefer another virtual environment, you still need git installed. Ensure the Python version of the environment is `>3.12.4` and `<3.13`. Then, with your virtual environment activated, run `pip install git+ssh://git@github.com/pim-n/pg-rad.git@main`. Run `pgrad --example --show` to check if the installation was successful.

### Usage

For usage, see the Quickstart Guide.