Testing¶
The IONIS validation suite lets you verify the V20 model against your own operating experience. Install the package, run the tests, predict your paths, and tell us what the model gets wrong.
This is end-user model testing — you do not need ClickHouse, training scripts, or any understanding of the IONIS pipeline. Everything runs locally with the shipped checkpoint.
What You Can Do¶
| Command | Purpose |
|---|---|
ionis-validate test |
Run the full 62-test automated battery |
ionis-validate predict |
Predict a single HF path from your grid |
ionis-validate custom |
Batch-test your own paths from a JSON file |
ionis-validate report |
Generate a structured report for GitHub Issues |
ionis-validate info |
Show model version, system info, and diagnostics |
ionis-validate ui |
Launch browser-based validation dashboard |
Requirements¶
- Python 3.9+ for CLI tools
- Python 3.10+ for Browser UI
- ~1 GB disk (PyTorch + model checkpoint)
- No GPU required (CPU inference)
- No database, no special hardware
- Works on Windows, macOS, and Linux
Quick Start¶
See Getting Started for platform-specific setup instructions.
Documentation¶
- Getting Started — Installation and first run
- Beta Test Plan — Step-by-step testing checklist (start here after install)
- Test Suite — What the 62 tests cover and how to read results
- Single Path Prediction — Predict any HF path from the command line
- Custom Path Tests — Define your own test paths in JSON
- Reporting Issues — How to file feedback and what to include