Repolode
Farama-Foundation

Farama-Foundation/PettingZoo

Biblioteca Python com uma API padrão e ambientes de referência para pesquisa em aprendizado por reforço multiagente, semelhante ao Gymnasium.

Estrelas
3,553
Forks
555
Issues abertas
70
Último commit
há 8 dias

O que é?

PettingZoo é uma biblioteca Python para pesquisa em aprendizado por reforço multiagente. Ela cumpre, para cenários multiagente, o mesmo papel que o Gymnasium desempenha para cenários com um único agente: os ambientes compartilham uma interface, então pesquisadores podem escrever um algoritmo uma vez e executá-lo em várias tarefas.

Os ambientes são modelados como jogos Agent Environment Cycle (AEC), que permitem representar cenários com turnos e ações simultâneas usando uma única API. Uma API Parallel complementar atende a jogos em que os agentes agem ao mesmo tempo. A biblioteca inclui famílias de ambientes, entre elas jogos multiplayer de Atari 2600, jogos gráficos cooperativos, jogos clássicos de cartas e tabuleiro e um conjunto de tarefas cooperativas SISL.

O pacote básico é instalado com pip, e extras por família, como pettingzoo[atari], instalam dependências opcionais. Linux e macOS têm suporte oficial. A biblioteca complementar SuperSuit oferece wrappers comuns de RL para ambientes do PettingZoo e do Gymnasium, e tutoriais mostram como treinar com CleanRL, Tianshou e AgileRL.

Recursos principais

  • 01API padrão para ambientes multiagente baseada em jogos AEC
  • 02API Parallel para jogos em que os agentes agem simultaneamente
  • 03Famílias de ambientes que abrangem Atari, jogos gráficos cooperativos, jogos clássicos e tarefas SISL
  • 04Interface de reset, step e iteração semelhante à do Gymnasium
  • 05Instalação opcional por família usando extras do pip

Casos de uso

  • Avaliar algoritmos de RL multiagente em um conjunto compartilhado de ambientes
  • Prototipar o treinamento de agentes cooperativos ou competitivos
  • Criar ambientes multiagente personalizados com uma interface padrão
  • Treinar agentes com CleanRL, Tianshou ou AgileRL em tarefas do PettingZoo

Início rápido

  1. 1

    Instale a biblioteca base do PettingZoo

    pip install pettingzoo
  2. 2

    Instale as dependências de uma família de ambientes (por exemplo, Atari)

    pip install 'pettingzoo[atari]'
  3. 3

    Crie um ambiente e execute um loop com ações aleatórias

Antes de usar

  • O suporte oficial é apenas para Linux e macOS; o Windows não tem suporte oficial.
  • Algumas famílias de ambientes podem ser difíceis de instalar em determinados sistemas.

Em coleções

Tópicos

#reinforcement-learning#multi-agent#gymnasium#python#simulation#research#api#multi-agent-reinforcement-learning#multiagent-reinforcement-learning

Perguntas frequentes

O que é PettingZoo?
Biblioteca Python com uma API padrão e ambientes de referência para pesquisa em aprendizado por reforço multiagente, semelhante ao Gymnasium. PettingZoo é uma biblioteca Python para pesquisa em aprendizado por reforço multiagente. Ela cumpre, para cenários multiagente, o mesmo papel que o Gymnasium desempenha para cenários com um único agente: os ambientes compartilham uma interface, então pesquisadores podem escrever um algoritmo uma vez e executá-lo em várias tarefas.
PettingZoo é gratuito? Qual é a licença?
PettingZoo é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
PettingZoo ainda é mantido?
Manutenção ativa. O último commit de PettingZoo foi em 30 de out. de 2026.
Para que posso usar PettingZoo?
Avaliar algoritmos de RL multiagente em um conjunto compartilhado de ambientes Prototipar o treinamento de agentes cooperativos ou competitivos Criar ambientes multiagente personalizados com uma interface padrão Treinar agentes com CleanRL, Tianshou ou AgileRL em tarefas do PettingZoo
Como instalar PettingZoo?
Instale a biblioteca base do PettingZoo: pip install pettingzoo Instale as dependências de uma família de ambientes (por exemplo, Atari): pip install 'pettingzoo[atari]' Crie um ambiente e execute um loop com ações aleatórias
Onde consigo PettingZoo?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Farama-Foundation/PettingZoo

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

Projetos relacionados