1. Installation

This guide demonstrates how to set up RiSPICE locally.

Environment Setup

Create a Virtual Environment

python -m venv .venv
source .venv/bin/activate

Install Dependencies

CPU Only

pip install -r requirements-cpu.txt

CUDA (GPU)

pip install -r requirements-cuda.txt

Note: CUDA is recommended for significantly faster inference and model training.

Download the Model

Download the RiSPICE base model:

hf download paolomanlapaz/rispice-base --local-dir <BASE_MODEL_DIR>

Download the 1000 bp adapter:

hf download paolomanlapaz/rispice-1000bp --local-dir <ADAPTER_DIR>

Other available adapters:

• paolomanlapaz/rispice-750bp
• paolomanlapaz/rispice-500bp

Download the Empirical Background Distribution

The empirical background distributions are available on Zenodo:

DOI: https://doi.org/10.5281/zenodo.21639098

Download the archive corresponding to the adapter you selected:

Adapter	Background Distribution
1000 bp	background-dist-1000bp.zip
750 bp	background-dist-750bp.zip
500 bp	background-dist-500bp.zip