Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/google/ml-fairness-gym
https://github.com/google/ml-fairness-gym
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/google/ml-fairness-gym
- Owner: google
- License: apache-2.0
- Created: 2019-08-06T14:03:17.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-08T12:27:31.000Z (almost 2 years ago)
- Last Synced: 2024-08-03T23:25:50.697Z (5 months ago)
- Language: Python
- Size: 6.96 MB
- Stars: 311
- Watchers: 17
- Forks: 79
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-machine-learning-resources - **[Library - fairness-gym?style=social) (Table of Contents)
- awesome-responsible-ai - ML-Fairness-Gym
README
# What is ML-fairness-gym?
ML-fairness-gym is a set of components for building simple simulations that explore the potential long-run impacts of deploying machine learning-based decision systems in social environments. As the importance of machine learning fairness has become increasingly apparent, recent research has focused on potentially surprising long term behaviors of enforcing measures of fairness that were originally defined in a static setting. Key findings have shown that under specific assumptions in simplified dynamic simulations, long term effects may in fact counteract the desired goals. Achieving a deeper understanding of such long term effects is thus a critical direction for ML fairness research. ML-fairness-gym implements a generalized framework for studying and probing long term fairness effects in carefully constructed simulation scenarios where a learning agent interacts with an environment over time. This work fits into a larger push in the fair machine learning literature to design decision systems that induce fair outcomes in the long run, and to understand how these systems might differ from those designed to enforce fairness on a one-shot basis.
This initial version of the ML-fairness-gym (v 0.1.0) focuses on reproducing and generalizing environments that have [previously been discussed in research papers](docs/FAQ.md#What-research-results-have-been-replicated-with-ML-fairness-gym).
ML-fairness-gym environments implement the environment API from [OpenAI Gym](https://github.com/openai/gym).
This is not an officially supported Google product.
# Contents
* [Installation instructions](docs/installation.md)
* [Quick start guide](docs/quickstart.md)
* [Frequently asked questions](docs/FAQ.md)
* [Using ML-fairness-gym](docs/using_ml_fairness_gym.md)
* [Using the configurable runner](docs/using_runner.md)
* [Environments](environments/README.md)
* [Experiments](experiments/README.md)
# Contact us
The ML fairness gym project discussion group is:
[email protected].
# Versions
v0.1.0: Initial release.
v0.1.1: Update to use gym 0.19.0.