How joonspk-research/generative_agents works
Generative Agents is a research simulation for believable human behavior in a Smallville-like game world. The documented workflow is to start the Django environment and simulation server, fork or name a simulation, run game steps, and view the agents in a browser; saved runs can be replayed or compressed for demos. The README also describes agent-history customization. Simulation internals and frontend views are not present in the supplied excerpts, so their relationships are omitted or marked unverified; paths for these subsystems use only directories shown in the tree.
Main entry points: backend_server Simulation server · frontend_server Django environment · compress_sim_storage.py Demo compression · storage Saved simulations
Components 20
Agent simulation
- Simulation server
reverie/backend_server - Generative agents
reverie/backend_server - Agent memory
reverie/backend_server - Agent actions
reverie/backend_server - Agent history
environment/frontend_server/static_dirs/assets/the_ville/agent_history_init_n25.csv
World environment
- Django environment
environment/frontend_server - Environment views
environment/frontend_server - World assets
environment/frontend_server/static_dirs/assets/the_ville - Replay and demo
environment/frontend_server - URL routes
environment/frontend_server/frontend_server/urls.py
Simulation persistence
- Saved simulations
environment/frontend_server/storage - Compressed demos
environment/frontend_server/compressed_storage - Demo compression
reverie/compress_sim_storage.py - Shared file utilities
reverie/global_methods.py
Configuration
- Base settings
environment/frontend_server/frontend_server/settings/base.py - Local settings
environment/frontend_server/frontend_server/settings/local.py - Settings selector
environment/frontend_server/frontend_server/settings/__init__.py
Other components
- Operator
- Browser user
- OpenAI API
Connections 19
- Operator → Simulation server: starts and runs
README.md - Operator → Django environment: starts
README.md - Browser user → Django environment: opens simulator
README.md - URL routes → Environment views: routes requests
environment/frontend_server/frontend_server/urls.py - Simulation server → Generative agents: runs steps
- Generative agents → Agent memory: uses memory
- Generative agents → Agent actions: produces actions
- Simulation server → Django environment: exchanges state
- Django environment → World assets: serves world
- Simulation server → OpenAI API: requests completions
- Simulation server → Saved simulations: saves runs
README.md - Replay and demo → Saved simulations: reads runs
README.md - Demo compression → Saved simulations: reads run data
reverie/compress_sim_storage.py - Demo compression → Compressed demos: writes demo data
reverie/compress_sim_storage.py - Demo compression → Shared file utilities: uses file helpers
reverie/compress_sim_storage.py - Replay and demo → Compressed demos: reads demo data
README.md - Generative agents → Agent history: loads history
README.md - Settings selector → Base settings: imports settings
environment/frontend_server/frontend_server/settings/__init__.py - Settings selector → Local settings: imports settings
environment/frontend_server/frontend_server/settings/__init__.py