Calliope logo

A multi-scale energy systems (MUSES) modeling framework


Calliope is a framework to develop energy system models using a modern and open source Python-based toolchain. It is under active development and freely available under the Apache 2.0 license.

Latest stable release: on PyPI badge_pypi and GitHub badge_githubrelease.



Statue of Calliope; in the Museo Pio-Clementino, Vatican. © Trustees of the British Museum.

See the introduction section of the documentation and the tutorial for more details.

Calliope’s main features include:

  • Generic technology definition allows modeling any mix of production, storage and consumption
  • Resolved in space: define locations with individual resource potentials
  • Resolved in time: can read time series with arbitrary resolution
  • Model specification in an easy-to-read YAML format
  • Able to run on computing clusters
  • Easily extensible
  • Uses a state-of-the-art Python toolchain based on Pyomo and Pandas

Please cite Calliope if you use it for academic research (a paper to reference is forthcoming and will be listed here once available):

Pfenninger, Stefan. 2015. Calliope: a multi-scale energy systems (MUSES) modeling framework. Available at:

DOI for the most recent stable version on Zenodo: badge_doi

Comments, bug reports, pull requests, and any other contributions are welcome. See below for contact information.


The project is currently being developed by:

Stefan Pfenninger <> <>

Development is funded by the Grantham Institute at Imperial College London, and the European Institute of Innovation & Technology’s Climate-KIC program.