Quickstart (Recommended: PyPI)¶

1. Install from PyPI¶

optional but recommended: create a Python virtual environment first

python3 -m venv .venv && source .venv/bin/activate
pip install wspr-ai-lite

Fetch WSPRNet monthly archives and load them into DuckDB:

wspr-ai-lite ingest --from 2014-07 --to 2014-07 --db data/wspr.duckdb

- Downloads compressed monthly CSVs (caches locally in .cache/) - Normalizes into data/wspr.duckdb - Adds extra fields (band, reporter grid, tx grid)

wspr-ai-lite ui --db data/wspr.duckdb --port 8501

Open http://localhost:8501 in your browser 🎉

👉 For developers who want to hack on the code directly, see Developer Setup.