Repositorio para el TFG de Kevin Arce y Alberto Ramos sobre un simulador multiagente dirigido por LLMs.
El objetivo principal de este Trabajo de Fin de Grado es democratizar el uso del estudio realizado en el siguiente paper: "Generative Agents: Interactive Simulacra of Human Behavior", así como extender algunas de las funcionalidades existentes en el mismo y modificar la manera de ejecutar de la aplicación completamente.
Dejar claro que todo el trabajo aquí presente es una continuación del repositorio "joonspk-research/generative_agents"
Por ello, hemos realizado esta documentación, la cual era algo complicada en el programa inicial, para que cualquier persona pueda ejecutar la aplicación sin problemas. Además, la hemos escrito en castellano para mayor facilidad.
Ahora, configurar el entorno será mucho más sencillo que antes. A continuación, se detallan los pasos a seguir para poder ejecutar la aplicación sin problemas.
Primero, es necesario crear un entorno virtual para instalar las dependencias necesarias. Para ello, se puede utilizar el siguiente comando:
python3 -m venv env
Una vez creado el entorno virtual, es necesario activarlo. Para ello, se puede utilizar el siguiente comando:
source env/bin/activate
Una vez activado el entorno virtual, es necesario instalar las dependencias necesarias. Para ello, se puede utilizar el siguiente comando:
pip install -r requirements.txt
Para poder ejecutar la aplicación, es necesario declarar la clave de la API de OpenAI como variable de entorno. Para ello, simplemente abriremos la terminal en la que tengamos activado el entorno virtual y ejecutaremos el siguiente comando:
OPENAI_API_KEY=<Tu clave de la API de OpenAI>
Para ejecutar una nueva simulación, será necesario iniciar dos servidores simultáneamente: el servidor de entorno y el servidor de simulación de agentes.
Exportar la variable de entorno "debug=false"
Ejecutar ./run.sh
Con todo esto, ya estamos listos para interactuar con la simulación. Para ello, simplemente abra su navegador favorito y vaya a http://localhost:8000/. Aquí podrá ver la página de landing, donde podrá acceder a la guía de usuario, para informarse de todo lo que puede hacer y ver ejemplos o ir directamente a la creación, ejecución y visualización de simulaciones.