Skip to content

Releases: yakew7/Fair-Code

v1.1.0 — Healthcare Readmission Audit + 4 Explainers

09 Jun 08:18
67401f5

Choose a tag to compare

Fair Code's second tagged release. Adds the sixth bias audit — clinical AI — plus four new explainers covering foundational AI concepts.
What's included
1 bias audit

Healthcare Readmission (Diabetes 130-US Hospitals, 101,766 records) — Race: 25% reduction, Age: 68% reduction, Gender: +100% ↑ (gap worsened — proxy removal backfired. Payer code was suppressing the gender signal while also encoding it. Remove it, and the suppression disappears. This is proxy entanglement — and pre-processing mitigation can't fix it. That's a future audit.)

4 explainers

What Happens Inside a Neural Network
Why AI Hallucinates
What Is Reinforcement Learning
What Is Proxy Entanglement

6 Jupyter notebooks — full walkthrough of every audit with visualisations and proxy detection
Live website — fair-code-five.vercel.app
CI pipeline — all audit scripts run automatically on every push and PR

What's Changed

  • Update matplotlib requirement from >=3.10.8 to >=3.10.9 by @dependabot[bot] in #37
  • Update pandas requirement from >=3.0.2 to >=3.0.3 by @dependabot[bot] in #38
  • Update numpy requirement from >=2.4.4 to >=2.4.6 by @dependabot[bot] in #39
  • Update scikit-learn requirement from >=1.8.0 to >=1.9.0 by @dependabot[bot] in #41
  • Refactor dataset structure in README.md by @yakew7 in #42
  • Explainer: Why AI Hallucinates Added by @Shreyash0712 in #43
  • Update README with new document and formatting changes by @yakew7 in #44
  • Update CHANGELOG.md for version 1.1.0 by @yakew7 in #45
  • Fix: First Interaction Trigger Change, Audits Workflow Enhancement and Version Upgrade by @Shreyash0712 in #46
  • Delete .github/workflows/update-changelog.yml by @yakew7 in #47
  • Create reinforcement-learning.md by @evanjain-dot in #48
  • Create explainer for Proxy Entanglement by @yakew7 in #49
  • Add proxy-entanglement.md to contributing guidelines by @yakew7 in #50

New Contributors

Full Changelog: v1.0.0...v1.1.0

v1.0.0 — First Stable Release

02 Jun 06:29
741eba0

Choose a tag to compare

Fair Code's first tagged release. The project has been live and open to contributors since May 2026. This tag marks the point where the core scope is complete: 5 audits, 13 explainers, full notebook walkthroughs, a live website, and a CI pipeline.

What's included

5 bias audits

  • Criminal Justice (COMPAS, 70,000+ records) -71% gap reduction
  • Hiring (AI Fair Recruitment, ~6,500 records) - 97.3% gap reduction
  • Lending (German Credit, 1,000 records) - 73.6% gap reduction
  • Healthcare (Insurance Denial, 1,340 records) - 60–72% gap reduction
  • Welfare Eligibility (UCI Adult Census, 48,842 records) - 46–88% gap reduction

13 explainers
Proxy Variables, Equalized Odds, Sampling Bias, SHAP Values, Disparate Impact, Disparate Treatment, Fairness Metric Conflicts, Calibration, Demographic Parity, Feedback Loop Bias, Label Bias, Individual Fairness, Counterfactual Fairness

5 Jupyter notebooks - full walkthrough of every audit with visualisations and proxy detection

Live website - fair-code-five.vercel.app

CI pipeline - all audit scripts run automatically on every push and PR