{"id":50869893,"url":"https://github.com/saad2134/fairlens","last_synced_at":"2026-06-15T04:03:56.618Z","repository":{"id":354243990,"uuid":"1222725975","full_name":"saad2134/FairLens","owner":"saad2134","description":"A full-stack SaaS-grade web app where teams upload a dataset + trained model (or plug in an API endpoint) and receive a comprehensive, interactive fairness audit report. Built to be genuinely enterprise-usable, not a toy.","archived":false,"fork":false,"pushed_at":"2026-05-16T19:18:40.000Z","size":1088,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T21:28:52.950Z","etag":null,"topics":["ai-fairness","bias-detection","cloudrun","enterprise","ethical-ai","fairness-auditing","fairness-metrics","firebase","gemini","googlecloudplatform","machine-learning","mlops","responsible-ai"],"latest_commit_sha":null,"homepage":"https://fair-lensai.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saad2134.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-27T16:41:23.000Z","updated_at":"2026-05-16T19:15:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/saad2134/FairLens","commit_stats":null,"previous_names":["saad2134/fairlens"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/saad2134/FairLens","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2FFairLens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2FFairLens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2FFairLens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2FFairLens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saad2134","download_url":"https://codeload.github.com/saad2134/FairLens/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2FFairLens/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34346873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-fairness","bias-detection","cloudrun","enterprise","ethical-ai","fairness-auditing","fairness-metrics","firebase","gemini","googlecloudplatform","machine-learning","mlops","responsible-ai"],"created_at":"2026-06-15T04:03:51.164Z","updated_at":"2026-06-15T04:03:56.608Z","avatar_url":"https://github.com/saad2134.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e⚖️ FairLens – Enterprise-grade AI fairness auditing platform\u003c/h1\u003e\n\n\u003e \u003cp align=\"center\"\u003e🚨 \u003cstrong\u003e\"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.\"\u003c/strong\u003e\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://shiksha-disha.vercel.app/\" target=\"_blank\"\u003e\n    \u003cimg  style=\"width:350px;\" src=\"https://img.shields.io/badge/🚀_Access_the_Prototype_Here-Live-brightgreen?style=for-the-badge\u0026labelColor=80FF80\" alt=\"Access the Prototype Here\"  /\u003e\n\u003c/a\u003e\n\n![Phase](https://img.shields.io/badge/🛠️%20Phase-In%20Development-blue?style=for-the-badge)\n![Platforms](https://img.shields.io/badge/🌐%20Platforms-Web%20%7C%20Android*-28a745?style=for-the-badge)\n\n\u003c/div\u003e\n\n## ✨ Key Features\n\n| Feature | Description |\n|---------|-------------|\n| 🔍 **Bias Heatmap** | D3-rendered visualization of feature × protected attribute combinations with severity scoring |\n| 🧪 **What-if Simulator** | Interactive prediction playground with SHAP explanations |\n| 📊 **Comprehensive Metrics** | Demographic Parity, Equal Opportunity, Disparate Impact, Equalized Odds |\n| 🔌 **Model Agnostic** | Support for Pickle, ONNX, and external API endpoints |\n| 📜 **Audit Versioning** | Complete audit trail with dataset/model hashes for compliance |\n| 📈 **Drift Detection** | Track fairness metrics across audit history |\n\n## 🚀 Quick Start (Local)\n\n```bash\n# Clone the repository\ngit clone https://github.com/fairlens/fairlens.git\ncd fairlens\n\n# Start with Docker Compose (recommended)\ndocker-compose up -d\n\n# Or run locally\n# Backend\ncd backend \u0026\u0026 pip install -r requirements.txt\nuvicorn app.main:app --reload\n\n# Frontend\ncd frontend \u0026\u0026 npm install\nnpm run dev\n```\n\n## 🚀 Quick Deploy (100% Cloud - No Local Setup)\n\n```bash\n# 1. Install Firebase CLI\nnpm install -g firebase-tools\n\n# 2. Login\nfirebase login\n\n# 3. Create project at https://console.firebase.google.com\n#    Enable: Authentication, Firestore, Storage, Hosting\n\n# 4. Initialize\nfirebase init\n#   Select: Hosting, Functions, Firestore, Storage\n\n# 5. Build frontend\ncd frontend \u0026\u0026 npm install \u0026\u0026 npm run build \u0026\u0026 cd ..\n\n# 6. Deploy (uses free tier!)\nfirebase deploy\n```\n\n**Done!** Your app is live at `https://your-project.web.app`\n\nSee [DEPLOY.md](DEPLOY.md) for detailed instructions.\n\nAccess the UI at `http://localhost:5173`\n\n## 📖 Documentation\n\n- [Getting Started](https://docs.fairlens.ai/getting-started)\n- [API Reference](https://docs.fairlens.ai/api-reference)\n- [Fairness Metrics Guide](https://docs.fairlens.ai/metrics)\n- [Deployment Guide](https://docs.fairlens.ai/deployment)\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                         Frontend                                │\n│   React 18 + TypeScript + Nextjs + TailwindCSS + Recharts + D3  │\n└────────────────────────────┬────────────────────────────────────┘\n                             │ REST API + WebSocket\n┌────────────────────────────▼────────────────────────────────────┐\n│                         Backend                                 │\n│      FastAPI + SQLAlchemy + Celery + Redis                      │\n├─────────────────────────────────────────────────────────────────┤\n│  Fairness Engine: fairlearn | AIF360 | SHAP | ONNX Runtime      │\n├─────────────────────────────────────────────────────────────────┤\n│              Storage: PostgreSQL + S3/MinIO                     │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n## 📦 Available Packages\n\n| Package | Description |\n|---------|-------------|\n| `@fairlens/ui` | React component library |\n| `@fairlens/sdk` | JavaScript SDK for API integration |\n| `fairlens-core` | Python fairness computation engine |\n| `fairlens-cli` | Command-line interface |\n\n## 🔧 Tech Stack\n\n### Frontend\n- React 18 + TypeScript + Nextjs\n- TailwindCSS\n- Recharts (metrics visualization)\n- D3.js (bias heatmap)\n- Zustand (state management)\n- React Query (async data)\n\n### Backend\n- Python 3.11+\n- FastAPI\n- SQLAlchemy + PostgreSQL\n- Celery + Redis\n- fairlearn, AIF360, SHAP, ONNX Runtime\n\n### Infrastructure\n- Docker \u0026 Docker Compose\n- Nginx\n- AWS S3 / MinIO\n- GitHub Actions\n\n## ☁️ Cloud Deploy (100% Free Tier)\n\nFor Google Solution Challenge 2026, FairLens can be deployed entirely on Google Cloud:\n\n| Service | Free Tier | Purpose |\n|---------|----------|---------|\n| Firebase Hosting | 1 GB | Frontend |\n| Firestore | 20K reads/writes | Database |\n| Firebase Storage | 5 GB | File uploads |\n| Cloud Functions | 2M invocations | API Backend |\n| Gemini (Free) | 15 RPM, 1M tokens | AI Insights |\n\n**Total Cost: $0**\n\n### Cloud Architecture\n\n```\nUsers → Firebase Hosting (Next.js)\n           ↓\n    Cloud Functions (Python)\n           ↓\n    Firestore + Storage\n           ↓\n    Gemini API (AI Insights)\n```\n\n### Quick Deploy\n\nSee [DEPLOY.md](DEPLOY.md) for one-command deploy!\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).\n\n```bash\n# Run development environment\ndocker-compose -f docker-compose.dev.yml up\n\n# Run tests\nnpm run test        # Frontend\npytest              # Backend\n\n# Format code\nnpm run format      # Frontend\nblack .             # Backend\n```\n\n## 🔗 Links\n\n- **[Live Demo](https://fairlens.ai/demo)** - Try it out\n- **[Documentation](https://docs.fairlens.ai)** - Full docs\n- **[Discord](https://discord.gg/fairlens)** - Community\n- **[Blog](https://fairlens.ai/blog)** - Updates \u0026 guides\n- **[Twitter](https://twitter.com/fairlensai)** - Follow us\n\n\n\n## 👥 Our Google Solution Challenge 2026 Hackathon Team (DevBandits)\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd colspan=\"4\" align=\"center\"\u003e\n      \u003cimg width=\"384\" height=\"168\" alt=\"DevBandits Banner\" src=\"https://github.com/user-attachments/assets/626dba91-4d4a-4c6a-9e87-9e9730fea018\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003cth\u003e#\u003c/th\u003e\n    \u003cth\u003eTeam Member\u003c/th\u003e\n    \u003cth\u003eRole\u003c/th\u003e\n    \u003cth\u003eGitHub Profile\u003c/th\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e1\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eAbdur Rahman Qasim\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e🎯 Team Lead\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://github.com/Abdur-rahman-01\"\u003e🔗 FareedAhmedOwais\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e2\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eFareed Ahmed Owais\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e🖼️ Frontend Developer\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://github.com/FareedAhmedOwais\"\u003e🔗 Abdur-rahman-01\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e3\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eMohammed Saad Uddin\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e🚀 Full-stack + AI/ML Developer\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://github.com/saad2134\"\u003e🔗 saad2134\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e4\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eMohammed Abdul Rahman\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e🎨 UI/UX Designer\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://github.com/Abdul-Rahman26\"\u003e🔗 saad2134\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n\n\u003c/div\u003e\n\n\n## 📊 **Repo Stats**\n\n\u003cdiv align=\"center\"\u003e\n  \n![Repo Size](https://img.shields.io/github/repo-size/saad2134/FairLens)\n![Last Commit](https://img.shields.io/github/last-commit/saad2134/FairLens)\n![Open Issues](https://img.shields.io/github/issues/saad2134/FairLens)\n![Open PRs](https://img.shields.io/github/issues-pr/saad2134/FairLens)\n![License](https://img.shields.io/github/license/saad2134/FairLens)\n![Forks](https://img.shields.io/github/forks/saad2134/FairLens?style=social)\n![Stars](https://img.shields.io/github/stars/saad2134/FairLens?style=social)\n![Watchers](https://img.shields.io/github/watchers/saad2134/FairLens?style=social)\n![Contributors](https://img.shields.io/github/contributors/saad2134/FairLens)\n![Languages](https://img.shields.io/github/languages/count/saad2134/FairLens)\n![Top Language](https://img.shields.io/github/languages/top/saad2134/FairLens)\n\n\u003c/div\u003e\n\n\n## ⭐ Star History\n\n\u003ca href=\"https://www.star-history.com/#saad2134/FairLens\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=saad2134/FairLens\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=saad2134/FairLens\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=saad2134/FairLens\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n\n## ✍️ Endnote\n\u003cp align=\"center\"\u003eDeveloped with 💖 for the Google Solution Challenge 2026 Hackathon (powered by Hack2Skill), with heartfelt thanks for the opportunity to build and innovate.\u003c/p\u003e\n\n---\n\n## 🏷 Tags  \n\n#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 \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaad2134%2Ffairlens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaad2134%2Ffairlens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaad2134%2Ffairlens/lists"}