EconSimulacra
============================

.. image:: https://img.shields.io/pypi/pyversions/econsimulacra.svg
   :target: https://pypi.org/project/econsimulacra
.. image:: https://img.shields.io/pypi/v/econsimulacra.svg
   :target: https://pypi.org/project/econsimulacra
.. image:: https://github.com/SimulacraBusiness/econsimulacra/actions/workflows/ci.yml/badge.svg
   :target: https://github.com/SimulacraBusiness/econsimulacra/actions/workflows/ci.yml
.. image:: https://github.com/SimulacraBusiness/econsimulacra/actions/workflows/release.yml/badge.svg
   :target: https://github.com/SimulacraBusiness/econsimulacra/actions/workflows/release.yml
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black


**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.

.. toctree::
   :maxdepth: 2
   :caption: User Guide

   guide/installation
   guide/quickstart
   guide/configuration
   guide/architecture

.. toctree::
   :maxdepth: 2
   :caption: API Reference

   api/index

.. toctree::
   :maxdepth: 1
   :caption: Project

   changelog