Skip to content

v1.1.0 — Healthcare Readmission Audit + 4 Explainers

Choose a tag to compare

@yakew7 yakew7 released this 09 Jun 08:18
67401f5

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