Report Abuse

Basic Information

This repository implements the Generative Agents research paper using Guidance, Langchain, and local LLMs. It provides a reproducible implementation and an example notebook that recreate agent behaviors described in the paper, adapted from a LangChain example and extended to match original features where possible. The code targets local quantized models via GPTQ-for-LLaMa and uses a vector store implementation such as Faiss for memory and retrieval. The README documents installation notes including Guidance pinned to 0.0.63 and LangChain 0.0.190, a recommended model used in experiments, and example usage that constructs a GenerativeAgent, adds memories, obtains summaries, updates planning status, elicits reactions, and generates dialogues and interviews. The project is distributed under a Creative Commons Attribution-NonCommercial license.

Links

Categorization

App Details

Features
Supports running generative agents with local LLMs and quantized models. Implements memory and retrieval using a vector store to store and query agent observations. Provides reflection and summary generation to distill agent state and background. Includes planning and re-planning routines, with a note that planning needs further improvement. Enables reacting to observations, dialogue generation between agents, and scripted interview functionality. Ships example code and a notebook demonstrating a GenerativeAgent class with methods to add memories, get summary, update status, react to events, and produce dialogue logs. Recommends a specific Guidance version for stability and allows swapping vector store backends. Web UI via Gradio is noted as not yet implemented.
Use Cases
This repository helps developers and researchers reproduce and experiment with the generative agents paper using their own local models and tools. It provides concrete examples and a notebook that show how to initialize agents, populate and query episodic memories, derive summaries and reflections, trigger reactions and dialogue, and inspect planning status. It supports integration with quantized GPTQ models and common vector stores so teams can evaluate performance and cost locally. The codebase is useful for prototyping agent behaviors, comparing retrieval and reflection strategies, extending the agent class, and swapping components such as embeddings or vector stores. The README lists installation prerequisites, example usage snippets, and the license, making it easier to get started with local experiments.

Please fill the required fields*