🚀 GALACTIC Installation Guide#

This document describes how to install GALACTIC.

Using Conda (Recommended)#

The setup uses a fully isolated Conda environment and does not modify system Python.

Attention

While GALACTIC may work on other Linux distributions or operating systems, this guide officially supports Ubuntu 24.04 with Conda.

We recommend Miniconda (lightweight and stable).

Download and install Miniconda from the official site: https://docs.conda.io/en/latest/miniconda.html

Choose an environment configuration based on your use case:

Use case	Filename
Default user install	`base.yml`

Create a dedicated environment (replace base.yml with your chosen file if needed):

$ conda env create -f base.yml

Activate the environment:

$ conda activate galactic

Verify Graphviz installation:

(galactic) $ dot -V

Initialize the GALACTIC environment to set up necessary directories and configurations:

(galactic) $ galactic config init

This will configure access to the GALACTIC public store.

Install any package from the GALACTIC ecosystem, for example the concept algebra via pip:

(galactic) $ pip install "galactic-algebra-concept[docs]"

Run a basic check:

(galactic) $ python -c "import galactic"

To explore tutorials and documentation, start the Jupyter notebook server:

(galactic) $ jupyter notebook $CONDA_PREFIX/share/galactic

Attention

Replace $CONDA_PREFIX with %CONDA_PREFIX% on Windows systems.

To remove the environment completely:

(galactic) $ conda deactivate
$ conda remove -n galactic --all

On an Ubuntu 24.04 system (including WSL on Windows), you can install the necessary dependencies and set up a virtual environment as follows:

Update package lists and upgrade existing packages

$ sudo apt update && sudo apt upgrade -y

Install Python 3 and related packages

$ sudo apt install python3 python3-venv python3-pip python-is-python3 -y

Install Graphviz for visualization

$ sudo apt install graphviz -y

Create a virtual environment for GALACTIC

$ python -m venv galactic

Activate the virtual environment

$ source galactic/bin/activate

(galactic) $ galactic config init

This will configure access to the GALACTIC public store.

Install any package from the GALACTIC ecosystem, for example the concept algebra via pip:

(galactic) $ pip install "galactic-algebra-concept[docs]"

Run a basic check:

(galactic) $ python -c "import galactic"

To explore tutorials and documentation, start the Jupyter notebook server:

(galactic) $ jupyter notebook $VIRTUAL_ENV/share/galactic

Attention

Replace $VIRTUAL_ENV with %VIRTUAL_ENV% on Windows systems.

To remove the virtual environment, simply delete the galactic directory:

(galactic) $ deactivate
$ rm -rf galactic