Repolode
XiaoLuoLYG

XiaoLuoLYG/GOD

Una sala de control en el navegador para ejecutar sociedades de agentes LLM, pausar, hacer preguntas, dirigir y reproducir pueblos simulados paso a paso.

Estrellas
1,228
Forks
136
Issues abiertos
9
Último commit
hace 18 días

¿Qué es?

GOD es una sala de control local para simulaciones de sociedades de agentes basados en modelos de lenguaje. En lugar de limitarte a observar cómo se ejecuta una simulación, puedes pausarla en cualquier paso, avanzar o retroceder por la reproducción, reproducirla automáticamente, hacerle una pregunta a un residente, a un grupo o a todo el pueblo e introducir instrucciones que los agentes leerán en su siguiente turno.

El proyecto ejecuta un backend local con FastAPI, una interfaz de navegador con React/Vite y un entorno de ejecución de agentes externo al proceso, conectado mediante un WebSocket local. Un asistente de configuración permite elegir cualquier endpoint de modelo compatible con OpenAI, un escenario y perfiles de agentes, y luego iniciar el experimento. Los experimentos, mapas y conjuntos de agentes se pueden exportar e importar como paquetes ZIP.

Incluye dos experimentos integrados en un pueblo pixelado basado en Tiled y un mapa del campus de PKU, además de una reproducción que funciona solo en el navegador y está alojada en GitHub Pages, sin necesidad de instalar nada ni de usar una clave de API.

Funciones clave

  • 01Pausa, recorre y reproduce automáticamente una simulación en vivo o grabada, paso a paso.
  • 02Envía preguntas dirigidas a un agente, a un grupo o a todo el pueblo durante la ejecución.
  • 03Introduce instrucciones que los agentes leerán en su siguiente turno.
  • 04Asistente de configuración en el navegador para elegir el modelo y el escenario, y generar agentes.
  • 05Map Studio y Agent Studio para editar mapas y residentes.
  • 06Importa y exporta experimentos, mapas y conjuntos de agentes como archivos ZIP.

Casos de uso

  • Analizar cómo se comportan los agentes LLM en un escenario social guionizado.
  • Probar paso a paso cómo las intervenciones cambian los resultados de una comunidad simulada.
  • Compartir una simulación reproducible de agentes como paquete descargable.
  • Crear prototipos de mapas personalizados y perfiles de residentes para experimentos basados en agentes.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Entra en el directorio del proyecto

    cd GOD
  3. 3

    Inicia GOD (macOS/Linux); el asistente de configuración se abre en el navegador

    ./scripts/god.sh start

Antes de usarlo

  • Para ejecutarlo localmente se necesita una clave de API y un endpoint de un modelo compatible con OpenAI; el asistente de configuración los solicita.
  • El README también describe cómo iniciar el programa en Windows mediante un lanzador de PowerShell, con un comando distinto.
  • El README indica que está diseñado para estudiar sociedades de agentes lingüísticos, no para afirmar que sean socialmente realistas.

Temas

Preguntas frecuentes

¿Qué es GOD?
Una sala de control en el navegador para ejecutar sociedades de agentes LLM, pausar, hacer preguntas, dirigir y reproducir pueblos simulados paso a paso. GOD es una sala de control local para simulaciones de sociedades de agentes basados en modelos de lenguaje. En lugar de limitarte a observar cómo se ejecuta una simulación, puedes pausarla en cualquier paso, avanzar o retroceder por la reproducción, reproducirla automáticamente, hacerle una pregunta a un residente, a un grupo o a todo el pueblo e introducir instrucciones que los agentes leerán en su siguiente turno.
¿GOD es gratuito? ¿Qué licencia tiene?
GOD es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿GOD sigue mantenido?
Mantenimiento activo. El último commit de GOD fue el 2 oct 2026.
¿Para qué puedo usar GOD?
Analizar cómo se comportan los agentes LLM en un escenario social guionizado. Probar paso a paso cómo las intervenciones cambian los resultados de una comunidad simulada. Compartir una simulación reproducible de agentes como paquete descargable. Crear prototipos de mapas personalizados y perfiles de residentes para experimentos basados en agentes.
¿Cómo se instala GOD?
Clona el repositorio: git clone https://github.com/XiaoLuoLYG/GOD.git Entra en el directorio del proyecto: cd GOD Inicia GOD (macOS/Linux); el asistente de configuración se abre en el navegador: ./scripts/god.sh start
¿Dónde consigo GOD?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/XiaoLuoLYG/GOD

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados