{"id":33325895,"url":"https://github.com/EnergySystemsModellingLab/MUSE2","last_synced_at":"2025-11-25T05:00:49.552Z","repository":{"id":235496687,"uuid":"790809493","full_name":"EnergySystemsModellingLab/MUSE2","owner":"EnergySystemsModellingLab","description":"Welcome to the MUSE2 repository","archived":false,"fork":false,"pushed_at":"2025-11-18T17:04:37.000Z","size":3871,"stargazers_count":6,"open_issues_count":92,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-11-18T18:21:56.902Z","etag":null,"topics":["energy-systems-modelling"],"latest_commit_sha":null,"homepage":"https://energysystemsmodellinglab.github.io/MUSE2/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EnergySystemsModellingLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-04-23T15:11:26.000Z","updated_at":"2025-11-17T13:21:21.000Z","dependencies_parsed_at":"2024-04-23T16:34:00.920Z","dependency_job_id":"2241f8c4-0ff2-442f-8171-333241ffaae8","html_url":"https://github.com/EnergySystemsModellingLab/MUSE2","commit_stats":null,"previous_names":["energysystemsmodellinglab/muse_2.0","energysystemsmodellinglab/muse2"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/EnergySystemsModellingLab/MUSE2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EnergySystemsModellingLab%2FMUSE2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EnergySystemsModellingLab%2FMUSE2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EnergySystemsModellingLab%2FMUSE2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EnergySystemsModellingLab%2FMUSE2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EnergySystemsModellingLab","download_url":"https://codeload.github.com/EnergySystemsModellingLab/MUSE2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EnergySystemsModellingLab%2FMUSE2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285406538,"owners_count":27166290,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-20T02:00:05.334Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["energy-systems-modelling"],"created_at":"2025-11-20T10:00:35.586Z","updated_at":"2025-11-25T05:00:49.526Z","avatar_url":"https://github.com/EnergySystemsModellingLab.png","language":"Rust","funding_links":[],"categories":["Energy Systems"],"sub_categories":["Energy System Modeling Frameworks"],"readme":"\u003c!-- markdownlint-disable MD041 --\u003e\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-10-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n[![Build and test](https://github.com/EnergySystemsModellingLab/MUSE2/actions/workflows/cargo-test.yml/badge.svg)](https://github.com/EnergySystemsModellingLab/MUSE2/actions/workflows/cargo-test.yml)\n[![codecov](https://codecov.io/github/EnergySystemsModellingLab/MUSE2/graph/badge.svg?token=nV8gp1NCh8)](https://codecov.io/github/EnergySystemsModellingLab/MUSE2)\n[![Crates.io Version](https://img.shields.io/crates/v/muse2)](https://crates.io/crates/muse2)\n[![DOI](https://zenodo.org/badge/790809493.svg)](https://doi.org/10.5281/zenodo.17350372)\n[![GitHub](https://img.shields.io/github/license/EnergySystemsModellingLab/MUSE2)](https://raw.githubusercontent.com/EnergySystemsModellingLab/MUSE2/main/LICENSE)\n\n# MUSE2\n\nMUSE2 (**M**od**U**lar energy systems **S**imulation **E**nvironment) is a tool for running\nsimulations of energy systems, written in Rust. Its purpose is to provide users with a framework to\nsimulate pathways of energy system transition, usually in the context of climate change mitigation.\n\nIt is the successor to [MUSE], which is written in Python. It was developed following re-design of\nMUSE to address a range of legacy issues that are challenging to address via upgrades to the\nexisting MUSE framework, and to implement the framework in the high-performance Rust language.\n\nPlease note that MUSE2 currently only works with simple models and is not yet suitable for use in\nresearch.\n\nTo download the latest version of MUSE2 for your platform, please visit [the releases page].\n\n[MUSE]: https://github.com/EnergySystemsModellingLab/MUSE_OS\n[the releases page]: https://github.com/EnergySystemsModellingLab/MUSE2/releases\n\n## Model Overview\n\nMUSE is an [Integrated Assessment Modelling] framework that is designed to enable users to create\nand apply an agent-based model to simulate a market equilibrium on a set of user-defined\ncommodities, over a user-defined time period, for a user-specified region or set of regions. MUSE\nwas developed to simulate approaches to climate change mitigation over a long time horizon (e.g.\n5-year steps to 2050 or 2100), but the framework is generalised and can therefore simulate any\nmarket equilibrium.\n\nIt is a recursive dynamic modelling framework in the sense that it iterates on a single time period\nto find a market equilibrium, and then moves to the next time period. Agents in MUSE have limited\nforesight, reacting only to information available in the current time period. This is distinct from\nintertemporal optimisation modelling frameworks (such as [TIMES] and [MESSAGEix]) which have perfect\nforesight over the whole modelled time horizon.\n\n[Integrated Assessment Modelling]: https://unfccc.int/topics/mitigation/workstreams/response-measures/modelling-tools-to-assess-the-impact-of-the-implementation-of-response-measures/integrated-assessment-models-iams-and-energy-environment-economy-e3-models\n[TIMES]: https://iea-etsap.org/index.php/etsap-tools/model-generators/times\n[MESSAGEix]: https://docs.messageix.org/en/latest\n\n## Getting started\n\nThe easiest way to install MUSE2 is to download the latest version for your platform on [our\nreleases page]. For information on getting started, please consult [the documentation].\n\nIf you wish to develop MUSE2 or build it from source, please see [the developer guide].\n\nYou can also install the [`muse2` crate from crates.io][muse2-crate], though this installation\nmethod is only recommended for developers.\n\n[our releases page]: https://github.com/EnergySystemsModellingLab/MUSE2/releases\n[the documentation]: https://energysystemsmodellinglab.github.io/MUSE2/introduction.html\n[the developer guide]: https://energysystemsmodellinglab.github.io/MUSE2/developer_guide.html\n[muse2-crate]: https://crates.io/crates/muse2\n\n## Citing this repository\n\nIf you use MUSE2 in your work, please cite us. For information on how to cite this repository, see\n[the Zenodo page for the latest release][zenodo-page].\n\n[zenodo-page]: https://doi.org/10.5281/zenodo.17350372\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://www.imperial.ac.uk/admin-services/ict/self-service/research-support/rcs/service-offering/research-software-engineering/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/23149834?v=4?s=100\" width=\"100px;\" alt=\"Alex Dewar\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAlex Dewar\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=alexdewar\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/tsmbland\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/23723407?v=4?s=100\" width=\"100px;\" alt=\"Tom Bland\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTom Bland\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=tsmbland\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/Sahil590\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/56438860?v=4?s=100\" width=\"100px;\" alt=\"Sahil Raja\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eSahil Raja\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=Sahil590\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/Ashmit8583\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/137117727?v=4?s=100\" width=\"100px;\" alt=\"Ashmit Sikdar\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAshmit Sikdar\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=Ashmit8583\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://www.imperial.ac.uk/admin-services/ict/self-service/research-support/rcs/service-offering/research-software-engineering/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/6095790?v=4?s=100\" width=\"100px;\" alt=\"Diego Alonso Álvarez\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eDiego Alonso Álvarez\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=dalonsoa\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/AdrianDAlessandro\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/40875798?v=4?s=100\" width=\"100px;\" alt=\"Adrian D'Alessandro\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAdrian D'Alessandro\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=AdrianDAlessandro\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/TinyMarsh\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/13540127?v=4?s=100\" width=\"100px;\" alt=\"Ryan Smith\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eRyan Smith\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=TinyMarsh\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/HarmonicReflux\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/16504600?v=4?s=100\" width=\"100px;\" alt=\"Benjamin Scharpf\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBenjamin Scharpf\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=HarmonicReflux\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/ahawkes\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/12055725?v=4?s=100\" width=\"100px;\" alt=\"Adam Hawkes\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAdam Hawkes\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-ahawkes\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=ahawkes\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/Aurashk\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/9390150?v=4?s=100\" width=\"100px;\" alt=\"Aurash Karimi\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAurash Karimi\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/EnergySystemsModellingLab/MUSE2/commits?author=Aurashk\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n  \u003ctfoot\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" size=\"13px\" colspan=\"7\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg\"\u003e\n          \u003ca href=\"https://all-contributors.js.org/docs/en/bot/usage\"\u003eAdd your contributions\u003c/a\u003e\n        \u003c/img\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tfoot\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors)\nspecification. Contributions of any kind welcome!\n\n## Copyright\n\nCopyright © 2025 Imperial College London\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEnergySystemsModellingLab%2FMUSE2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEnergySystemsModellingLab%2FMUSE2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEnergySystemsModellingLab%2FMUSE2/lists"}