🚨 "FairLens is a full-stack SaaS platform that enables teams to upload datasets and trained models, then receive comprehensive, interactive fairness audit reports. Built for production use with model-format agnosticism, audit versioning, and enterprise compliance features."
| Feature | Description |
|---|---|
| 🔍 Bias Heatmap | D3-rendered visualization of feature × protected attribute combinations with severity scoring |
| 🧪 What-if Simulator | Interactive prediction playground with SHAP explanations |
| 📊 Comprehensive Metrics | Demographic Parity, Equal Opportunity, Disparate Impact, Equalized Odds |
| 🔌 Model Agnostic | Support for Pickle, ONNX, and external API endpoints |
| 📜 Audit Versioning | Complete audit trail with dataset/model hashes for compliance |
| 📈 Drift Detection | Track fairness metrics across audit history |
# Clone the repository
git clone https://github.com/fairlens/fairlens.git
cd fairlens
# Start with Docker Compose (recommended)
docker-compose up -d
# Or run locally
# Backend
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload
# Frontend
cd frontend && npm install
npm run dev# 1. Install Firebase CLI
npm install -g firebase-tools
# 2. Login
firebase login
# 3. Create project at https://console.firebase.google.com
# Enable: Authentication, Firestore, Storage, Hosting
# 4. Initialize
firebase init
# Select: Hosting, Functions, Firestore, Storage
# 5. Build frontend
cd frontend && npm install && npm run build && cd ..
# 6. Deploy (uses free tier!)
firebase deployDone! Your app is live at https://your-project.web.app
See DEPLOY.md for detailed instructions.
Access the UI at http://localhost:5173
┌─────────────────────────────────────────────────────────────────┐
│ Frontend │
│ React 18 + TypeScript + Nextjs + TailwindCSS + Recharts + D3 │
└────────────────────────────┬────────────────────────────────────┘
│ REST API + WebSocket
┌────────────────────────────▼────────────────────────────────────┐
│ Backend │
│ FastAPI + SQLAlchemy + Celery + Redis │
├─────────────────────────────────────────────────────────────────┤
│ Fairness Engine: fairlearn | AIF360 | SHAP | ONNX Runtime │
├─────────────────────────────────────────────────────────────────┤
│ Storage: PostgreSQL + S3/MinIO │
└─────────────────────────────────────────────────────────────────┘
| Package | Description |
|---|---|
@fairlens/ui |
React component library |
@fairlens/sdk |
JavaScript SDK for API integration |
fairlens-core |
Python fairness computation engine |
fairlens-cli |
Command-line interface |
- React 18 + TypeScript + Nextjs
- TailwindCSS
- Recharts (metrics visualization)
- D3.js (bias heatmap)
- Zustand (state management)
- React Query (async data)
- Python 3.11+
- FastAPI
- SQLAlchemy + PostgreSQL
- Celery + Redis
- fairlearn, AIF360, SHAP, ONNX Runtime
- Docker & Docker Compose
- Nginx
- AWS S3 / MinIO
- GitHub Actions
For Google Solution Challenge 2026, FairLens can be deployed entirely on Google Cloud:
| Service | Free Tier | Purpose |
|---|---|---|
| Firebase Hosting | 1 GB | Frontend |
| Firestore | 20K reads/writes | Database |
| Firebase Storage | 5 GB | File uploads |
| Cloud Functions | 2M invocations | API Backend |
| Gemini (Free) | 15 RPM, 1M tokens | AI Insights |
Total Cost: $0
Users → Firebase Hosting (Next.js)
↓
Cloud Functions (Python)
↓
Firestore + Storage
↓
Gemini API (AI Insights)
See DEPLOY.md for one-command deploy!
We welcome contributions! Please see our Contributing Guide and Code of Conduct.
# Run development environment
docker-compose -f docker-compose.dev.yml up
# Run tests
npm run test # Frontend
pytest # Backend
# Format code
npm run format # Frontend
black . # Backend- Live Demo - Try it out
- Documentation - Full docs
- Discord - Community
- Blog - Updates & guides
- Twitter - Follow us
|
|||
| # | Team Member | Role | GitHub Profile |
|---|---|---|---|
| 1 | Abdur Rahman Qasim | 🎯 Team Lead | 🔗 FareedAhmedOwais |
| 2 | Fareed Ahmed Owais | 🖼️ Frontend Developer | 🔗 Abdur-rahman-01 |
| 3 | Mohammed Saad Uddin | 🚀 Full-stack + AI/ML Developer | 🔗 saad2134 |
| 4 | Mohammed Abdul Rahman | 🎨 UI/UX Designer | 🔗 saad2134 |
Developed with 💖 for the Google Solution Challenge 2026 Hackathon (powered by Hack2Skill), with heartfelt thanks for the opportunity to build and innovate.
#WebApp #AI #FairnessAuditing #MachineLearning #NextJS #FastAPI #Python #TypeScript #Demo #React #TailwindCSS #BiasDetection #FairnessMetrics #EthicalAI #ResponsibleAI #GoogleCloud #Firebase #Gemini #CloudRun #AIFairness #DataScience #MLOps #OpenSource #SaaS #Enterprise #WebDevelopment