Skip to content

nayanagoudar26/fairly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ Fairly AI: Fairness Auditor Dashboard

Fairly AI is a high-performance, production-ready SaaS platform designed to detect, analyze, and mitigate algorithmic bias in machine learning models. Built with a premium Stripe-inspired UI and a robust FastAPI backend.


✨ Features

  • 📊 Advanced Fairness Metrics: Real-time auditing for Statistical Parity, Equal Opportunity, and Disparate Impact.
  • ⚡ Zero-Latency Simulations: High-speed "What-If" simulation engine using in-memory model caching.
  • 🎨 Premium SaaS UI: Interactive dashboard with glassmorphism, smooth animations, and high-fidelity Recharts.
  • 🛡️ Bias Mitigation: Automated remediation strategies using industry-standard reweighting and resampling.
  • 📄 Professional Reports: One-click PDF export for compliance and audit logging.

🚀 Tech Stack

Backend (FastAPI + Python)

  • FastAPI: Asynchronous high-performance API.
  • Scikit-Learn: Core ML and evaluation metrics.
  • Joblib: Efficient model persistence.
  • Pandas/Numpy: High-speed data processing.

Frontend (React + Vite)

  • Tailwind CSS: Modern, responsive styling.
  • Framer Motion: Smooth interactive animations.
  • Recharts: Data visualization.
  • Lucide React: Premium iconography.

🛠️ Getting Started

1. Prerequisites

  • Python 3.10+
  • Node.js 18+

2. Backend Setup 🐍

cd backend
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

3. Frontend Setup ⚛️

cd frontend
npm install
npm run dev

📁 Project Structure

├── backend/
│   ├── routes/          # API Endpoints (Analyzer, Predict, Chat)
│   ├── services/        # Logic (Bias Detection, Mitigation)
│   ├── main.py          # FastAPI Entry Point
│   └── .env             # Secrets (Ignored by Git)
├── frontend/
│   ├── src/
│   │   ├── components/  # Reusable UI Components
│   │   ├── pages/       # Dashboard and Analytics
│   │   └── services/    # API Interaction
│   └── tailwind.config.js
└── README.md

🤝 Contribution

Fairly is an open-source project aimed at making AI more equitable. Feel free to open an issue or submit a pull request! 🚀


⚖️ License

MIT License. Built with ❤️ for the Google Solution Challenge.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors