astrooracle 0.1.0

AstroOracle: active learning oracle for astronomical anomaly triage (SkyView cutouts + annotations + retrain hooks).

AstroOracle

AstroOracle is an active learning “oracle” for astronomical anomaly triage.

• Reads candidate detections from a Parquet file.
• Ranks them by uncertainty + optional embedding diversity.
• Pulls multi-survey cutouts from SkyView.
• Annotates via CLI (matplotlib) or Jupyter (ipywidgets + Plotly).
• Logs events in append-only JSONL.
• Optionally triggers retraining.

Install (editable)

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e ".[plotly,watch,notebook]"

Quickstart (CLI)

Generate sample candidates:

python examples/sample_candidates.py

Run oracle:

astrooracle run --candidates candidates.parquet --interval 300 --n-query 6

Headless + PNG export:

astrooracle run --no-gui --save-cutouts cutouts/ --candidates candidates.parquet

Jupyter UI

jupyter lab

Open examples/oracle_notebook.ipynb.

Watch mode (watchdog)

astrooracle watch --candidates candidates.parquet

Batch HTML export

astrooracle batch-html --candidates candidates.parquet --out-dir batch_out/ --n-query 60

Open batch_out/index.html and export annotations from the page.

License

MIT