Implementações em PyTorch de algoritmos de aprendizado por reforço, projetadas como uma base confiável e consistente para pesquisa e aplicações.
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
Instale a biblioteca base com pip
pip install gymnasium - 2
Instale dependências extras para uma família de ambientes, como Atari
pip install "gymnasium[atari]" - 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
Plataforma de investimento quantitativo orientada a IA da Microsoft, que abrange dados, treinamento de modelos, backtesting e execução de ordens para pesquisa quantitativa.
Ray é um framework unificado para escalar aplicações Python e de IA, do laptop ao cluster, com runtime distribuído e bibliotecas de IA.
Um framework Python para criar, escalar e implantar workflows de IA e ML, de protótipos em notebooks a orquestradores de produção.
Plataforma de cloud self-hosted para executar uma equipe colaborativa de agentes de IA que podem chamar e interagir uns com os outros.
Framework personalizável para avaliar LLMs, VLMs e modelos de AIGC em benchmarks, testar o desempenho de inferência sob carga e visualizar resultados em dashboards.