ai-economist-Foundation: An Economics Simulation Framework-Stephan Zheng, Alex Trott, Sunil Srinivasa
发布:2020-12-22 12:22:29.330549
作者:Stephan Zheng, Alex Trott, Sunil Srinivasa
### 作者邮箱:stephan.zheng@salesforce.com
### 首页:https://github.com/salesforce/ai-economist
### 文档:None
### 下载链接
# Foundation: An Economic Simulation Framework
This repo contains an implementation of Foundation, a framework for flexible, modular, and composable environments that model socio-economic behaviors and dynamics in a society with both agents and governments.
Foundation provides a Gym-style API:
reset
: resets the environment's state and returns the observation.step
: advances the environment by one timestep, and returns the tuple (observation, reward, done, info).
This simulation can be used in conjunction with reinforcement learning to learn optimal economic policies, as detailed in:
The AI Economist: Improving Equality and Productivity with AI-Driven Tax Policies, Stephan Zheng, Alexander Trott, Sunil Srinivasa, Nikhil Naik, Melvin Gruesbeck, David C. Parkes, Richard Socher.
If you use this code in your research, please cite us using this BibTeX entry:
@misc{2004.13332,
Author = {Stephan Zheng, Alexander Trott, Sunil Srinivasa, Nikhil Naik, Melvin Gruesbeck, David C. Parkes, Richard Socher},
Title = {The AI Economist: Improving Equality and Productivity with AI-Driven Tax Policies},
Year = {2020},
Eprint = {arXiv:2004.13332},
}
For more information and context, check out:
- The AI Economist website
- Blog: The AI Economist: Improving Equality and Productivity with AI-Driven Tax Policies
- Blog: The AI Economist moonshot
Join us on Slack
If you're interested in extending this framework, discussing machine learning for economics, and collaborating on research project:
- join our Slack channel aieconomist.slack.com using this invite link, or
- email us @ ai.economist@salesforce.com.
Installation Instructions
To get started, you'll need to have Python 3.6+ installed.
Using pip
Simply use the Python package manager:
pip install ai-economist
Installing from Source
Clone this repository to your local machine:
git clone www.github.com/salesforce/ai-economist
Create a new conda environment (named "ai-economist" below - replace with anything else) and activate it
conda create --name ai-economist python=3.6 conda activate ai-economist
Either
a) Edit the PYTHONPATH to include the ai-economist directory
export PYTHONPATH=<local path to ai-economist>:$PYTHONPATH
OR
b) Install as an editable Python package
cd ai-economist pip install -e .
Useful tip: for quick access, add the following to your ~/.bashrc or ~/.bash_profile:
alias aiecon="conda activate ai-economist; cd <local path to ai-economist>"
You can then simply run aiecon
once to activate the conda environment.
Testing your Install
To test your installation, try running:
conda activate ai-economist
python -c "import ai_economist"
Getting Started
Tutorials
To familiarize yourself with Foundation, check out the tutorials in the tutorials
folder. You can run these notebooks interactively in your browser on Google Colab.
- tutorials/economic_simulation_basic.ipynb (Try this on Colab!): Shows how to interact with and visualize the simulation.
- tutorials/economic_simulation_advanced.ipynb (Try this on Colab!): Explains how Foundation is built up using composable and flexible building blocks.
To run these notebooks locally, you need Jupyter. See https://jupyter.readthedocs.io/en/latest/install.html for installation instructions and (https://jupyter-notebook.readthedocs.io/en/stable/ for examples of how to work with Jupyter.
Structure of the Code
The simulation is located in the ai_economist/foundation
folder.
The code repository is organized into the following components:
| Component | Description | | --- | --- | | base | Contains base classes to can be extended to define Agents, Components and Scenarios. | | agents | Agents represent economic actors in the environment. Currently, we have mobile Agents (representing workers) and a social planner (representing a government). | | entities | Endogenous and exogenous components of the environment. Endogenous entities include labor, while exogenous entity includes landmarks (such as Water and Grass) and collectible Resources (such as Wood and Stone). | | components | Components are used to add some particular dynamics to an environment. They also add action spaces that define how Agents can interact with the environment via the Component. | | scenarios | Scenarios compose Components to define the dynamics of the world. It also computes rewards and exposes state for visualization. |
Releases and Contributing
- Please let us know if you encounter any bugs by filing a Github issue.
- We appreciate all your contributions. If you plan to contribute new Components, Scenarios Entities, or anything else, please see our contribution guidelines.
Changelog
Current version: v1.1.1
For the complete release history, see CHANGELOG.md.
License
Foundation and the AI Economist are released under the BSD-3 License.
Copy from pypi.org
查询时间:128.825ms
渲染时间:128.959ms
本文同步分享在 博客“zhenruyan”(other)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。