Demos
Every demo uses real public data (provenance: forecast-datasets/MANIFEST.md). Each lives in its own folder of forecast-demos/.
The reference demo: US retail sales
04 · US retail sales: 2026 budget, reality check, 2027 re-forecast
A retail analytics team forecasts monthly sales of 20 kinds of business (US Census Monthly Retail Trade, millions of USD) for the 2026 budget, from 11 years of history. In September 2026, with eight months of real 2026 sales published, it checks how good the budget forecast was, then re-forecasts to December 2027.
| File | What |
|---|---|
input/spec.budget.xlsx | the workbook: Setup + Data (20 series × 132 months, 2015 – 2025) |
input/spec.reforecast.xlsx | the same with 2026 actuals to August (140 months) |
SCENARIO.md | the business story, the data, what to show |
EXPECTED_RESULTS.md | the engine's results, and the budget forecast against the real 2026 months |
DEMO_SCRIPT.md | step by step, what to click and what to say |
_generate.py · _run.py · _check.py | rebuild the specifications, run them through the engine, check against the actuals |
AI-assistance demos
Short demos of the per-step AI assist panel: paste plain language, get the fields drafted.
| # | Demo | Data |
|---|---|---|
| 01 | Retail demand, monthly | AirPassengers, 144 months |
| 02 | Insurance claims, weekly | US weekly jobless claims, 261 weeks |
| 03 | Contact-centre workload, daily | daily births, 365 days |
How to run them: forecast-demos/README.md.
Rebuilding a demo workbook
python -I forecast-demos/04-us-retail-sales-budget/_generate.py
node forecast-wizard/tools/make-demo-kit.mjs forecast-demos/04-us-retail-sales-budget/spec.budget.json
node forecast-wizard/tests/demo-kits.test.mjs