REHO 1.2.1
Renewable Energy Hub Optimizer (REHO) - A Decision Support Tool for Renewable Energy Communities
License: Apache-2.0
Requires Python: <3.12,>=3.9
Keywords: MILP, MOO decision support, sustainable energy systems, energy communities

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/IPESE/REHO/refs/heads/main/docs/images/logos/logo-reho-white.png">
  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/IPESE/REHO/refs/heads/main/docs/images/logos/logo-reho-black.png">
  <img width="300"  alt="Shows the IPESE logo, white one in dark color mode and black one in light color mode.">
</picture>

[![DOI](https://joss.theoj.org/papers/10.21105/joss.06734/status.svg)](https://doi.org/10.21105/joss.06734)
[![Documentation Status](https://readthedocs.org/projects/reho/badge/?version=main)](https://reho.readthedocs.io/)

[![PyPI](https://img.shields.io/pypi/v/REHO.svg)](https://pypi.org/project/REHO/)[![Python Version](https://img.shields.io/badge/Python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue)](https://pypi.org/project/REHO/)

[![License](https://img.shields.io/badge/license-Apache%202-blue)](https://www.apache.org/licenses/LICENSE-2.0)


Renewable Energy Hub Optimizer (REHO) is a decision support tool for sustainable urban energy system planning.
REHO simultaneously addresses the optimal design and operation of capacities, catering to multi-objective considerations
across economic, environmental, and efficiency criteria.

Key features:
* MILP Framework
* Multi-Objective Optimization
* Multi-Scale Capabilities
* Multi-Service Consideration
* Multi-Energy Integration
* Open-Source and Open-Data

For more information about the model foundations and features, please refer to the [REHO documentation](https://reho.readthedocs.io/en/main/).

## Authors
REHO is developed by EPFL (Switzerland), within the Industrial Process and Energy Systems Engineering (IPESE) group.

Dorsan Lepour <dorsan.lepour@epfl.ch>  
Cédric Terrier <cedric.terrier@epfl.ch>  
Joseph Loustau

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/IPESE/REHO/blob/main/docs/images/logos/ipese-logo-white.svg?raw=true">
  <source media="(prefers-color-scheme: light)" srcset="https://github.com/IPESE/REHO/blob/main/docs/images/logos/ipese-logo-black.svg?raw=true">
  <img width="300"  alt="Shows the IPESE logo, white one in dark color mode and black one in light color mode.">
</picture>

## Licence
Copyright (C) <2021-2025> <Ecole Polytechnique Fédérale de Lausanne (EPFL), Switzerland>

Licensed under the Apache License, (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Description and complete License: see LICENSE file.

## Installation

REHO is available as a [PyPI package](https://pypi.org/project/REHO/) and can be installed via pip with:
```
pip install --extra-index-url https://pypi.ampl.com REHO
```

Full code can be accessed from the [REHO GitHub repository](https://github.com/IPESE/REHO) and cloned with:
```
git clone https://github.com/IPESE/REHO.git
```

Please refer to "[Getting started](https://reho.readthedocs.io/en/main/sections/5_Getting_started.html)" section of the documentation for step-by-step guidelines.

## Suggestions and contributions
All suggestions or implementation must be tracked with dedicated issues and reported in the project repository.

Refer to "[Contribute](https://reho.readthedocs.io/en/main/sections/7_Contribute.html)" section of the documentation for further guidance.