Repolode
Farama-Foundation

Farama-Foundation/Gymnasium

Uma API Python padrão para ambientes de aprendizado por reforço com agente único, além de um conjunto de ambientes de referência, derivado do Gym da OpenAI.

Estrelas
12,704
Forks
1,513
Issues abertas
117
Último commit
há 7 dias

O que é?

O Gymnasium oferece uma interface comum entre algoritmos de aprendizado por reforço e os ambientes nos quais eles são treinados. Cada ambiente disponibiliza os métodos `reset` e `step`, além dos espaços de observação e ação, permitindo executar em outro ambiente um agente desenvolvido para um deles, sem alterar o código de aprendizado.

A biblioteca inclui um conjunto padrão de ambientes, organizados nas famílias Classic Control, Box2D, Toy Text, MuJoCo e Atari. A função `gymnasium.make` os cria pelo ID, como "CartPole-v1". Famílias adicionais são instaladas como extras opcionais — por exemplo, com `pip install "gymnasium[atari]"` — porque algumas dependências de física e emuladores são difíceis de instalar em todos os sistemas. Os IDs dos ambientes incluem sufixos de versão, incrementados quando mudanças podem afetar os resultados do aprendizado.

O Gymnasium é um fork do Gym da OpenAI, mantido pela Farama Foundation depois que a OpenAI transferiu a manutenção. Ambientes de terceiros que seguem a mesma API podem ser usados com ele, e o projeto é usado em conjunto com bibliotecas relacionadas, como PettingZoo, para trabalhos com múltiplos agentes.

Recursos principais

  • 01API padrão com `reset` e `step`, compartilhada por todos os ambientes compatíveis
  • 02Famílias de ambientes integradas, incluindo Classic Control, Box2D, Toy Text, MuJoCo e Atari
  • 03Criação de ambientes pelo ID com `gymnasium.make`
  • 04Extras de dependências opcionais para instalar apenas as famílias de ambientes necessárias
  • 05IDs de ambientes com versão para manter os resultados reproduzíveis

Casos de uso

  • Avaliar um novo algoritmo de aprendizado por reforço em tarefas padrão
  • Ensinar aprendizado por reforço com ambientes simples, como CartPole e Toy Text
  • Depurar implementações de agentes com ambientes discretos pequenos
  • Integrar um ambiente personalizado ou de terceiros ao código existente de um agente

Início rápido

  1. 1

    Instale a biblioteca base com pip

    pip install gymnasium
  2. 2

    Instale dependências extras para uma família de ambientes, como Atari

    pip install "gymnasium[atari]"
  3. 3

    Crie um ambiente e avance passo a passo com o código de exemplo do README

Antes de usar

  • Muitas famílias de ambientes precisam de dependências extras, e algumas são difíceis de instalar em determinados sistemas.

Tópicos

Perguntas frequentes

O que é Gymnasium?
Uma API Python padrão para ambientes de aprendizado por reforço com agente único, além de um conjunto de ambientes de referência, derivado do Gym da OpenAI. O Gymnasium oferece uma interface comum entre algoritmos de aprendizado por reforço e os ambientes nos quais eles são treinados. Cada ambiente disponibiliza os métodos `reset` e `step`, além dos espaços de observação e ação, permitindo executar em outro ambiente um agente desenvolvido para um deles, sem alterar o código de aprendizado.
Gymnasium é gratuito? Qual é a licença?
Gymnasium é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Gymnasium ainda é mantido?
Manutenção ativa. O último commit de Gymnasium foi em 14 de out. de 2026.
Para que posso usar Gymnasium?
Avaliar um novo algoritmo de aprendizado por reforço em tarefas padrão Ensinar aprendizado por reforço com ambientes simples, como CartPole e Toy Text Depurar implementações de agentes com ambientes discretos pequenos Integrar um ambiente personalizado ou de terceiros ao código existente de um agente
Como instalar Gymnasium?
Instale a biblioteca base com pip: pip install gymnasium Instale dependências extras para uma família de ambientes, como Atari: pip install "gymnasium[atari]" Crie um ambiente e avance passo a passo com o código de exemplo do README
Onde consigo Gymnasium?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Farama-Foundation/Gymnasium

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados