# hydrahash/zero-shot-energy-forecasting architecture

> Architecture diagram of the GitHub repository hydrahash/zero-shot-energy-forecasting, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hydrahash/zero-shot-energy-forecasting
- Repository: https://github.com/hydrahash/zero-shot-energy-forecasting

## Overview

This repository is an experimental benchmark for zero-shot industrial electricity-demand forecasting. Users provide 15-minute load profiles, run model-specific inference across four context/horizon configurations, aggregate prediction batches into metrics, and explore results in a Streamlit dashboard. The graph preserves the documented statistical and supervised baselines and the model families present in the tree. README statements support the overall inference-to-analysis workflow; unsampled model implementations are represented by their listed source paths, without implying unverified internal calls.

Main entry points: [`baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py`](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py) (TSMixer Inference), [`baselines/statistical_models/vectorized_predictions.py`](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/statistical_models/vectorized_predictions.py) (Statistical Baselines), [`baselines/model_tsmixer/tsmixer/cnn_prediction_batch.py`](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/cnn_prediction_batch.py) (CNN Baseline), [`model_Chronos/zs_forecast_base.py`](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Chronos/zs_forecast_base.py) (Chronos-2)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inference["Forecast Inference"]
  node_stat_baselines["Statistical Baselines"]
  node_cnn_baseline["CNN Baseline"]
  node_tsmixer_batch["TSMixer Inference"]
  node_rev_norm["Reversible Norm<br/>[tsmixer_revin.py]"]
  node_chronos2["Chronos-2"]
  node_chronos_bolt["Chronos-Bolt"]
  node_kairos["Kairos"]
  node_moirai["Moirai<br/>[zs_forecast.py]"]
  node_moment["Moment-1"]
  node_timellm["Time-LLM<br/>[run_timellm_tsz.py]"]
  node_sundial["Sundial"]
  node_timer["Timer"]
  node_timesfm["TimesFM 2.5<br/>[zs_forecast.py]"]
  node_timesfm3["TimesFM 3.0<br/>[zs_forecast_v3.py]"]
  node_tirex["TiRex<br/>[forecast_zs.py]"]
  node_prediction_batches["Prediction Batches"]
end

subgraph group_analysis["Metric Analysis"]
  node_metric_export["Metric Export<br/>[export_metrics.py]"]
  node_seasonal_metrics["Seasonal Metrics"]
  node_master_store[("Master Metrics")]
  node_seasonal_store[("Seasonal Dataset")]
end

subgraph group_dashboard["Evaluation Dashboard"]
  node_dashboard_app["Benchmark Dashboard<br/>[dashboard.py]"]
end

subgraph group_tsmixer_example["TSMixer Example"]
  node_example_loader["Example Data Loader<br/>[data_loader.py]"]
  node_example_runner["Example Runner<br/>[run.py]"]
end

node_load_profiles["Load Profiles"]
node_user(("Analyst"))

node_load_profiles -->|"provides input"| node_stat_baselines
node_load_profiles -->|"provides input"| node_cnn_baseline
node_load_profiles -->|"provides input"| node_tsmixer_batch
node_load_profiles -->|"provides input"| node_chronos2
node_load_profiles -->|"provides input"| node_chronos_bolt
node_load_profiles -->|"provides input"| node_kairos
node_load_profiles -->|"provides input"| node_moirai
node_load_profiles -->|"provides input"| node_moment
node_load_profiles -->|"provides input"| node_timellm
node_load_profiles -->|"provides input"| node_sundial
node_load_profiles -->|"provides input"| node_timer
node_load_profiles -->|"provides input"| node_timesfm
node_load_profiles -->|"provides input"| node_timesfm3
node_load_profiles -->|"provides input"| node_tirex
node_stat_baselines -->|"writes predictions"| node_prediction_batches
node_cnn_baseline -->|"writes predictions"| node_prediction_batches
node_tsmixer_batch -->|"writes predictions"| node_prediction_batches
node_chronos2 -->|"writes predictions"| node_prediction_batches
node_chronos_bolt -->|"writes predictions"| node_prediction_batches
node_kairos -->|"writes predictions"| node_prediction_batches
node_moirai -->|"writes predictions"| node_prediction_batches
node_moment -->|"writes predictions"| node_prediction_batches
node_timellm -->|"writes predictions"| node_prediction_batches
node_sundial -->|"writes predictions"| node_prediction_batches
node_timer -->|"writes predictions"| node_prediction_batches
node_timesfm -->|"writes predictions"| node_prediction_batches
node_timesfm3 -->|"writes predictions"| node_prediction_batches
node_tirex -->|"writes predictions"| node_prediction_batches
node_prediction_batches -->|"aggregates"| node_metric_export
node_prediction_batches -->|"derives seasons"| node_seasonal_metrics
node_metric_export -->|"writes metrics"| node_master_store
node_seasonal_metrics -->|"writes metrics"| node_seasonal_store
node_user -->|"explores results"| node_dashboard_app
node_master_store -->|"loads metrics"| node_dashboard_app
node_example_runner -->|"loads datasets"| node_example_loader
node_tsmixer_batch -->|"uses normalization"| node_rev_norm

click node_stat_baselines "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/statistical_models/vectorized_predictions.py"
click node_cnn_baseline "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/cnn_prediction_batch.py"
click node_tsmixer_batch "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py"
click node_rev_norm "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/tsmixer_revin.py"
click node_chronos2 "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Chronos/zs_forecast_base.py"
click node_chronos_bolt "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Chronos/zs_forecast_bolt.py"
click node_kairos "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Kairos/zs_forecast_kairos.py"
click node_moirai "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Moirai2/uni2ts/zs_forecast.py"
click node_moment "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Moment1/zs_forecast_moment.py"
click node_timellm "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimeLLM/Time-LLM/run_timellm_tsz.py"
click node_sundial "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Timer_Sundial/zs_forecast_sundial.py"
click node_timer "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Timer_Sundial/zs_forecast_timer.py"
click node_timesfm "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimesFM/timesfm/zs_forecast.py"
click node_timesfm3 "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimesFM/timesfm/zs_forecast_v3.py"
click node_tirex "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Tirex/forecast_zs.py"
click node_metric_export "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/export_metrics.py"
click node_seasonal_metrics "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/generate_seasonal_metrics.py"
click node_master_store "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/master_metrics.parquet"
click node_seasonal_store "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/seasonal_monthly_metrics.parquet"
click node_dashboard_app "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/dashboard.py"
click node_example_loader "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/get_started_example/data_loader.py"
click node_example_runner "https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/get_started_example/run.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stat_baselines,node_cnn_baseline,node_tsmixer_batch,node_rev_norm,node_chronos2,node_chronos_bolt,node_kairos,node_moirai,node_moment,node_timellm,node_sundial,node_timer,node_timesfm,node_timesfm3,node_tirex,node_prediction_batches toneBlue
class node_metric_export,node_seasonal_metrics,node_master_store,node_seasonal_store toneAmber
class node_dashboard_app toneMint
class node_example_loader,node_example_runner toneRose
class node_load_profiles,node_user toneIndigo
```

## Components

### Forecast Inference

- [Statistical Baselines](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/statistical_models/vectorized_predictions.py): `baselines/statistical_models/vectorized_predictions.py`
- [CNN Baseline](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/cnn_prediction_batch.py): `baselines/model_tsmixer/tsmixer/cnn_prediction_batch.py`
- [TSMixer Inference](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py): `baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py`
- [Reversible Norm](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/tsmixer_revin.py): `baselines/model_tsmixer/tsmixer/tsmixer_revin.py`
- [Chronos-2](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Chronos/zs_forecast_base.py): `model_Chronos/zs_forecast_base.py`
- [Chronos-Bolt](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Chronos/zs_forecast_bolt.py): `model_Chronos/zs_forecast_bolt.py`
- [Kairos](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Kairos/zs_forecast_kairos.py): `model_Kairos/zs_forecast_kairos.py`
- [Moirai](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Moirai2/uni2ts/zs_forecast.py): `model_Moirai2/uni2ts/zs_forecast.py`
- [Moment-1](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Moment1/zs_forecast_moment.py): `model_Moment1/zs_forecast_moment.py`
- [Time-LLM](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimeLLM/Time-LLM/run_timellm_tsz.py): `model_TimeLLM/Time-LLM/run_timellm_tsz.py`
- [Sundial](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Timer_Sundial/zs_forecast_sundial.py): `model_Timer_Sundial/zs_forecast_sundial.py`
- [Timer](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Timer_Sundial/zs_forecast_timer.py): `model_Timer_Sundial/zs_forecast_timer.py`
- [TimesFM 2.5](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimesFM/timesfm/zs_forecast.py): `model_TimesFM/timesfm/zs_forecast.py`
- [TimesFM 3.0](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_TimesFM/timesfm/zs_forecast_v3.py): `model_TimesFM/timesfm/zs_forecast_v3.py`
- [TiRex](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/model_Tirex/forecast_zs.py): `model_Tirex/forecast_zs.py`
- **Prediction Batches**

### Metric Analysis

- [Metric Export](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/export_metrics.py): `analysis/export_metrics.py`
- [Seasonal Metrics](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/generate_seasonal_metrics.py): `analysis/generate_seasonal_metrics.py`
- [Master Metrics](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/master_metrics.parquet): `analysis/master_metrics.parquet`
- [Seasonal Dataset](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/seasonal_monthly_metrics.parquet): `analysis/seasonal_monthly_metrics.parquet`

### Evaluation Dashboard

- [Benchmark Dashboard](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/analysis/dashboard.py): `analysis/dashboard.py`

### TSMixer Example

- [Example Data Loader](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/get_started_example/data_loader.py): `baselines/model_tsmixer/tsmixer/get_started_example/data_loader.py`
- [Example Runner](https://github.com/hydrahash/zero-shot-energy-forecasting/blob/main/baselines/model_tsmixer/tsmixer/get_started_example/run.py): `baselines/model_tsmixer/tsmixer/get_started_example/run.py`

### Other components

- **Load Profiles**
- **Analyst**

## Connections

- Load Profiles → Statistical Baselines: provides input (evidence: `README.md`)
- Load Profiles → CNN Baseline: provides input (evidence: `README.md`)
- Load Profiles → TSMixer Inference: provides input (evidence: `README.md`)
- Load Profiles → Chronos-2: provides input (evidence: `README.md`)
- Load Profiles → Chronos-Bolt: provides input (evidence: `README.md`)
- Load Profiles → Kairos: provides input (evidence: `README.md`)
- Load Profiles → Moirai: provides input (evidence: `README.md`)
- Load Profiles → Moment-1: provides input (evidence: `README.md`)
- Load Profiles → Time-LLM: provides input (evidence: `README.md`)
- Load Profiles → Sundial: provides input (evidence: `README.md`)
- Load Profiles → Timer: provides input (evidence: `README.md`)
- Load Profiles → TimesFM 2.5: provides input (evidence: `README.md`)
- Load Profiles → TimesFM 3.0: provides input (evidence: `README.md`)
- Load Profiles → TiRex: provides input (evidence: `README.md`)
- Statistical Baselines → Prediction Batches: writes predictions (evidence: `README.md`)
- CNN Baseline → Prediction Batches: writes predictions (evidence: `README.md`)
- TSMixer Inference → Prediction Batches: writes predictions (evidence: `README.md`)
- Chronos-2 → Prediction Batches: writes predictions (evidence: `README.md`)
- Chronos-Bolt → Prediction Batches: writes predictions (evidence: `README.md`)
- Kairos → Prediction Batches: writes predictions (evidence: `README.md`)
- Moirai → Prediction Batches: writes predictions (evidence: `README.md`)
- Moment-1 → Prediction Batches: writes predictions (evidence: `README.md`)
- Time-LLM → Prediction Batches: writes predictions (evidence: `README.md`)
- Sundial → Prediction Batches: writes predictions (evidence: `README.md`)
- Timer → Prediction Batches: writes predictions (evidence: `README.md`)
- TimesFM 2.5 → Prediction Batches: writes predictions (evidence: `README.md`)
- TimesFM 3.0 → Prediction Batches: writes predictions (evidence: `README.md`)
- TiRex → Prediction Batches: writes predictions (evidence: `README.md`)
- Prediction Batches → Metric Export: aggregates (evidence: `README.md`)
- Prediction Batches → Seasonal Metrics: derives seasons (evidence: `README.md`)
- Metric Export → Master Metrics: writes metrics (evidence: `README.md`)
- Seasonal Metrics → Seasonal Dataset: writes metrics (evidence: `README.md`)
- Analyst → Benchmark Dashboard: explores results (evidence: `README.md`)
- Master Metrics → Benchmark Dashboard: loads metrics (evidence: `analysis/dashboard.py`)
- Example Runner → Example Data Loader: loads datasets (evidence: `baselines/model_tsmixer/tsmixer/get_started_example/run.py`)
- TSMixer Inference → Reversible Norm: uses normalization (evidence: `baselines/model_tsmixer/tsmixer/tsmixer_prediction_batch.py`)
