🚀 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.

⚠️ 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

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

(galactic) $ pip install \
  --extra-index-url https://www.thegalactic.org/pypi/simple/ \
  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

To remove the environment completely:

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

On an Ubuntu 24.04 system (inluding 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

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

(galactic) $ pip install \
  --extra-index-url https://www.thegalactic.org/pypi/simple/ \
  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

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

(galactic) $ deactivate
$ rm -rf galactic

🚧 To be completed… 🚧