# AI Economist / Foundation

## Docs

- [Introduction](https://mintlify.wiki/salesforce/ai-economist/introduction.md): Foundation: a modular framework for economic simulation and multi-agent reinforcement learning
- [Installation](https://mintlify.wiki/salesforce/ai-economist/installation.md): Install Foundation via pip or from source
- [Quickstart](https://mintlify.wiki/salesforce/ai-economist/quickstart.md): Run your first economic simulation in minutes
- [Framework overview](https://mintlify.wiki/salesforce/ai-economist/concepts/framework-overview.md): How BaseEnvironment, Scenarios, Components, Agents, and Entities fit together in the Foundation framework.
- [Agents](https://mintlify.wiki/salesforce/ai-economist/concepts/agents.md): The two agent types in Foundation—BasicMobileAgent and BasicPlanner—and how to access and work with them.
- [Components](https://mintlify.wiki/salesforce/ai-economist/concepts/components.md): How Components extend environment dynamics by defining action spaces, state fields, per-step logic, observations, and masks.
- [Scenarios](https://mintlify.wiki/salesforce/ai-economist/concepts/scenarios.md): What Scenarios are, the abstract methods every Scenario must implement, and the built-in scenarios included in Foundation.
- [Entities](https://mintlify.wiki/salesforce/ai-economist/concepts/entities.md): Resources, Landmarks, and Endogenous variables—the entity types that compose the World state in Foundation.
- [Gather, Trade & Build](https://mintlify.wiki/salesforce/ai-economist/simulations/gather-trade-build.md): The flagship multi-agent economic simulation where agents gather wood and stone, trade resources in a continuous double auction, build houses, earn income, and pay taxes.
- [COVID-19 & Economy Simulation](https://mintlify.wiki/salesforce/ai-economist/simulations/covid19-economy.md): Jointly model pandemic health outcomes and economic activity across 51 US state-level agents and a federal government planner.
- [One-Step Economy](https://mintlify.wiki/salesforce/ai-economist/simulations/one-step-economy.md): A minimal two-timestep economic scenario for rapid RL experimentation with tax policy and labor supply.
- [Real Business Cycle](https://mintlify.wiki/salesforce/ai-economist/simulations/real-business-cycle.md): GPU-accelerated macroeconomic simulation with heterogeneous consumers, firms, and a government, implemented in CUDA C and trained with PyTorch.
- [Training Overview](https://mintlify.wiki/salesforce/ai-economist/training/overview.md): Multi-agent reinforcement learning with Foundation environments
- [Training with RLlib](https://mintlify.wiki/salesforce/ai-economist/training/rllib.md): Distributed multi-agent RL using Ray RLlib
- [GPU Training with WarpDrive](https://mintlify.wiki/salesforce/ai-economist/training/warpdrive-gpu.md): Massively parallel GPU-accelerated training using CUDA
- [Creating custom components](https://mintlify.wiki/salesforce/ai-economist/extending/custom-components.md): Extend Foundation with new agent-environment dynamics by subclassing BaseComponent.
- [Creating custom scenarios](https://mintlify.wiki/salesforce/ai-economist/extending/custom-scenarios.md): Build new economic simulation environments by subclassing BaseEnvironment.
- [Creating custom agents](https://mintlify.wiki/salesforce/ai-economist/extending/custom-agents.md): Define new agent types for your simulations by subclassing BaseAgent.
- [BaseEnvironment](https://mintlify.wiki/salesforce/ai-economist/api/base-environment.md): The base class for all Foundation simulation environments
- [EnvironmentWrapper](https://mintlify.wiki/salesforce/ai-economist/api/env-wrapper.md): Wraps Foundation environments for use with RLlib and WarpDrive
- [BaseComponent](https://mintlify.wiki/salesforce/ai-economist/api/base-component.md): Base class for all Foundation components
- [BaseAgent](https://mintlify.wiki/salesforce/ai-economist/api/base-agent.md): Base class for all Foundation agent types
- [Registries](https://mintlify.wiki/salesforce/ai-economist/api/registries.md): Registry system for managing Components, Scenarios, Agents, and Entities
- [Move](https://mintlify.wiki/salesforce/ai-economist/api/components/move.md): Component enabling mobile agents to move around the world and collect resources
- [Build](https://mintlify.wiki/salesforce/ai-economist/api/components/build.md): Component enabling agents to construct house landmarks using stone and wood
- [Continuous Double Auction](https://mintlify.wiki/salesforce/ai-economist/api/components/trading.md): Market mechanism for resource trading between agents via bids and asks
- [Redistribution](https://mintlify.wiki/salesforce/ai-economist/api/components/redistribution.md): Tax collection and redistribution components including periodic bracket taxes and flat wealth redistribution


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.