Installation

ESO is a Python package with an optional PyQt5 GUI. Supported Python versions: 3.8 to 3.12.

Clone

git clone https://github.com/ufuk-cakir/ESO.git
cd ESO

Create an environment

venvuvconda

python -m venv .venv
source .venv/bin/activate          # macOS / Linux
# .venv\Scripts\activate           # Windows

uv venv
source .venv/bin/activate

conda create -n eso python=3.11
conda activate eso

Install PyTorch

PyTorch is not pinned. Choose a wheel that matches your hardware. The official selector generates the right command.

CUDA 12.6CPU onlymacOS (MPS)

pip install torch --index-url https://download.pytorch.org/whl/cu126

pip install torch --index-url https://download.pytorch.org/whl/cpu

pip install torch

Install ESO

pip install -e .

For development with tests and docs:

pip install -e ".[tests,docs]"

Verify

python -c "from eso import ESO; print(ESO)"

If this prints the class object without an ImportError, the install is good.

Next

• First run. A minimal end-to-end experiment.
• GUI. The same pipeline driven by a graphical interface.