{"id":15039260,"url":"https://github.com/farama-foundation/pettingzoo","last_synced_at":"2026-04-26T06:05:36.696Z","repository":{"id":36994406,"uuid":"235012937","full_name":"Farama-Foundation/PettingZoo","owner":"Farama-Foundation","description":"An API standard for multi-agent reinforcement learning environments, with popular reference environments and related utilities","archived":false,"fork":false,"pushed_at":"2026-04-26T00:17:36.000Z","size":184549,"stargazers_count":3393,"open_issues_count":60,"forks_count":484,"subscribers_count":16,"default_branch":"master","last_synced_at":"2026-04-26T00:35:03.680Z","etag":null,"topics":["api","gym","gymnasium","multi-agent-reinforcement-learning","multiagent-reinforcement-learning","reinforcement-learning"],"latest_commit_sha":null,"homepage":"https://pettingzoo.farama.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Farama-Foundation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.rst","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},"funding":{"github":"Farama-Foundation"}},"created_at":"2020-01-20T03:41:08.000Z","updated_at":"2026-04-26T00:11:22.000Z","dependencies_parsed_at":"2023-10-14T16:37:21.219Z","dependency_job_id":"5520ec33-61f0-450f-a94e-ba3630d3cc54","html_url":"https://github.com/Farama-Foundation/PettingZoo","commit_stats":{"total_commits":3730,"total_committers":116,"mean_commits":32.1551724137931,"dds":0.699195710455764,"last_synced_commit":"67ecdb244157948fbae39f94ac642cc67876ef72"},"previous_names":["pettingzoo-team/pettingzoo"],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/Farama-Foundation/PettingZoo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farama-Foundation%2FPettingZoo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farama-Foundation%2FPettingZoo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farama-Foundation%2FPettingZoo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farama-Foundation%2FPettingZoo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Farama-Foundation","download_url":"https://codeload.github.com/Farama-Foundation/PettingZoo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farama-Foundation%2FPettingZoo/sbom","scorecard":{"id":49258,"data":{"date":"2025-08-11","repo":{"name":"github.com/Farama-Foundation/PettingZoo","commit":"405e71c912dc3f787bb12c7f8463f18fcce31bb1"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.4,"checks":[{"name":"Code-Review","score":8,"reason":"Found 24/30 approved changesets -- score normalized to 8","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":4,"reason":"2 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 4","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/build-publish.yml:24","Warn: topLevel 'contents' permission set to 'write': .github/workflows/build-docs.yml:7","Warn: no topLevel permission defined: .github/workflows/build-publish.yml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/docs-manual-versioning.yml:17","Info: topLevel 'contents' permission set to 'read': .github/workflows/docs-test.yml:11","Warn: topLevel 'contents' permission set to 'write': .github/workflows/docs-versioning.yml:8","Info: topLevel 'contents' permission set to 'read': .github/workflows/linux-test.yml:11","Info: topLevel 'contents' permission set to 'read': .github/workflows/linux-tutorials-test.yml:11","Info: topLevel 'contents' permission set to 'read': .github/workflows/macos-test.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/pre-commit.yml:9","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/build-publish.yml:40"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-docs.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-docs.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-docs.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-docs.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-docs.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-docs.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-publish.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-publish.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-publish.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-publish.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-publish.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-publish.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/build-publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-manual-versioning.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-manual-versioning.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-manual-versioning.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-manual-versioning.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-manual-versioning.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-manual-versioning.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-manual-versioning.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-manual-versioning.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-manual-versioning.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-manual-versioning.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-test.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-test.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-versioning.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-versioning.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-versioning.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-versioning.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-versioning.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-versioning.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-versioning.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-versioning.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-versioning.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/docs-versioning.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-test.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-test.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-tutorials-test.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-tutorials-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-tutorials-test.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-tutorials-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-tutorials-test.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-tutorials-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/linux-tutorials-test.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/linux-tutorials-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/macos-test.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/macos-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/macos-test.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/macos-test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/pre-commit.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/Farama-Foundation/PettingZoo/pre-commit.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/build-docs.yml:21","Warn: pipCommand not pinned by hash: .github/workflows/build-docs.yml:23","Warn: pipCommand not pinned by hash: .github/workflows/build-publish.yml:33","Warn: pipCommand not pinned by hash: .github/workflows/docs-manual-versioning.yml:36","Warn: pipCommand not pinned by hash: .github/workflows/docs-manual-versioning.yml:38","Warn: pipCommand not pinned by hash: .github/workflows/docs-test.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/docs-test.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/docs-test.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/docs-test.yml:34","Warn: pipCommand not pinned by hash: .github/workflows/docs-versioning.yml:27","Warn: pipCommand not pinned by hash: .github/workflows/docs-versioning.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/linux-test.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/linux-test.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/linux-test.yml:33","Warn: pipCommand not pinned by hash: .github/workflows/linux-test.yml:35","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:35","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:36","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:37","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:64","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:65","Warn: pipCommand not pinned by hash: .github/workflows/linux-tutorials-test.yml:66","Warn: pipCommand not pinned by hash: .github/workflows/macos-test.yml:27","Warn: pipCommand not pinned by hash: .github/workflows/macos-test.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/pre-commit.yml:20","Info:   0 out of  23 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned","Info:   0 out of  24 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":0,"reason":"38 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-3f63-hfp8-52jq","Warn: Project is vulnerable to: GHSA-44wm-f244-xhp3","Warn: Project is vulnerable to: PYSEC-2023-227 / GHSA-8ghj-p4vj-mr35","Warn: Project is vulnerable to: GHSA-j7hp-h8jx-5ppr","Warn: Project is vulnerable to: PYSEC-2023-175","Warn: Project is vulnerable to: GHSA-3749-ghw9-m3mg","Warn: Project is vulnerable to: PYSEC-2025-41 / GHSA-53q9-r3pm-6pq6","Warn: Project is vulnerable to: PYSEC-2024-252 / GHSA-5pcm-hx3q-hm94","Warn: Project is vulnerable to: GHSA-887c-mr87-cxwp","Warn: Project is vulnerable to: PYSEC-2024-251 / GHSA-pg7h-5qx3-wjr3","Warn: Project is vulnerable to: PYSEC-2024-250","Warn: Project is vulnerable to: PYSEC-2024-259","Warn: Project is vulnerable to: GHSA-g7vv-2v7x-gj9p","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: PYSEC-2023-98 / GHSA-2qmj-7962-cjq8","Warn: Project is vulnerable to: PYSEC-2024-118 / GHSA-3hjh-jh2h-vrg6","Warn: Project is vulnerable to: PYSEC-2024-115 / GHSA-45pg-36p6-83v9","Warn: Project is vulnerable to: PYSEC-2023-109 / GHSA-57fc-8q82-gfp3","Warn: Project is vulnerable to: PYSEC-2023-205 / GHSA-655w-fm8m-m478","Warn: Project is vulnerable to: PYSEC-2023-92 / GHSA-6643-h7h5-x9wh","Warn: Project is vulnerable to: GHSA-6h8p-4hx9-w66c","Warn: Project is vulnerable to: PYSEC-2023-151 / GHSA-7gfq-f96f-g85j","Warn: Project is vulnerable to: PYSEC-2023-110 / GHSA-7q94-qpjr-xpgm","Warn: Project is vulnerable to: GHSA-8h5w-f6q9-wg35","Warn: Project is vulnerable to: PYSEC-2023-146 / GHSA-92j5-3459-qgp4","Warn: Project is vulnerable to: PYSEC-2023-162 / GHSA-f73w-4m7g-ch9x","Warn: Project is vulnerable to: PYSEC-2023-145 / GHSA-fj32-q626-pjjc","Warn: Project is vulnerable to: PYSEC-2023-18 / GHSA-fprp-p869-w6q2","Warn: Project is vulnerable to: PYSEC-2023-138 / GHSA-gwqq-6vq7-5j86","Warn: Project is vulnerable to: PYSEC-2024-43 / GHSA-h59x-p739-982c","Warn: Project is vulnerable to: GHSA-h9j7-5xvc-qhg5","Warn: Project is vulnerable to: PYSEC-2023-147 / GHSA-prgp-w7vf-ch62","Warn: Project is vulnerable to: GHSA-rgp8-pm28-3759","Warn: Project is vulnerable to: PYSEC-2023-91 / GHSA-x32c-59v5-h7fg","Warn: Project is vulnerable to: GHSA-3pww-qvr8-6mhp","Warn: Project is vulnerable to: GHSA-6cxr-8q3m-jwrr","Warn: Project is vulnerable to: GHSA-h3xg-wv58-5p43","Warn: Project is vulnerable to: PYSEC-2025-23 / GHSA-w4rh-fgx7-q63m"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 27 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-14T23:23:41.176Z","repository_id":36994406,"created_at":"2025-08-14T23:23:41.176Z","updated_at":"2025-08-14T23:23:41.176Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32287399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"online","status_checked_at":"2026-04-26T02:00:05.962Z","response_time":129,"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":["api","gym","gymnasium","multi-agent-reinforcement-learning","multiagent-reinforcement-learning","reinforcement-learning"],"created_at":"2024-09-24T20:42:07.061Z","updated_at":"2026-04-26T06:05:36.690Z","avatar_url":"https://github.com/Farama-Foundation.png","language":"Python","funding_links":["https://github.com/sponsors/Farama-Foundation"],"categories":[],"sub_categories":[],"readme":"[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://pre-commit.com/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\u003cp align=\"center\"\u003e\n    \u003ca href = \"https://pettingzoo.farama.org/\" target = \"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Farama-Foundation/PettingZoo/master/pettingzoo-text.png\" width=\"500px\"/\u003e \u003c/a\u003e\n\u003c/p\u003e\n\nPettingZoo is a Python library for conducting research in multi-agent reinforcement learning, akin to a multi-agent version of [Gymnasium](https://github.com/Farama-Foundation/Gymnasium).\n\nThe documentation website is at [pettingzoo.farama.org](https://pettingzoo.farama.org) and we have a public discord server (which we also use to coordinate development work) that you can join here: https://discord.gg/nhvKkYa6qX\n\n## Environments\n\nPettingZoo includes the following families of environments:\n\n* [Atari](https://pettingzoo.farama.org/environments/atari/): Multi-player Atari 2600 games (cooperative, competitive and mixed sum)\n* [Butterfly](https://pettingzoo.farama.org/environments/butterfly): Cooperative graphical games developed by us, requiring a high degree of coordination\n* [Classic](https://pettingzoo.farama.org/environments/classic): Classical games including card games, board games, etc.\n* [SISL](https://pettingzoo.farama.org/environments/sisl): 2 cooperative environments, originally from https://github.com/sisl/MADRL\n\n## Installation\n\nTo install the base PettingZoo library: `pip install pettingzoo`.\n\nThis does not include dependencies for all families of environments (some environments can be problematic to install on certain systems).\n\nTo install the dependencies for one family, use `pip install 'pettingzoo[atari]'`, or use `pip install 'pettingzoo[all]'` to install all dependencies.\n\nWe support and maintain PettingZoo for Python 3.9, 3.10, 3.11, 3.12, 3.13, and 3.14 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.\n\nNote: Some Linux distributions may require manual installation of `cmake`, `swig`, or `zlib1g-dev` (e.g., `sudo apt install cmake swig zlib1g-dev`)\n\n## Getting started\n\nFor an introduction to PettingZoo, see [Basic Usage](https://pettingzoo.farama.org/content/basic_usage/). To create a new environment, see our [Environment Creation Tutorial](https://pettingzoo.farama.org/tutorials/custom_environment/1-project-structure/) and [Custom Environment Examples](https://pettingzoo.farama.org/content/environment_creation/).\nFor examples of training RL models using PettingZoo see our tutorials:\n* [CleanRL: Implementing PPO](https://pettingzoo.farama.org/tutorials/cleanrl/implementing_PPO/): train multiple PPO agents in the [Pistonball](https://pettingzoo.farama.org/environments/butterfly/pistonball/) environment.\n* [Tianshou: Training Agents](https://pettingzoo.farama.org/tutorials/tianshou/intermediate/): train DQN agents in the [Tic-Tac-Toe](https://pettingzoo.farama.org/environments/classic/tictactoe/) environment.\n* [AgileRL: Training, Curriculums and Self-play](https://pettingzoo.farama.org/main/tutorials/agilerl/DQN/): train agents with curriculum learning and self-play in the [Connect Four](https://pettingzoo.farama.org/environments/classic/connect_four/) environment.\n\n## API\n\nPettingZoo model environments as [*Agent Environment Cycle* (AEC) games](https://arxiv.org/pdf/2009.14471.pdf), in order to be able to cleanly support all types of multi-agent RL environments under one API and to minimize the potential for certain classes of common bugs.\n\nUsing environments in PettingZoo is very similar to Gymnasium, i.e. you initialize an environment via:\n\n```python\nfrom pettingzoo.butterfly import pistonball_v6\nenv = pistonball_v6.env()\n```\n\nEnvironments can be interacted with in a manner very similar to Gymnasium:\n\n```python\nenv.reset()\nfor agent in env.agent_iter():\n    observation, reward, termination, truncation, info = env.last()\n    action = None if termination or truncation else env.action_space(agent).sample()  # this is where you would insert your policy\n    env.step(action)\n```\n\nFor the complete API documentation, please see https://pettingzoo.farama.org/api/aec/\n\n### Parallel API\n\nIn certain environments, it's a valid to assume that agents take their actions at the same time. For these games, we offer a secondary API to allow for parallel actions, documented at https://pettingzoo.farama.org/api/parallel/\n\n## SuperSuit\n\nSuperSuit is a library that includes all commonly used wrappers in RL (frame stacking, observation, normalization, etc.) for PettingZoo and Gymnasium environments with a nice API. We developed it in lieu of wrappers built into PettingZoo. https://github.com/Farama-Foundation/SuperSuit\n\n## Environment Versioning\n\nPettingZoo keeps strict versioning for reproducibility reasons. All environments end in a suffix like \"\\_v0\".  When changes are made to environments that might impact learning results, the number is increased by one to prevent potential confusion.\n\n## Citation\n\nTo cite this project in publication, please use\n\n```\n@article{terry2021pettingzoo,\n  title={Pettingzoo: Gym for multi-agent reinforcement learning},\n  author={Terry, J and Black, Benjamin and Grammel, Nathaniel and Jayakumar, Mario and Hari, Ananth and Sullivan, Ryan and Santos, Luis S and Dieffendahl, Clemens and Horsch, Caroline and Perez-Vicente, Rodrigo and others},\n  journal={Advances in Neural Information Processing Systems},\n  volume={34},\n  pages={15032--15043},\n  year={2021}\n}\n```\n\n## Project Maintainers\n- Project Manager: [Travis Virgil](https://github.com/virgilt) - `travis@farama.org`\n- Maintainer: [Albert Han](https://github.com/yjhan96) - `yjhan96@gmail.com`.\n- Maintenance for this project is also contributed by the broader Farama team: [farama.org/team](https://farama.org/team).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarama-foundation%2Fpettingzoo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarama-foundation%2Fpettingzoo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarama-foundation%2Fpettingzoo/lists"}