Skip to main content

the MESSAGEix integrated assessment model

Project description

The MESSAGEix framework

PyPI version Anaconda version Documentation build Build status Test coverage


MESSAGEix is a versatile, open-source, dynamic systems-optimization model. It was developed for strategic energy planning and integrated assessment of energy-engineering-economy-environment (E4) systems. The framework includes the possibility for integration with the general-economy MACRO model to incorporate the feedback from price changes on demand for commodities or energy services. The mathematical formulation is based on the MESSAGE Integrated Assessment model developed at IIASA since the 1980s.

The MESSAGEix and MACRO models are implemented in GAMS. This repository contains the GAMS code and a number of tutorials and examples using stylized national energy system models.

The MESSAGEix framework is fully integrated with IIASA's ix modeling platform (ixmp), a data warehouse for high-powered numerical scenario analysis.


Copyright © 2018–2020 IIASA Energy Program

The MESSAGEix framework is licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at

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.

Please refer to the NOTICE for details and user guidelines.

Getting started


Documentation of the MESSAGEix framework, including the complete mathematical formulation and associated files, is automatically created from mark-up comments in the GAMS, Python, and R code.

  • The documentation for the ‘latest’ or the ‘stable’ release is displayed by default.
  • Use the chooser to reach the docs for the master branch of the GitHub repository, including latest development code.
  • For offline use, the documentation can be built from the source code. See doc/README.rst for details.


See the online documentation or the file INSTALL.rst.


For formal and self-guided learning, introductory tutorials are provided that illustrate the basic features of the modelling framework. See ‘Tutorials’ in the documentation or the file tutorial/README.rst.

Scientific reference

Please cite the following manuscript when using the MESSAGEix framework and/or the ix modeling platform for scientific publications or technical reports:

Daniel Huppmann, Matthew Gidden, Oliver Fricko, Peter Kolp, Clara Orthofer, Michael Pimmer, Nikolay Kushin, Adriano Vinca, Alessio Mastrucci, Keywan Riahi, and Volker Krey. "The |MESSAGEix| Integrated Assessment Model and the ix modeling platform". Environmental Modelling & Software 112:143-156, 2019. doi: 10.1016/j.envsoft.2018.11.012 electronic pre-print available at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for message-ix, version 3.1.0
Filename, size File type Python version Upload date Hashes
Filename, size message_ix-3.1.0-py3-none-any.whl (219.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size message_ix-3.1.0.tar.gz (2.5 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page