magent2


Namemagent2 JSON
Version 0.3.3 PyPI version JSON
download
home_pageNone
SummaryMulti-Agent Reinforcement Learning environments with very large numbers of agents.
upload_time2024-08-19 22:30:57
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT License
keywords reinforcement learning game rl ai
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
    <img src="https://raw.githubusercontent.com/Farama-Foundation/MAgent2/main/MAgent2-text.png" width="500px"/>
</p>

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.

<p align="center">
  <img src="https://raw.githubusercontent.com/Farama-Foundation/MAgent2/main/docs/environments/adversarial_pursuit.gif" width="200">
</p>

MAgent2 is a maintained fork of the original [MAgent](https://github.com/geek-ai/MAgent) codebase. It contains some [reference environments](https://github.com/Farama-Foundation/MAgent2/tree/main/magent2/environments) implemented using the [PettingZoo](https://github.com/Farama-Foundation/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](https://github.com/Farama-Foundation/MAgent) but was moved to [github.com/Farama-Foundation/MAgent2](https://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](https://magent2.farama.org/) 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}}
}
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "magent2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "Reinforcement Learning, game, RL, AI",
    "author": null,
    "author_email": "Farama Foundation <contact@farama.org>",
    "download_url": "https://files.pythonhosted.org/packages/cf/88/9e0555da0e1a9b886c3a1490d20e7c43d056596988c6a3e54c0c2c0df2f5/magent2-0.3.3.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n    <img src=\"https://raw.githubusercontent.com/Farama-Foundation/MAgent2/main/MAgent2-text.png\" width=\"500px\"/>\n</p>\n\nMAgent2 is a library for the creation of environments where large numbers of pixel agents in a gridworld interact in battles or other competitive scenarios.\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/Farama-Foundation/MAgent2/main/docs/environments/adversarial_pursuit.gif\" width=\"200\">\n</p>\n\nMAgent2 is a maintained fork of the original [MAgent](https://github.com/geek-ai/MAgent) codebase. It contains some [reference environments](https://github.com/Farama-Foundation/MAgent2/tree/main/magent2/environments) implemented using the [PettingZoo](https://github.com/Farama-Foundation/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](https://github.com/Farama-Foundation/MAgent) but was moved to [github.com/Farama-Foundation/MAgent2](https://github.com/Farama-Foundation/MAgent2) so that the distinction from the original MAgent library is clear to users.\n\n## Installation\nInstall using pip: `pip install magent2`. See [docs](https://magent2.farama.org/) for usage information.\n\n\n## Requirements\nMAgent2 supports Linux and macOS and Python 3.8+.\n\n## References\n```\n@inproceedings{zheng2018magent,\n  title={MAgent: A many-agent reinforcement learning platform for artificial collective intelligence},\n  author={Zheng, Lianmin and Yang, Jiacheng and Cai, Han and Zhou, Ming and Zhang, Weinan and Wang, Jun and Yu, Yong},\n  booktitle={Thirty-Second AAAI Conference on Artificial Intelligence},\n  year={2018}\n}\n```\n\nIf you wish to cite this repo with it's modifications specifically, please cite:\n\n```\n@misc{magent2020,\n  author = {Terry, Jordan K and Black, Benjamin and Jayakumar, Mario},\n  title = {MAgent},\n  year = {2020},\n  publisher = {GitHub},\n  note = {GitHub repository},\n  howpublished = {\\url{https://github.com/Farama-Foundation/MAgent}}\n}\n```\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Multi-Agent Reinforcement Learning environments with very large numbers of agents.",
    "version": "0.3.3",
    "project_urls": {
        "Bug Report": "https://github.com/Farama-Foundation/MAgent2/issues",
        "Documentation": "https://magent2.farama.org",
        "Homepage": "https://farama.org",
        "Repository": "https://github.com/Farama-Foundation/MAgent2"
    },
    "split_keywords": [
        "reinforcement learning",
        " game",
        " rl",
        " ai"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dd27b8ed11da998676798bd64d362332d194e490ea974695bb31378a9b085fef",
                "md5": "4db3e83ff1dd0ae8594ebc4cc2c870b6",
                "sha256": "e6fe235a2a3f5b2a99c995abe30c28bb03ad1751572d39182b6c9ce2f3a3b266"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "4db3e83ff1dd0ae8594ebc4cc2c870b6",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.8",
            "size": 1735708,
            "upload_time": "2024-08-19T22:30:45",
            "upload_time_iso_8601": "2024-08-19T22:30:45.126563Z",
            "url": "https://files.pythonhosted.org/packages/dd/27/b8ed11da998676798bd64d362332d194e490ea974695bb31378a9b085fef/magent2-0.3.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "57a0718f5e8520691ddf964d12e9433adcd8cd79c697101aabad1694c4c7a34b",
                "md5": "eb6c97f1e4c5acb56b23e78a229ff796",
                "sha256": "f28262cf1bff129a3e28f23d8a4d2749c9362ba6f58d15c7aae6dc863c850d07"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp310-cp310-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "eb6c97f1e4c5acb56b23e78a229ff796",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.8",
            "size": 163001,
            "upload_time": "2024-08-19T22:30:46",
            "upload_time_iso_8601": "2024-08-19T22:30:46.889681Z",
            "url": "https://files.pythonhosted.org/packages/57/a0/718f5e8520691ddf964d12e9433adcd8cd79c697101aabad1694c4c7a34b/magent2-0.3.3-cp310-cp310-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "451e5d795f742d11b80393069c2687dde50b9aa1dd99c1c7373f0c6e7697c052",
                "md5": "c60d241496cb4ce7cd8258e174e5677f",
                "sha256": "1aa056b3eab6b8baba0b7e45525ff51163a1597c63ba310905c1b064f798c951"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "c60d241496cb4ce7cd8258e174e5677f",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.8",
            "size": 1735713,
            "upload_time": "2024-08-19T22:30:48",
            "upload_time_iso_8601": "2024-08-19T22:30:48.155420Z",
            "url": "https://files.pythonhosted.org/packages/45/1e/5d795f742d11b80393069c2687dde50b9aa1dd99c1c7373f0c6e7697c052/magent2-0.3.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9dbc7f2d4383c9c20e005f8ba895fc5b134fe87a9811a46af95b1868afaadba5",
                "md5": "480ac83cf649c7c3f2770514a3ef9a63",
                "sha256": "6c8781626e0a9f1582bff75aa3ed812e22a5c5d6500bafbdf901274ee78e658c"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp311-cp311-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "480ac83cf649c7c3f2770514a3ef9a63",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.8",
            "size": 163005,
            "upload_time": "2024-08-19T22:30:49",
            "upload_time_iso_8601": "2024-08-19T22:30:49.768831Z",
            "url": "https://files.pythonhosted.org/packages/9d/bc/7f2d4383c9c20e005f8ba895fc5b134fe87a9811a46af95b1868afaadba5/magent2-0.3.3-cp311-cp311-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ce336e07021fefea0e4f9f0a625a1471aca252ebf54c87fab9e5946321c38545",
                "md5": "f3e9c4dafa50c709076f6bf6958ac4c4",
                "sha256": "850592c6c18c699821725dbe99c12312ebda0e474fb921b3144aca246f74faac"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "f3e9c4dafa50c709076f6bf6958ac4c4",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.8",
            "size": 1735795,
            "upload_time": "2024-08-19T22:30:51",
            "upload_time_iso_8601": "2024-08-19T22:30:51.017087Z",
            "url": "https://files.pythonhosted.org/packages/ce/33/6e07021fefea0e4f9f0a625a1471aca252ebf54c87fab9e5946321c38545/magent2-0.3.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6febe24b6701fa551ac8263b62f1bb70825928d72e3047a806120ff02abb0fb1",
                "md5": "31647516433f26b15c5e3955c766a6cf",
                "sha256": "c2fae7536184c2fe86f9596c30aed3ee62ec45b0096d380cadd053099411a617"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp38-cp38-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "31647516433f26b15c5e3955c766a6cf",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.8",
            "size": 163001,
            "upload_time": "2024-08-19T22:30:52",
            "upload_time_iso_8601": "2024-08-19T22:30:52.231249Z",
            "url": "https://files.pythonhosted.org/packages/6f/eb/e24b6701fa551ac8263b62f1bb70825928d72e3047a806120ff02abb0fb1/magent2-0.3.3-cp38-cp38-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4fe2563d46e07793f3a4d75b311b0875031559f93d01351390cb5feaa2491832",
                "md5": "53b6c5fc8c53c7fcdce6fbc56e2db7db",
                "sha256": "eb791c9895098b522a10f570daa1807e2fd2e63ae60d85ccce7e4dc1769084f8"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "53b6c5fc8c53c7fcdce6fbc56e2db7db",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.8",
            "size": 1735741,
            "upload_time": "2024-08-19T22:30:53",
            "upload_time_iso_8601": "2024-08-19T22:30:53.473941Z",
            "url": "https://files.pythonhosted.org/packages/4f/e2/563d46e07793f3a4d75b311b0875031559f93d01351390cb5feaa2491832/magent2-0.3.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4881c638bc589e8421fb89c20a1c4ee32865ab4dd9b48c7cbb25f0feecae66b3",
                "md5": "8beb1897a626057f82b65a6e30393e05",
                "sha256": "ae0f635cee5a4dc1eb5c7dad7c89fda5c9b5b16dc2892deae256a30223691545"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3-cp39-cp39-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "8beb1897a626057f82b65a6e30393e05",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.8",
            "size": 163002,
            "upload_time": "2024-08-19T22:30:55",
            "upload_time_iso_8601": "2024-08-19T22:30:55.579360Z",
            "url": "https://files.pythonhosted.org/packages/48/81/c638bc589e8421fb89c20a1c4ee32865ab4dd9b48c7cbb25f0feecae66b3/magent2-0.3.3-cp39-cp39-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cf889e0555da0e1a9b886c3a1490d20e7c43d056596988c6a3e54c0c2c0df2f5",
                "md5": "041cfce5b7f8d7c41c8a9856ae308a46",
                "sha256": "8b97b60e7032bf9b167508244b62c485c30b7f39e0a5275597f2f3207c541a79"
            },
            "downloads": -1,
            "filename": "magent2-0.3.3.tar.gz",
            "has_sig": false,
            "md5_digest": "041cfce5b7f8d7c41c8a9856ae308a46",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 4159819,
            "upload_time": "2024-08-19T22:30:57",
            "upload_time_iso_8601": "2024-08-19T22:30:57.099750Z",
            "url": "https://files.pythonhosted.org/packages/cf/88/9e0555da0e1a9b886c3a1490d20e7c43d056596988c6a3e54c0c2c0df2f5/magent2-0.3.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-19 22:30:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Farama-Foundation",
    "github_project": "MAgent2",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "magent2"
}
        
Elapsed time: 0.64263s