OpenSTEF
What is OpenSTEF
OpenSTEF (Open Short-Term Energy Forecasting) is an open-source, model-agnostic Python framework for creating short-term forecasts in the energy sector. It provides complete machine learning pipelines for data preprocessing, feature engineering, model training, probabilistic forecasting, and evaluation. Version 4.0.0 introduces a complete architectural refactor with enhanced modularity, full type safety, and modern Python development practices.
For more information, visit the OpenSTEF project page at LF Energy.
Monorepo Overview
OpenSTEF 4.0.0 is organized as a monorepo with specialized packages under the packages/ directory:
| Package | Purpose |
|---|---|
| openstef | Meta-package installing all core components |
| openstef-core | Core utilities, dataset types, shared types and base models |
| openstef-models | ML models, feature engineering, data processing |
| openstef-beam | Backtesting, Evaluation, Analysis, and Metrics |
| openstef-meta | Meta models for OpenSTEF |
How to Install
Requirements: Python ≥3.12, 64-bit OS (Windows, macOS, Linux)
# Minimal-but-runnable convenience layer (core + models with CPU XGBoost)
pip install openstef
# Everything, CPU flavour
pip install "openstef[all]"
# Or install individual packages
pip install openstef-models
pip install openstef-beam
pip install openstef-core
# Optional feature extras (additive)
pip install "openstef-models[lgbm]"
pip install "openstef-models[tuning]"
pip install "openstef-beam[all]"
Compute runtimes (pick one per package). Packages with a heavy runtime ship mutually exclusive CPU and GPU builds as conflicting extras — install one, not both:
# Foundation models (Chronos-2): CPU everywhere, GPU on CUDA Linux/Windows
pip install "openstef-foundation-models[cpu]"
pip install "openstef-foundation-models[gpu]"
# XGBoost models: CPU or GPU
pip install "openstef-models[xgb-cpu]"
pip install "openstef-models[xgb-gpu]"
The openstef meta-package always ships the CPU builds; for GPU, install the
component package directly with its [gpu] extra.
Using uv (recommended for development):
uv add openstef
For the complete installation guide including troubleshooting, see the Installation Documentation.
Examples
Tutorials and usage examples are available in the examples/ folder. See the examples folder's own README.md for an overview of available examples including:
- Forecasting quickstart
- Feature engineering
Additional tutorials are available in the online documentation.
License
Mozilla Public License Version 2.0 - see LICENSE.md for details.
This project includes third-party libraries licensed under their respective Open-Source licenses. SPDX-License-Identifier headers show applicable licenses. License files are in the LICENSES/ directory.
Contributing
We welcome contributions to OpenSTEF 4.0!
Read our Contributing Guide - documentation for contributors including:
- How to report bugs and suggest features
- Documentation improvements and examples
- Code contributions and development setup
- Sharing datasets and real-world use cases
Quick Development Setup
# Clone and set up for development (one command installs the full CPU dev env)
git clone https://github.com/OpenSTEF/openstef.git
cd openstef
uv sync
# Run tests and quality checks
uv run poe all
GPU dev env (CUDA; Linux/Windows):
uv sync --no-default-groups --group dev-gpu. Do not use--all-groups/--all-extras— the CPU and GPU runtimes conflict.
Code of Conduct: We follow the Contributor Code of Conduct to ensure a welcoming environment for all contributors.
Citations
If you use OpenSTEF in your research or publications, please cite the project. Refer to the CITATION.cff file in this repository for the preferred citation format, or use:
Contributors to the OpenSTEF project. OpenSTEF — Open Short-Term Energy Forecasting. LF Energy, 2017–2025. Available at: https://github.com/OpenSTEF/openstef
Contact
- Slack: LF Energy Slack
- Email: openstef@lfenergy.org
- Community meeting: OpenSTEF four-weekly community meeting
- Issues: GitHub Issue Tracker
- Support Guide: How to get help
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openstef-4.2.2.tar.gz.
File metadata
- Download URL: openstef-4.2.2.tar.gz
- Upload date:
- Size: 3.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
251a2057ec011dda9707dc66793678300a88f3f5b20e5787a07ba5874e5ee1c5
|
|
| MD5 |
d03066d4bb865666e24b60b1dda0724a
|
|
| BLAKE2b-256 |
5f35e4a346336aa880dc5b2167875255ed47b164fecfba63dad449655a72e465
|
Provenance
The following attestation bundles were made for openstef-4.2.2.tar.gz:
Publisher:
release-v4.yaml on OpenSTEF/openstef
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openstef-4.2.2.tar.gz -
Subject digest:
251a2057ec011dda9707dc66793678300a88f3f5b20e5787a07ba5874e5ee1c5 - Sigstore transparency entry: 2369688007
- Sigstore integration time:
-
Permalink:
OpenSTEF/openstef@cfb058916c6178b7fbe430237208afd45cd38d56 -
Branch / Tag:
refs/tags/v4.2.2 - Owner: https://github.com/OpenSTEF
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-v4.yaml@cfb058916c6178b7fbe430237208afd45cd38d56 -
Trigger Event:
release
-
Statement type:
File details
Details for the file openstef-4.2.2-py3-none-any.whl.
File metadata
- Download URL: openstef-4.2.2-py3-none-any.whl
- Upload date:
- Size: 9.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c720817d34f7fd81b1bbd50bc67cd6b47b7dc4b7e8bde3bd244e760577998384
|
|
| MD5 |
90b338b3d3124bc4dd184a4b3187b2ec
|
|
| BLAKE2b-256 |
f1692c9353072f43add217663e9d8f9395c6a28213d04b21153a601f7905ad55
|
Provenance
The following attestation bundles were made for openstef-4.2.2-py3-none-any.whl:
Publisher:
release-v4.yaml on OpenSTEF/openstef
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openstef-4.2.2-py3-none-any.whl -
Subject digest:
c720817d34f7fd81b1bbd50bc67cd6b47b7dc4b7e8bde3bd244e760577998384 - Sigstore transparency entry: 2369687258
- Sigstore integration time:
-
Permalink:
OpenSTEF/openstef@cfb058916c6178b7fbe430237208afd45cd38d56 -
Branch / Tag:
refs/tags/v4.2.2 - Owner: https://github.com/OpenSTEF
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-v4.yaml@cfb058916c6178b7fbe430237208afd45cd38d56 -
Trigger Event:
release
-
Statement type:
