# joonspk-research/generative_agents

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/joonspk-research-generative-agents).**

20,657 stars · 2,860 forks · apache-2.0

## Links

- GitHub: https://github.com/joonspk-research/generative_agents
- awesome-repositories: https://awesome-repositories.com/repository/joonspk-research-generative-agents.md

## Description

Generative Agents is a computational platform for simulating autonomous agents that exhibit human-like social behaviors and decision-making processes. The system functions as a multi-agent simulator where individual participants operate within a virtual environment, driven by large language models to process observations and generate natural language actions.

The framework distinguishes itself through a hierarchical memory system that allows agents to store, retrieve, and synthesize past experiences into higher-level insights. This architecture supports the development of complex social dynamics by enabling agents to maintain personal histories and evolve their behavior based on long-term memory and periodic reflection.

Users can design custom virtual environments using spatial-graph mapping and define specific agent narratives to study social interactions in controlled settings. The platform includes tools for state persistence and simulation replay, allowing for the systematic analysis of behavioral trends and the reconstruction of past events through a browser-based interface.

## Tags

### Artificial Intelligence & ML

- [Multi-Agent Orchestration Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-orchestrators/multi-agent-orchestration-frameworks.md) — Orchestrates autonomous agents with long-term memory to exhibit social behaviors in virtual environments.
- [Agent Reflection Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-reflection-systems.md) — Periodic background processes analyze stored memories to extract higher-level insights and patterns that inform future agent behavior and personality development.
- [Autonomous Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/autonomous-agents.md) — Provides a platform for managing virtual environments where agents interact autonomously.
- [LLM-Driven Agent Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/llm-driven-agent-loops.md) — Orchestrates agent reasoning by processing environmental context through large language models.
- [Autonomous Agent Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/autonomous-agent-orchestration.md) — Coordinates multiple autonomous agents to exhibit realistic social interactions and decision-making. ([source](https://github.com/joonspk-research/generative_agents#readme))
- [Computational Social Science Platforms](https://awesome-repositories.com/f/artificial-intelligence-ml/computational-social-science-platforms.md) — Serves as a research platform for simulating human-like social interactions and decision-making.
- [Agent Persona Initializers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agentic-workflows/agent-task-initiations/agent-persona-initializers.md) — Assign unique backgrounds and personal narratives to agents at the start of a simulation to influence their subsequent behaviors, memories, and social interactions with other participants. ([source](https://github.com/joonspk-research/generative_agents#readme))
- [Agent Memory Stores](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-memory-stores.md) — Provides persistent, structured storage for agent experiences and long-term memory retrieval.
- [Agent Simulation Environments](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-simulation-environments.md) — Runs computational agents within virtual environments to generate believable social behaviors. ([source](https://github.com/joonspk-research/generative_agents/blob/main/README.md))
- [Spatial Grid Environments](https://awesome-repositories.com/f/artificial-intelligence-ml/spatial-processing-operations/spatial-processing-operations/spatial-grid-environments.md) — The virtual world is represented as a grid of interconnected nodes that define physical boundaries and proximity for agent interaction and movement.
- [Agent State Persistence](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-state-persistence.md) — Serializes agent states into JSON to enable simulation snapshots and reconstruction.

### Game Development

- [Simulation Engines](https://awesome-repositories.com/f/game-development/simulation-engines.md) — Provides a simulation engine for constructing virtual environments and studying social dynamics.
- [Interactive Simulations](https://awesome-repositories.com/f/game-development/simulation-engines/interactive-simulations.md) — Supports the analysis of behavioral trends by replaying recorded agent activities.
- [Simulation Loops](https://awesome-repositories.com/f/game-development/simulation-engines/simulation-loops.md) — Manages the core execution timing and state update cycles for the virtual environment.

### Scientific & Mathematical Computing

- [Science and Research](https://awesome-repositories.com/f/scientific-mathematical-computing/research-analysis-workflows/research-and-data-analysis-tools/science-and-research.md) — Facilitates social science research by running controlled simulations of human-like dynamics.

### System Administration & Monitoring

- [Session Replays](https://awesome-repositories.com/f/system-administration-monitoring/ai-session-monitoring/session-replays.md) — Enables the visualization and replay of past simulation logs through a browser interface. ([source](https://github.com/joonspk-research/generative_agents#readme))

### Software Engineering & Architecture

- [Virtual World Creation Tools](https://awesome-repositories.com/f/software-engineering-architecture/virtual-world-creation-tools.md) — Provides tools for designing custom spatial layouts and physical constraints for virtual worlds. ([source](https://github.com/joonspk-research/generative_agents#readme))
