Quickstart

Installation

From the repository root:

pip install -e /path/to/eikonet
pip install -e .

Optional extras:

pip install -e '.[wandb]'

Minimal workflow

Use the example config in example/SPIDER_example.json.

# Phase 1 (MAP)
spider locate-map example/SPIDER_example.json --device 0

# Phase 2-4 (sampling)
spider sample example/SPIDER_example.json --device 0

Multi-GPU independent chains:

spider sample-multi example/SPIDER_example.json --devices 0,1,2,3

Validate configuration first

spider validate-config example/SPIDER_example.json --mode sample

Outputs

Paths are controlled by the io block:

  • io.catalog_outfile

  • io.samples_outfile

  • io.checkpoint_dir