FAQ / Troubleshooting

Known Limitations

• Several TODO markers in worldsar indicate pending support improvements (metadata reorganization, extended modality support).
• Some APIs expose behavior primarily through implementation without full docstring detail.
• SNAP-based flows depend on external installation/runtime state.

Frequent Issues

GPT not found

Set --gpt-path or ensure gpt is on PATH and SNAP is installed.

Grid file missing

Set GRID_PATH or provide a *.geojson file under ./grid/ before running compose targets. The container does not generate grids automatically.

Upload authentication failure

Set HF_TOKEN or run Hugging Face CLI login before sarpyx upload.

Fixes

# SNAP / GPT
which gpt

# Grid precheck
make check-grid

# Container diagnostics
make logs

# CLI help sanity
sarpyx --help