← Open Source
Farama-Foundation

MAgent2

An engine for high performance multi-agent environments with very large numbers of agents, along with a set of reference environments

Model DevelopmentEnvironmentsReinforcement LearningPython
Open on GitHub
Momentum
+-3stars in 24 hours-0.3%
965
Stars
67
Forks
+-3
This week
30
Contributors
Created 2022-09-05 · Updated 2026-10-05 · #18800 today
Top developers
README

Python PyPI Version

 ![](https://raw.githubusercontent.com/Farama-Foundation/MAgent2/main/MAgent2-text.png) 

MAgent2 is a library for the creation of environments where large numbers of pixel agents in a gridworld interact in battles or other competitive scenarios.

MAgent2 is a maintained fork of the original MAgent codebase. It contains some reference environments implemented using the PettingZoo API. These environments used to be included in PettingZoo itself, but have been moved here to exist independently. They are being regularly maintained and will receive bug fixes, support new versions of Python, etc. Development used to take place at github.com/Farama-Foundation/MAgent but was moved to github.com/Farama-Foundation/MAgent2 so that the distinction from the original MAgent library is clear to users.

Installation

Install using pip: pip install magent2. See docs for usage information.

Requirements

MAgent2 supports Linux and macOS and Python 3.8+.

References

@inproceedings{zheng2018magent,
  title={MAgent: A many-agent reinforcement learning platform for artificial collective intelligence},
  author={Zheng, Lianmin and Yang, Jiacheng and Cai, Han and Zhou, Ming and Zhang, Weinan and Wang, Jun and Yu, Yong},
  booktitle={Thirty-Second AAAI Conference on Artificial Intelligence},
  year={2018}
}

If you wish to cite this repo with it's modifications specifically, please cite:

@misc{magent2020,
  author = {Terry, Jordan K and Black, Benjamin and Jayakumar, Mario},
  title = {MAgent},
  year = {2020},
  publisher = {GitHub},
  note = {GitHub repository},
  howpublished = {\url{https://github.com/Farama-Foundation/MAgent}}
}

Project Maintainers