ZEN-garden

Python Version from PEP 621 TOML

Welcome to the ZEN-garden! ZEN-garden is an optimization framework for energy transition pathways. It is currently used to model the electricity system, hydrogen value chains, and carbon capture, storage and utilization (CCUS) value chains. However, it is designed to be modular and flexible, and can be extended to model other types of energy systems, value chains or other network-based systems.

ZEN-garden is developed by the Reliability and Risk Engineering Laboratory at ETH Zurich.

Quick Start

To get started with ZEN-garden, you can follow the instructions in the installation guide.

If you want to use ZEN-garden without working on the codebase, run the following command:

pip install zen-garden

If you want to work on the codebase, fork and clone the repository and install the package in editable mode. More information on how to install the package in editable mode can be found in the installation guide.

Documentation

Please refer to the documentation of the ZEN-garden framework on Read-the-Docs. Additionally, example datasets are available in the dataset_examples folder and described in the documentation.

News

Review recent modifications outlined in the changelog.

Citing ZEN-garden

If you use ZEN-garden for research, please cite

Jacob Mannhardt, Alissa Ganter, Johannes Burger, Francesco De Marco, Lukas Kunz, Lukas Schmidt-Engelbertz, Paolo Gabrielli, Giovanni Sansavini (2025). ZEN-garden: Optimizing energy transition pathways with user-oriented data handling. https://www.sciencedirect.com/science/article/pii/S2352711025000263

and use the following BibTeX:

@article{ZENgarden2025,
title = {ZEN-garden: Optimizing Energy Transition Pathways with User-Oriented Data Handling},
author = {Mannhardt, Jacob and Ganter, Alissa and Burger, Johannes and De Marco, Francesco and Kunz, Lukas and {Schmidt-Engelbertz}, Lukas and Gabrielli, Paolo and Sansavini, Giovanni},
year = {2025},
journal = {SoftwareX},
volume = {29},
pages = {102059},
issn = {2352-7110},
doi = {10.1016/j.softx.2025.102059},
}

Metadata

Release files for zen-garden 3.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zen-garden 3.1.1
File	Size	Uploaded
zen_garden-3.1.1.tar.gz	197.4 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for zen-garden 3.1.1
File	Interpreter	ABI	Platform	Reset
zen_garden-3.1.1-py3-none-any.whl 331.2 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 528.6 kB

Release files / zen_garden-3.1.1.tar.gz

Download URL	zen_garden-3.1.1.tar.gz
Size	197.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`717f019c7aeca8804948b3c5d94241526d0ca39945017de8eca99cfc33fa2b8c`
BLAKE2b-256 checksum How to use checksums	`ef4dffc805b4cac3141b8fe6647f760834ea5b0579a085f73328a037b6183e36`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ZEN-universe/ZEN-garden
Publishing commit: github.com/ZEN-universe/ZEN-garden/tree/a8d0916793b038a8da596c53853fdb5926a6523b

Workflow

Publishing configuration: github.com/ZEN-universe/ZEN-garden/blob/a8d0916793b038a8da596c53853fdb5926a6523b/.github/workflows/bump_and_release.yml
Publishing logs: github.com/ZEN-universe/ZEN-garden/actions/runs/36712848810/attempts/1

Artifact

Subject: zen_garden-3.1.1.tar.gz
SHA-256 checksum: 717f019c7aeca8804948b3c5d94241526d0ca39945017de8eca99cfc33fa2b8c Verifying attestations

Release files / zen_garden-3.1.1-py3-none-any.whl

Download URL	zen_garden-3.1.1-py3-none-any.whl
Size	331.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0ca4e44a504007c5e9a3fd514602a2b90825283b1d10c97da695125142f42ce8`
BLAKE2b-256 checksum How to use checksums	`2cdc7c32b4ef4ef00f858193e4a4b586d65955b43060f55d7d4873e335ae0512`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ZEN-universe/ZEN-garden
Publishing commit: github.com/ZEN-universe/ZEN-garden/tree/a8d0916793b038a8da596c53853fdb5926a6523b

Workflow

Publishing configuration: github.com/ZEN-universe/ZEN-garden/blob/a8d0916793b038a8da596c53853fdb5926a6523b/.github/workflows/bump_and_release.yml
Publishing logs: github.com/ZEN-universe/ZEN-garden/actions/runs/36712848810/attempts/1

Artifact

Subject: zen_garden-3.1.1-py3-none-any.whl
SHA-256 checksum: 0ca4e44a504007c5e9a3fd514602a2b90825283b1d10c97da695125142f42ce8 Verifying attestations