Installation

pip

The simplest way to install PySUS is via pip:

pip install pysus

For the terminal user interface (TUI):

pip install pysus[tui]

A pre-built JupyterLab image is available on Docker Hub:

docker pull alertadengue/pysus
docker run -p 8888:8888 alertadengue/pysus

Or build locally and start the container:

docker compose -f docker/docker-compose.yaml up --build

Then open http://127.0.0.1:8888/lab in your browser.

Stop the container with:

docker compose -f docker/docker-compose.yaml down

Using Conda:

conda env create -f conda/dev.yaml
conda activate pysus

Using Poetry:

poetry install

By default, downloaded files are cached in ~/pysus. Override this with the PYSUS_CACHEPATH environment variable:

import os
os.environ["PYSUS_CACHEPATH"] = "/my/custom/path"