Repolode
XiaoLuoLYG

XiaoLuoLYG/GOD

Uma sala de controle no navegador para executar sociedades de agentes LLM e pausar, questionar, orientar e rever cidades simuladas passo a passo.

Estrelas
1,228
Forks
136
Issues abertas
9
Último commit
há 18 dias

O que é?

GOD é uma sala de controle local para simulações de sociedades de agentes baseados em modelos de linguagem. Em vez de apenas assistir à simulação, você pode pausá-la em qualquer etapa, percorrer a gravação ou reproduzi-la automaticamente, fazer uma pergunta a um morador, a um grupo ou à cidade inteira e inserir instruções que os agentes lerão no turno seguinte.

O projeto executa um backend local em FastAPI, uma interface de navegador em React/Vite e um runtime de agentes em outro processo, conectado por um WebSocket local. Um assistente de configuração define qualquer endpoint de modelo compatível com OpenAI, um cenário e perfis de agentes, e então inicia o experimento. Experimentos, mapas e conjuntos de agentes podem ser exportados e importados como pacotes ZIP.

O projeto inclui dois experimentos prontos, ambientados em uma cidade pixelada baseada em Tiled e em um mapa do campus da PKU, além de uma reprodução que funciona apenas no navegador pelo GitHub Pages, sem precisar instalar nada nem de uma chave de API.

Recursos principais

  • 01Pause, percorra e reproduza automaticamente uma simulação ao vivo ou gravada, etapa por etapa.
  • 02Envie perguntas direcionadas a um agente, a um grupo ou à cidade inteira durante a execução.
  • 03Insira instruções para os agentes lerem no turno seguinte.
  • 04Assistente de configuração no navegador para definir o modelo, o cenário e gerar agentes.
  • 05Map Studio e Agent Studio para editar mapas e moradores.
  • 06Importe e exporte pacotes de experimentos, mapas e agentes como arquivos ZIP.

Casos de uso

  • Inspecionar o comportamento de agentes LLM em um cenário social com roteiro.
  • Testar como intervenções alteram os resultados de uma comunidade simulada, etapa por etapa.
  • Compartilhar uma simulação reproduzível de agentes como um pacote para download.
  • Criar protótipos de mapas personalizados e perfis de moradores para experimentos baseados em agentes.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/XiaoLuoLYG/GOD.git
  2. 2

    Entre no diretório do projeto

    cd GOD
  3. 3

    Inicie o GOD (macOS/Linux); o assistente de configuração será aberto no navegador

    ./scripts/god.sh start

Antes de usar

  • Para executar localmente, é necessária uma chave de API e um endpoint de modelo compatível com OpenAI, solicitados pelo assistente de configuração.
  • O README também descreve a inicialização no Windows por meio de um iniciador do PowerShell, usando um comando separado.
  • O README afirma que a ferramenta foi criada para inspecionar sociedades de agentes de linguagem, não para alegar que elas sejam socialmente realistas.

Tópicos

Perguntas frequentes

O que é GOD?
Uma sala de controle no navegador para executar sociedades de agentes LLM e pausar, questionar, orientar e rever cidades simuladas passo a passo. GOD é uma sala de controle local para simulações de sociedades de agentes baseados em modelos de linguagem. Em vez de apenas assistir à simulação, você pode pausá-la em qualquer etapa, percorrer a gravação ou reproduzi-la automaticamente, fazer uma pergunta a um morador, a um grupo ou à cidade inteira e inserir instruções que os agentes lerão no turno seguinte.
GOD é gratuito? Qual é a licença?
GOD é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
GOD ainda é mantido?
Manutenção ativa. O último commit de GOD foi em 2 de out. de 2026.
Para que posso usar GOD?
Inspecionar o comportamento de agentes LLM em um cenário social com roteiro. Testar como intervenções alteram os resultados de uma comunidade simulada, etapa por etapa. Compartilhar uma simulação reproduzível de agentes como um pacote para download. Criar protótipos de mapas personalizados e perfis de moradores para experimentos baseados em agentes.
Como instalar GOD?
Clone o repositório: git clone https://github.com/XiaoLuoLYG/GOD.git Entre no diretório do projeto: cd GOD Inicie o GOD (macOS/Linux); o assistente de configuração será aberto no navegador: ./scripts/god.sh start
Onde consigo GOD?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/XiaoLuoLYG/GOD

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

Projetos relacionados