Package: gymnasium
Gymnasium is an open source Python library for developing and comparing reinforcement learning algorithms by providing a standard API to communicate between learning algorithms and environments, as well as a standard set of environments compliant with that API. This is a fork of OpenAI'sGymlibrary by it's maintainers (OpenAI handed over maintenance a few years ago to an outside team), and is where future maintenance will occur going forward.The documentation website is atgymnasium.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/bnJ6kubTg6EnvironmentsGymnasium includes the following families of environments along with a wide variety of third-party environmentsClassic Control- These are classic reinforcement learning based on real-world problems and physics.Box2D- These environments all involve toy games based around physics control, using box2d based physics and PyGame-based renderingToy Text- These environments are designed to be extremely simple, with small discrete state and action spaces, and hence easy to learn. As a result, they are suitable for debugging implementations of reinforcement learning algorithms.MuJoCo- A physics engine based environments with multi-joint control which are more complex than the Box2D environments.Atari- A set of 57 Atari 2600 environments simulated through Stella and the Arcade Learning Environment that have a high range of complexity for agents to learn.Third-party- A number of environments have been created that are compatible with the Gymnasium API. Be aware of the version that the software was created for and use theapply_env_compatibilityingymnasium.makeif necessary.InstallationTo install the base Gymnasium library, usepip install gymnasiumThis does not include dependencies for all families of environments (there's a massive number, and some can be problematic to install on certain systems). You can install these dependencies for one family likepip install "gymnasium[atari]"or usepip install "gymnasium[all]"to install all dependencies.We support and test for Python 3.8, 3.9, 3.10, 3.11 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.APIThe Gymnasium API models environments as simple Pythonenvclasses. Creating environment instances and interacting with them is very simple- here's an example using the "CartPole-v1" environment:importgymnasiumasgymenv=gym.make("CartPole-v1")observation,info=env.reset(seed=42)for_inrange(1000):action=env.action_space.sample()observation,reward,terminated,truncated,info=env.step(action)ifterminatedortruncated:observation,info=env.reset()env.close()Notable Related LibrariesPlease note that this is an incomplete list, and just includes libraries that the maintainers most commonly point newcommers to when asked for recommendations.CleanRLis a learning library based on the Gymnasium API. It is designed to cater to newer people in the field and provides very good reference implementations.PettingZoois a multi-agent version of Gymnasium with a number of implemented environments, i.e. multi-agent Atari environments.The Farama Foundation also has a collection of many otherenvironmentsthat are maintained by the same team as Gymnasium and use the Gymnasium API.Cometis a free ML-Ops tool that tracks rewards, metrics, hyperparameters, and code for ML training runs. Comet has an easy-to use integration with Gymnasium, here's atutorialon how to use them together! Comet is a sponsor of the Farama Foundation!Environment VersioningGymnasium 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. These inherent from Gym.Development RoadmapWe have a roadmap for future development work for Gymnasium available here:https://github.com/Farama-Foundation/Gymnasium/issues/12Support Gymnasium's DevelopmentIf you are financially able to do so and would like to support the development of Gymnasium, please join others in the community indonating to us.CitationYou can cite Gymnasium as:@misc{towers_gymnasium_2023,
        title = {Gymnasium},
        url = {https://zenodo.org/record/8127025},
        abstract = {An API standard for single-agent reinforcement learning environments, with popular reference environments and related utilities (formerly Gym)},
        urldate = {2023-07-08},
        publisher = {Zenodo},
        author = {Towers, Mark and Terry, Jordan K. and Kwiatkowski, Ariel and Balis, John U. and Cola, Gianluca de and Deleu, Tristan and Goulão, Manuel and Kallinteris, Andreas and KG, Arjun and Krimmel, Markus and Perez-Vicente, Rodrigo and Pierré, Andrea and Schulhoff, Sander and Tai, Jun Jet and Shen, Andrew Tan Jin and Younis, Omar G.},
        month = mar,
        year = {2023},
        doi = {10.5281/zenodo.8127026},
}