Repolode
投稿する
Farama-Foundation

Farama-Foundation/Gymnasium

単一エージェントの強化学習環境向け標準Python APIと、OpenAI Gymからフォークした参照環境群。

GitHub で見る公式サイト
スター
12,704
フォーク
1,513
未解決の Issue
117
最終コミット
7 日前

これは何？

Gymnasiumは、強化学習アルゴリズムと学習に使う環境をつなぐ共通インターフェースを提供します。各環境はresetメソッドとstepメソッドに加え、観測空間と行動空間を公開するため、学習コードを変更せずに、ある環境向けに書いたエージェントを別の環境で実行できます。

ライブラリには、Classic Control、Box2D、Toy Text、MuJoCo、Atariの各ファミリーに分類された標準環境群が含まれています。`gymnasium.make`関数を使い、「CartPole-v1」のようなIDで環境を作成できます。一部の物理エンジンやエミュレーターの依存関係は、すべてのシステムで簡単にインストールできるわけではないため、追加の環境ファミリーはオプションのextrasとしてインストールします（例：`pip install "gymnasium[atari]"`）。環境IDにはバージョンサフィックスが付いており、学習結果に影響する可能性のある変更が加わると更新されます。

GymnasiumはOpenAI Gymからフォークされたプロジェクトで、OpenAIから保守を引き継いだ後はFarama Foundationがメンテナンスしています。同じAPIに準拠したサードパーティー製環境も利用でき、マルチエージェント向けのPettingZooなど、関連ライブラリと併用されています。

主な機能

  • 01対応するすべての環境で共通の標準reset/step API
  • 02Classic Control、Box2D、Toy Text、MuJoCo、Atariなどの組み込み環境ファミリー
  • 03`gymnasium.make`を使い、IDで環境を作成
  • 04必要な環境ファミリーだけをインストールできるオプションの依存関係extras
  • 05結果の再現性を保つ、バージョン付き環境ID

ユースケース

  • 標準タスクで新しい強化学習アルゴリズムをベンチマークする
  • CartPoleやToy Textなどのシンプルな環境を使って強化学習を教える
  • 小規模な離散環境でエージェントの実装をデバッグする
  • 既存のエージェントコードに独自またはサードパーティー製の環境を接続する

クイックスタート

  1. 1

    pipでベースライブラリをインストールする

    pip install gymnasium
  2. 2

    Atariなど、1つの環境ファミリー向けの追加依存関係をインストールする

    pip install "gymnasium[atari]"
  3. 3

    環境を作成し、READMEのサンプルコードを使ってステップ実行する

使う前に知っておきたいこと

  • 多くの環境ファミリーでは追加の依存関係が必要で、一部は特定のシステムにインストールするのが困難です。

トピック

#reinforcement-learning#machine-learning#python#simulation#benchmark#openai-gym#api#gym

よくある質問

Gymnasium とは？
単一エージェントの強化学習環境向け標準Python APIと、OpenAI Gymからフォークした参照環境群。 Gymnasiumは、強化学習アルゴリズムと学習に使う環境をつなぐ共通インターフェースを提供します。各環境はresetメソッドとstepメソッドに加え、観測空間と行動空間を公開するため、学習コードを変更せずに、ある環境向けに書いたエージェントを別の環境で実行できます。
Gymnasium は無料で使えますか？ライセンスは？
Gymnasium は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Gymnasium は今もメンテナンスされていますか？
活発にメンテナンス中。Gymnasium の最終コミットは 2026年10月14日 です。
Gymnasium は何に使えますか？
標準タスクで新しい強化学習アルゴリズムをベンチマークする CartPoleやToy Textなどのシンプルな環境を使って強化学習を教える 小規模な離散環境でエージェントの実装をデバッグする 既存のエージェントコードに独自またはサードパーティー製の環境を接続する
Gymnasium のインストール方法は？
pipでベースライブラリをインストールする: pip install gymnasium Atariなど、1つの環境ファミリー向けの追加依存関係をインストールする: pip install "gymnasium[atari]" 環境を作成し、READMEのサンプルコードを使ってステップ実行する
Gymnasium はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/Farama-Foundation/Gymnasium

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト