Skip to main content

the MESSAGEix integrated assessment model

Project description

The MESSAGEix framework

DOI PyPI version Anaconda version Documentation build Build status Test coverage

MESSAGEix is a versatile, dynamic, model framework for energy-engineering-economy-environment (E4) systems research.

MESSAGE (without “…ix”) is a specific formulation of a generic linear programming (LP) optimization model for strategic energy planning and integrated assessment of E4 systems, developed by the IIASA Energy, Climate, and Environment (ECE) Program since the 1980s. To incorporate feedback between prices and demand levels for energy and commodities, the LP model can optionally be linked to the economic general equilibrium (GE) MACRO model.

The message_ix Python package—also fully usable from R—includes:

  • Implementations of MESSAGE, MACRO, and their linkage, in GAMS,
  • Application programming interfaces (APIs) and tools for model building and scientific programming,
  • Extensive documentation and a complete test suite.

The framework is built on IIASA's ix modeling platform (ixmp), which provides data warehouse features for high-powered numerical scenario analysis.


Complete documentation of the framework is avaiable at This includes:

Other forms of documentation:

  • The online documentation is built automatically from the contents of the message_ix GitHub repository.
  • Documentation for the ‘latest’ or ‘stable’ release is shown by default.
  • Use the chooser to access the ‘latest’ version, corresponding to the main branch and including the latest development code; or to access docs for a specific release, e.g. v3.2.0.
  • For offline use, the documentation can be built from the source code. See the file doc/README.rst


Copyright © 2018–2021 IIASA Energy, Climate, and Environment (ECE) 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 in LICENSE or at

In addition and per good scientific practice, you must cite the appropriate publications when you use MESSAGEix in scientific work. Again, see ‘User guidelines and notice’ or the file NOTICE.rst.

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.3.0
Filename, size File type Python version Upload date Hashes
Filename, size message_ix-3.3.0.tar.gz (4.9 MB) File type Source Python version None Upload date Hashes View
Filename, size message_ix-3.3.0-py3-none-any.whl (233.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page