EconSimulacra

EconSimulacra is a simulation platform for studying complex socio-economic systems with large language model (LLM) agents. The framework enables researchers and practitioners to simulate household consumption, firm pricing strategies, narrative diffusion through social networks, and spatial mobility of agents.

User Guide

• Installation
  • PyPI
  • From Source
  • Optional: vLLM Backend
• Quick Start
  • Running the OpenAI Example
  • Minimal Custom Simulation
  • Registering Custom Classes
• Configuration Reference
  • Top-Level Structure
  • Simulation Configuration
  • Environment Configuration
  • Space Configuration
  • Social Network Configuration
  • Agent Configuration
  • Item Configuration
  • Event Configuration
• Architecture Overview
  • Simulation Loop
  • Spatial Layer — GridSpace
  • Social Layer — SocialNetwork
  • Market Layer — Items and Orders
  • Agent Layer
  • Event Layer
  • Logging

API Reference

• API Reference
  • Simulator
  • Agents
  • Environment
  • Items
  • Events
  • Logs
  • Memory
  • Social Networks
  • LLM Services
  • Log Analyses

Project

• Changelog