Installation

Requirements

• Python >= 3.10

• Tkinter: part of the CPython standard library (there is no tkinter package on PyPI, so pip install tkinter does not work). It ships with most Python builds, including the conda-forge Python used below. If import tkinter fails:

  • conda: conda install tk

  • Debian / Ubuntu: sudo apt install python3-tk

  • Fedora: sudo dnf install python3-tkinter

  • macOS (python.org / Homebrew builds include Tk); with pyenv you may need brew install tcl-tk and a matching Python build.

• Scientific stack (installed automatically): numpy, pandas, scipy, matplotlib, astropy, astroquery, pytz, seaborn, requests, PyYAML.

Install with conda (recommended)

Create a dedicated environment with Python 3.10 (the conda-forge Python already bundles Tkinter, so nothing extra is needed):

conda create -n spino_env python=3.10
conda activate spino_env
pip install spino

From a source checkout, use an editable install instead of pip install spino:

conda create -n spino_env python=3.10
conda activate spino_env
cd SPINO
pip install -e .

Editable install with venv (for development)

cd SPINO
python -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install -e .

This installs the spino console entry point and all dependencies, and includes the bundled data files (src/spino/data/).

Plain install

pip install .

Run without installing

From a source checkout you can run directly if the dependencies are present:

pip install -r requirements.txt
python -m spino

Verifying the install

A fast, GUI-free smoke test that exercises the whole pipeline:

# write a minimal settings.json (see docs/usage.md) then:
python -m spino.runner settings.json

You should see the pipeline log and, on success, PDFs/CSVs under the configured OUTPUT_DIR.