KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness #windows #open-source

pypsa-spice

★ 23 Open GitHub ↗

PyPSA-SPICE: PyPSA-based Scenario Planning and Integrated Capacity Expansion Model Builder

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<picture align="center">
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/pypsa-logo_rgb_dark.svg">
  <img alt="PyPSA-spice banner" src="docs/assets/images/pypsa-logo_rgb.svg">
</picture>

# PyPSA-SPICE: PyPSA-based Scenario Planning and Integrated Capacity Expansion

[![License][license badge]][license]
[![PyPSA version][PyPSA version badge]][PyPSA version]
[![Snakemake][Snakemake badge]][Snakemake]
[![Code style][Code style badge]][Code style]

[license badge]: https://eddelbuettel.github.io/badges/GPL2+.svg
[license]: https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html

[PyPSA version badge]: https://img.shields.io/pypi/v/pypsa?label=pypsa
[PyPSA version]: https://pypi.org/project/pypsa/

[Snakemake badge]: https://img.shields.io/badge/snakemake-minimal==8.10.8-brightgreen.svg?style=flat
[Snakemake]: https://snakemake.readthedocs.io

[Code style badge]: https://img.shields.io/badge/code%20style-black-000000.svg
[Code style]: https://github.com/ambv/black

> [!TIP]
> If you are considering using this model builder, please reach out to us at [modelling@agora-thinktanks.org](mailto:modelling@agora-thinktanks.org). We would be happy to help you get started.
> If you encounter a bug, please create a [new issue](https://github.com/agoenergy/pypsa-spice/issues). For new ideas or feature requests, you can start a conversation in the [discussions](https://github.com/agoenergy/pypsa-spice/discussions) section of the repository.

[PyPSA-SPICE](https://agoenergy.github.io/pypsa-spice/) is an open-source model builder for assessing national mid-/long-term energy scenarios using a least-cost, multi-sectoral optimisation approach based on the [PyPSA](https://pypsa.org/) framework. It can be used to build models that represent one or more countries across multiple interconnected nodes linked by electricity transmission. Within each region, it models the integration of the power, heat, and transport sectors.

The model workflow has been designed to be more accessible compared to other PyPSA-based models, though basic Python coding knowledge is required.

<a href="docs/assets/images/pypsa-spice_intro.jpg">
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/pypsa-spice_intro.jpg">
  <img alt="PyPSA-SPICE_single_node_energy_flow" width="1000px" src="docs/assets/images/pypsa-spice_intro.jpg">
</picture>
</a>

## Quick installation

In order to install the application, first make sure you have _git_, _conda_ and optionally _mamba_ installed.

Then, clone the source code from GitHub onto your local machine and navigate into the `pypsa-spice` directory. Finally, use the provided `environment.yaml` file to create the _conda_ environment.

```bash
git clone https://github.com/agoenergy/pypsa-spice.git
cd pypsa-spice
conda env create -f envs/environment.yaml
```

> **Note:** _mamba_ is a faster replacement for _conda_, but its installation is not mandatory. You can use _conda_ instead if you prefer. For installation of _mamba_, please refer to the [installation Guide](docs/getting-started/installation.md#install-python-dependencies)

Once _mamba_ is installed, you can also create the environment more quickly using:

```bash
mamba env create -f envs/environment.yaml
```

## Execution of the model builder using template data

To have a first glance of how the model builder works, template data in [example](data/example/) folder can be used. The following command can be executed to run the whole workflow at once. The command will use 1 core (`-j1`) and 1 thread (`-c4`) to execute. For more information, please refer to the [snakemake documentation](https://snakemake.readthedocs.io/en/stable/executing/cli.html) to adjust the cores and threads to use.

```bash
snakemake -j1 -c4 solve_all_networks
```

or

```bash
snakemake -call
```

For more information, please follow the guidance in this documentation website.

## Citing PyPSA-SPICE

Please use the citation below:

- Agora Think Tanks (2025): PyPSA-SPICE: PyPSA-based Scenario Planning and Integrated Capacity Expansion

## Contributions

We welcome any contributions and additional spice to this project; please have a look
at [contributing guide](docs/contributing/contributing.md) and our [code of conduct](docs/contributing/code_of_conduct.md).
If you have any ideas, suggestions or encounter problems, feel free to file issues
or make pull requests on GitHub.

## Maintained by

<a href="https://www.agora-energiewende.org/">
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/Agora_EW.png">
  <img alt="Agora Energiewende" width="200px" src="docs/assets/images/Agora_EW.png">
</picture>
</a>

## Supported by

<table>
  <tr>
    <td align="center">
      <a href="https://caseforsea.org/">
        <picture>
          <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/CASE.png">
          <img alt="CASE" width="200px" src="docs/assets/images/CASE.png">
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.inettt.org/">
        <picture>
          <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/INETTT.png">
          <img alt="INETTT" width="200px" src="docs/assets/images/INETTT.png">
        </picture>
      </a>
    </td>
  </tr>
</table>

## License

PyPSA-SPICE is licensed under the open source [GNU General Public License v2.0 or later](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
with the following information:

The documentation is licensed under [CC-BY-4.0](https://interoperable-europe.ec.europa.eu/licence/creative-commons-attribution-40-international-cc-40).

The repository uses [REUSE](https://reuse.software/) to expose the licenses of its files.

pypsa-spice

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README