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 the following paper if you use Calliope for academic research:

Stefan Pfenninger and James Keirstead. 2015. Renewables, nuclear, or fossil fuels? Scenarios for Great Britain’s power system considering costs, emissions and energy security. Applied Energy, 152, pp. 83–93. doi: 10.1016/j.apenergy.2015.04.102

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.