Repolode
Thytu

Thytu/Agentarium

Framework Python para criar simulações com agentes de IA que conversam, agem, lembram de interações e executam ações personalizadas em ambientes compartilhados.

Estrelas
934
Forks
75
Issues abertas
1
Último commit
há 29 dias

O que é?

Agentarium é um framework Python para criar e gerenciar simulações multiagente. Cada agente é criado com um nome e características opcionais, como ocupação, idade, localização e biografia. Os agentes podem enviar mensagens uns aos outros, decidir sua próxima ação com base no contexto atual e guardar na memória interações anteriores.

Além dos comportamentos integrados de conversar e pensar, desenvolvedores podem registrar ações personalizadas com nome, descrição, parâmetros e uma função Python, e então fazer com que os agentes as executem. Um CheckpointManager salva e restaura estados dos agentes e interações, permitindo repetir execuções de uma simulação. O acesso a LLMs é feito pelo aisuite, e o provedor e o modelo são definidos em um arquivo de configuração YAML.

O pacote está publicado no PyPI e requer Python 3.10 ou posterior. Há projetos de exemplo no diretório examples.

Recursos principais

  • 01Criar agentes com nomes, ocupações e outros atributos pessoais.
  • 02Agentes conversam entre si e escolhem sua próxima ação de forma autônoma.
  • 03Registrar ações personalizadas com parâmetros e funções Python.
  • 04Salvar e restaurar estados dos agentes e interações com o CheckpointManager.
  • 05Conectar-se a vários provedores de LLM por meio do aisuite, configurado via YAML.

Casos de uso

  • Prototipar simulações em que vários personagens orientados por LLM interagem.
  • Estudar comportamentos de agentes que dependem da memória e de interações anteriores.
  • Executar experimentos multiagente reproduzíveis com checkpoints salvos.
  • Adicionar ações específicas de um domínio a agentes de LLM em uma base de código Python.

Início rápido

  1. 1

    Instale o pacote pelo PyPI

    pip install agentarium
  2. 2

    Configure um provedor de LLM usando o arquivo de configuração de exemplo

  3. 3

    Crie agentes e faça com que conversem e ajam

Antes de usar

  • É necessário configurar um provedor de LLM com credenciais, como uma chave de API, antes de executar os agentes.
  • A integração com provedores depende do aisuite, o que adiciona uma dependência externa.

Em coleções

Tópicos

Perguntas frequentes

O que é Agentarium?
Framework Python para criar simulações com agentes de IA que conversam, agem, lembram de interações e executam ações personalizadas em ambientes compartilhados. Agentarium é um framework Python para criar e gerenciar simulações multiagente. Cada agente é criado com um nome e características opcionais, como ocupação, idade, localização e biografia. Os agentes podem enviar mensagens uns aos outros, decidir sua próxima ação com base no contexto atual e guardar na memória interações anteriores.
Agentarium é gratuito? Qual é a licença?
Agentarium é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Agentarium ainda é mantido?
Manutenção ativa. O último commit de Agentarium foi em 9 de out. de 2026.
Para que posso usar Agentarium?
Prototipar simulações em que vários personagens orientados por LLM interagem. Estudar comportamentos de agentes que dependem da memória e de interações anteriores. Executar experimentos multiagente reproduzíveis com checkpoints salvos. Adicionar ações específicas de um domínio a agentes de LLM em uma base de código Python.
Como instalar Agentarium?
Instale o pacote pelo PyPI: pip install agentarium Configure um provedor de LLM usando o arquivo de configuração de exemplo Crie agentes e faça com que conversem e ajam
Onde consigo Agentarium?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Thytu/Agentarium

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

Projetos relacionados