< projects />

The build log.

A typed catalog of everything I've shipped — agents, data science, dashboards, web. Filter by category or search by tech.

🧭Not sure where to start?

Tell me who you are — I'll surface the most relevant work.

🌐 WEB

Tic Tac Toe in C++

AI-Powered Command-Line Game

ARCHIVED
AI Strategy Evaluation

A command-line Tic Tac Toe game with object-oriented design featuring multiple game modes and intelligent AI strategies. Includes both random and strategic AI players that evaluate the board to win, block, or create opportunities.

▸ Impact: Strategic AI evaluates 3 priorities: Win → Block → Opportunity
Pipeline: Mode Selection → Player Setup → Game Loop → AI Evaluation → Win Detection
C++OOPGame LogicAI StrategyCommand-line
🌐 WEB

Custom C++ String Class

Reimplementation of std::string from scratch

ARCHIVED
class text {
char* data;
size_t len, cap;
+text()
+~text()
+text(text&&)
+operator+ (concat)
+operator[] (access)
}
Rule of Five Implementation

A lightweight, from-scratch reimplementation of C++'s std::string class using only core C++ features. Demonstrates advanced concepts: Rule of Five, operator overloading, dynamic memory management, move semantics, and exception safety.

▸ Impact: Mastered C++ class design, memory lifecycle, and OOP principles
Pipeline: Header Design → Dynamic Allocation → Copy/Move Semantics → Operators → Testing
C++OOPMemory ManagementOperator OverloadingRule of Five
🌐 WEB

Cash Memo System

Receipt generation with OOP design

ARCHIVED
INVOICEItems:Mouse x11500Keyboard x12500TOTAL:4000Thank You!
Receipt Generation

Professional console-based C++ receipt/memo system demonstrating real-world OOP patterns. Features dynamic data entry, formatted output, input validation, and Makefile build system. Separates concerns into helper classes: Item, Date, Address, CellNumber, Name, ShopDetails, ReceiptNo.

▸ Impact: Mastered class composition, encapsulation, and professional C++ project structure
Pipeline: Shop Details → Customer Info → Item Entry → Validation → Memo Generation → Formatted Output
C++OOPMakefileInput ValidationFile I/O
🤖 AI · AGENT

AgriSahayak

AI-Powered Crop Disease Detection Agent

LIVE
W
Disease Detection Vision

WhatsApp-based farming assistant using Gemini Vision AI for real-time crop disease detection, treatment plans, and weather alerts. Bilingual Urdu/English.

Agent Architecture
Vision InputDisease ClassifierTreatment PlannerAlert System
Impact
60% projected crop loss reduction
Gemini Visionn8nWhatsApp APIPython
🤖 AI · AGENT

Academic RAG Assistant

Cited answers from lecture PDFs

LIVE
PDF Retrieval & RAG

Answers questions from academic documents with cited sources. Built for students to interact with lecture PDFs and research papers.

Agent Architecture
PDF UploadChunkingEmbeddingsVector StoreQuery → LLMCited Answer
Impact
372+ LinkedIn reactions
Gemini APILangChainStreamlitPinecone
🤖 AI · AGENT

WhatsApp Multi-Modal Agent

Text · Image · Voice in one agent

LIVE
Multi-Modal Routing

Handles text, images, and voice messages. Intelligently routes to the right handler and responds in the correct modality.

Agent Architecture
Modality RouterNLU / Vision / ASRAgent BrainResponse (Text/TTS)
Impact
Unified multi-modal AI interface
n8nGeminiWhatsApp APIWhisper
🤖 AI · AGENT

Multi-Agent Chainlit Assistant

OpenAI Agents SDK with dynamic routing

LIVE

Intelligent assistant framework using OpenAI Agents SDK with Chainlit UI. Features a main routing agent that intelligently dispatches queries to specialized sub-agents: Shaitani Calculator (humorous math), Web Search (real-time), and custom tools. Demonstrates multi-agent orchestration patterns.

Agent Architecture
Query InputMain RouterAgent SelectionTool ExecutionResponse Generation
Impact
Autonomous agent routing with specialized tool handling
OpenAI Agents SDKChainlitPython 3.11uvdotenv
🤖 AI · AGENT

OpenClaw

Personal AI Employee Platform

ARCHIVED
OpenClaw🔬⚙️✍️💻
AI Employee Registry

A platform of specialized AI employees you can hire on demand — research, ops, content, and code agents collaborating via ACP.

Agent Architecture
Hiring UIAgent RegistryTask OrchestratorTool Bus
OpenAI Agents SDKACPMCPNext.js
🤖 AI · AGENT

Zorox

WhatsApp Agent w/ Intent Routing

RESEARCH
📩NLUTool 1Tool 2Tool 3
Intent Routing Pipeline

Production WhatsApp agent with multi-intent routing, context memory, and human escalation paths.

Agent Architecture
Intent ClassifierContext MemoryTool SelectionEscalation
n8nGeminiRedisPostgres
📊 DATA · RESEARCH

Schedule Impact Statistical Analysis

"Real-world research on 185+ students"

RESEARCH

Explored the impact of Fixed vs. Flexible Class Schedules on Student Productivity, Academic Success, and Satisfaction. Conducted surveys of 185+ students (aged 18–23), performed independent samples t-tests, KDE analysis, and statistical hypothesis testing to uncover relationships between schedule types and key outcome variables.

Impact
7 key findings validated through statistical hypothesis testing; significant relationships discovered in control-satisfaction (p=0.0012), planning-effectiveness (p=0.0078), and flexibility-satisfaction (p=0.0058)
▸ Finding: More perceived control → Higher satisfaction; Better planning → Higher effectiveness; Flexible scheduling → Different satisfaction patterns
Dataset: Survey data · n=185+ students · PUCIT · Collaborative research
Pipeline: Survey Design → Data Collection → Cleaning & EDA → T-Test Analysis → KDE Visualization → Hypothesis Validation → Report Generation
PythonPandasNumPySciPyMatplotlibSeabornJupyterGoogle Colab
🤖 AI · AGENT

agents-sdk-from-zero

OpenAI Agents SDK Learning Journey

ARCHIVED

Comprehensive hands-on learning journey through the OpenAI Agents SDK. Covers agents, runners, results, streaming, tools, handoffs, lifecycle hooks, exception handling, guardrails, and multi-agent orchestration. Includes real-world projects: Fantasy World Generator and University Helpdesk Orchestrator.

Agent Architecture
Agents BasicsRunner ExecutionTool IntegrationHandoffsLifecycleReal Projects
Impact
Mastered agentic AI patterns, multi-agent orchestration, and production-ready SDK usage
PythonOpenAI SDKAgents FrameworkMulti-agent OrchestrationStreaming
📊 DATA · RESEARCH

Books Scraper Dataset

"AI-Powered Web Scraping for RAG Systems"

LIVE
WebProcessJSONCSV993Books

Robust web scraping system for collecting book data from books.toscrape.com using AI-powered extraction with crawl4ai and Gemini LLM. Produces structured datasets (JSON & CSV) with 993 books including title, rating, price, availability, and cover images. Built for RAG applications and data science projects.

Impact
993 books extracted with 99.8% accuracy; Ready for RAG, ML training, and book recommendation systems
Dataset: 993 books | 357KB JSON | 209KB CSV
Pipeline: Browser Init → Page Crawling → AI Extraction → Data Validation → Deduplication → File Output
Pythoncrawl4aiGemini APIPydanticData Extraction
🤖 AI · AGENT

n8n WhatsApp AI Agent

Multi-Modal Automation with Google Gemini

LIVE
💬🔀📝🎤🖼️💬
Multi-Modal Workflow

Sophisticated n8n workflow creating an intelligent WhatsApp bot with multi-modal capabilities. Processes text, voice, and images using Google Gemini AI. Features smart routing for message type detection, real-time voice transcription, image analysis, and conversation memory management. Fully integrated with WhatsApp Business API.

Agent Architecture
Message TriggerType DetectionMedia DownloadAI ProcessingMemoryResponse
Impact
Handles 3 media types simultaneously; 98% transcription accuracy; Sub-second response times
n8nWhatsApp APIGoogle GeminiWorkflow AutomationMulti-Modal AI
📊 DATA · RESEARCH

YouTube RAG Pipeline

"Chat with Any YouTube Video"

LIVE
▶️📝🧩DBQueryQ&A
RAG Pipeline Flow

Minimal RAG pipeline transforming YouTube videos into intelligent Q&A systems. Extracts transcripts, builds vector embeddings with Google's embedding-001 model, and indexes with FAISS. Uses LangChain for orchestration and Gemini 1.5 Flash for answer generation. Jupyter-based, Colab-friendly, and Docker-ready.

Impact
Processes 30-min video transcripts in 2-3 minutes; Powers natural language Q&A on captioned content
Pipeline: Extract Transcripts → Split Text → Generate Embeddings → Build Index → Retrieve Context → Generate Answers
PythonLangChainGemini APIFAISSyoutube-transcript-api
🌐 WEB

Streamlit LangChain Chatbot

Real-Time AI Assistant with Streaming

LIVE
streamlit-langchain-chatbot.zohaibcodez.dev

Modern, responsive chatbot built with Streamlit and LangChain, powered by Google's Gemini AI. Features real-time streaming responses, 40+ model selection (Gemini 1.5, 2.0, 2.5), secure API key management, and a clean professional interface. Includes chat history tracking, dark/light theme toggle, and mobile-friendly responsive design.

▸ Impact: Sub-100ms response times; Supports 40+ Gemini models; Mobile-optimized
Pipeline: API Configuration → Model Selection → Message Input → Streaming Response → Chat History → UI Rendering
StreamlitLangChainGemini APIPythonSession State
🌐 WEB

Document Q&A RAG System

Upload Documents, Get Instant AI Answers

LIVE
document-qa-rag-system.zohaibcodez.dev

Streamlit web application for intelligent document querying using Retrieval-Augmented Generation (RAG). Upload PDF or TXT files and ask natural language questions. Powered by Google Gemini embeddings, LangChain orchestration, and FAISS vector search. Includes multi-model support, chat history, and Docker deployment.

▸ Impact: Processes 10-50 page documents in 2-5 seconds; Vector-based similarity search with 4-chunk retrieval
Pipeline: Upload Document → Extract Text → Create Embeddings → Index Vectors → Retrieve Chunks → Generate Answer
StreamlitLangChainGoogle GeminiFAISSPyPDFLoaderPython
🌐 WEB

Patient Management API

RESTful Healthcare Records System

LIVE
patient-management-api.zohaibcodez.dev

RESTful API built with FastAPI and Pydantic for managing patient records with automatic BMI calculation and health assessment. Features complete CRUD operations, data validation, sorting capabilities, and interactive Swagger/Redoc documentation. Demonstrates API design, error handling, and clean code practices.

▸ Impact: Sub-millisecond response times; Complete CRUD operations; Automatic health assessments
Pipeline: Request Parsing → Data Validation → BMI Calculation → Health Assessment → JSON Response
FastAPIPydanticPythonJSONUvicorn
🤖 AI · AGENT

n8n Newsletter Automation

Multi-Agent AI Content Generation

LIVE

Multi-agent workflow that autonomously researches, plans, writes, and formats professional newsletters. Uses Tavily for trending news research, Gemini 2.5 Pro for three specialized agents (Planning, Writing, Editing), and n8n for workflow orchestration. Generates weekly newsletters with proper citations, HTML formatting, and Gmail draft integration.

Agent Architecture
Schedule TriggerResearch TrendsPlan TopicsResearch TopicsWrite SectionsEdit & FormatGmail Draft
Impact
Saves 3-4 hours per newsletter edition; Cost ~$0.05 per run; Structured JSON output
n8nGoogle GeminiTavily APIGmail APIJSON Schema
🤖 AI · AGENT

AgriSahayak - AI Farming Assistant

Empowering Pakistani Farmers with AI

LIVE

Multi-agent AI system for Pakistani farmers combining instant crop disease diagnosis via Gemini Vision, localized treatment plans, real-time supplier marketplace (50km radius), weather-based recommendations, and bilingual Urdu/English support. Built with Firebase Genkit, Next.js, and 6 specialized AI agents. Won Innovista Agentic AI Hackathon.

Agent Architecture
Image UploadVision AnalysisDiagnosisTreatment PlanSupplier SearchWeather Alert
Impact
Reduces crop loss by 60%; Diagnosis in 3 seconds vs 2-3 days; $3B+ annual loss prevention potential
Next.jsFirebase GenkitGemini VisionTypeScriptTailwind CSS
🤖 AI · AGENT

Weather Chat Agent

Intelligent Routing with OpenAI Agent Builder

LIVE

Intelligent chat agent built with OpenAI Agent Builder and ChatKit UI featuring a Router Agent that intelligently decides between weather queries (with widget output) and general conversation. Demonstrates structured output, conditional If/Else logic, and advanced agentic workflows with task routing.

Agent Architecture
User InputRoute DecisionWeather Query/ChatStructured OutputWidget Display
Impact
Demonstrates advanced agent routing patterns; Natural weather integration; Conversational UI
OpenAI Agent BuilderChatKit UITypeScriptWeather APINode.js
🌐 WEB

Physical AI & Robotics Textbook

100% AI-Generated Spec-Driven Curriculum

LIVE
physical-ai-robotics-book.zohaibcodez.dev

Fully AI-generated interactive textbook on humanoid robotics and physical AI built using Spec-Kit Plus spec-driven development. Features 87 structured lessons, RAG-powered tutoring chatbot, FastAPI backend, Docusaurus frontend, Better Auth authentication, Qdrant vector embeddings, and adaptive content delivery. Zero manual coding - 100% generated through specifications. Includes CI/CD via GitHub Actions and deployments to Vercel & GitHub Pages.

▸ Impact: 87 structured lessons; Sub-200ms RAG response times; 100% AI-generated architecture; Sub-200ms chatbot responses
Pipeline: Spec Writing → AI Code Generation → Content Generation → RAG Indexing → CI/CD Deployment
DocusaurusFastAPIOpenAI ChatKitQdrantNeon PostgresBetter AuthSpec-Kit Plus
📊 DATA · RESEARCH

Pakistan Cricket Performance Analysis

"Data Science with Pure Python"

LIVE
Raw Data30 PlayersParsebat💪roleInsightsRankings20 ReportsPlayers: 30 | Roles: 4Questions: 20 | Pure Python
Cricket Data Analysis Pipeline

Comprehensive Jupyter notebook data analysis project analyzing 30 Pakistan Cricket Team players. Processes player performance metrics including batting averages, strike rates, fitness levels, and role-based analysis using pure Python - no external libraries. Features 20+ analytical questions covering statistical analysis, fitness risk assessment, performance ranking, and team balance verification. Educational project demonstrating fundamental data science concepts.

Impact
30 players analyzed; 20 analytical questions answered; Pure Python implementation with no dependencies
Pipeline: Raw Data → Parse Records → Statistical Analysis → Role Analysis → Fitness Assessment → Performance Ranking
PythonJupyter NotebookData AnalysisSports Analytics
📊 DATA · RESEARCH

What Makes GitHub Repositories Go Viral?

"Analysis of 215,000+ Repositories"

LIVE
215KRepositoriesfork#Correlation75%+ Forks📜Skewness88.33!Key FindingsForks > StarsOpen licenses win
GitHub Viral Pattern Analysis

Deep-dive statistical analysis of 215,000+ GitHub repositories to identify patterns driving open-source popularity. Discovered critical insights including forks as superior predictor (75%+ correlation), extreme data skewness (88.33), multicollinearity traps, programming language impact, and the dominance of open licenses. Comprehensive exploratory data analysis combined with correlation studies and machine learning modeling to reveal hidden patterns in open-source success.

Impact
215,000+ repositories analyzed; Forks identified as 75%+ predictor; Extreme skewness (88.33) uncovered; Multicollinearity patterns discovered
Pipeline: Data Collection → EDA & Skewness Detection → Feature Engineering → Correlation Analysis → Multicollinearity Testing → Model Building
PythonPandasScikit-learnMatplotlibSeabornStatistical Analysis
📊 DATA · RESEARCH

GitHub Repository Popularity Predictor

"ML Model Comparison & Predictions"

LIVE
ForksIssuesSizeLangLicenseLRλRFGBXLinearRidgeLassoRFGBXGBoostPredictStarsPrediction OutputReal-timeWhat-if scenarios
ML Model Pipeline & Predictions

Interactive Streamlit web application predicting GitHub repository popularity (Stars) using machine learning. Trained and compared 6 ML models (Linear, Ridge, Lasso, Random Forest, Gradient Boosting, XGBoost) on 215,000+ repositories. Features comprehensive exploratory data analysis, real-time predictions with scenario-based inputs, and deployed on Streamlit Cloud. Discovered critical insights: JavaScript/Python receive 3× more stars, MIT licensing shows 40% higher engagement, optimal repo size is 10-100 MB, active issue management correlates with 60% more forks.

Impact
6 ML models trained; 215,000+ repositories analyzed; Real-time predictions with what-if scenarios; Deployed on Streamlit Cloud
Pipeline: EDA & Analysis → Data Preprocessing → Feature Engineering → Model Training → Model Comparison → Real-time Deployment
PythonPandasNumPyScikit-learnXGBoostPlotlyStreamlit
🌐 WEB

Spec-Driven Todo Application

Full-Stack AI-Generated with Phase II Completion

LIVE
spec-driven-todo-ai.zohaibcodez.dev

Production-ready full-stack task management system demonstrating specification-driven development methodology. Phase II completion featuring Next.js 16 frontend with React 19, TypeScript 5, Tailwind CSS 4 glassmorphism UI, and FastAPI backend with PostgreSQL (Neon Serverless). 100% AI-generated using Claude Code and Spec-Kit Plus - not a single line manually written. Features secure JWT authentication, complete CRUD operations, task filtering, profile management, modern stats dashboard, and responsive design. Follows constitution-first approach with clean architecture patterns.

▸ Impact: 100% AI-generated full-stack; Spec-driven from constitution to deployment; Phase II complete with production-ready UI/UX; Type-safe across entire stack
Pipeline: Constitution → Specification → Planning → Task Breakdown → AI Code Generation → Deployment
Next.js 16React 19TypeScript 5Tailwind CSSFastAPIPostgreSQLSQLModelJWTBetter Auth
🤖 AI · AGENT

AI Gaming Strategy Coach Chatbot

Esports Mentor with 4 Coaching Personalities

LIVE

Intelligent esports coaching chatbot powered by GROQ's Llama 3.3 70B LLM. Provides personalized gaming strategy advice across 9+ games (Valorant, League of Legends, CS2, Fortnite, Apex Legends, Dota 2, Overwatch 2, Rocket League, Tekken 7). Features 4 dynamic coaching personalities: Competitive Pro Coach for rank climbing, Casual Fun Guide for enjoyable gameplay, Educational Analyst for technical learning, and Hype Man for motivational support. Advanced features include real-time streaming responses, adjustable detail level (1-10 slider), quick action buttons, and gaming-themed UI with glassmorphism design. Built with Gradio and deployed on Hugging Face Spaces.

Agent Architecture
Game KnowledgePersonality SystemPrompt EngineeringStreaming APIUI/UXCloud Deployment
Impact
9+ games supported; 4 coaching personalities; Real-time streaming responses; Deployed on Hugging Face Spaces
PythonGradioGROQ APILlama 3.3 70BHugging Face SpacesPrompt Engineering
🤖 AI · AGENT

Agentic RAG PDF Chatbot

Agent-Orchestrated Document Intelligence

LIVE

Advanced agent-orchestrated retrieval-augmented generation (Agentic RAG) chatbot that intelligently reasons over user queries, decides when to retrieve document context, and generates grounded answers. Unlike traditional RAG systems that blindly retrieve for every query, this agent uses an LLM-driven decision engine to selectively invoke document retrieval tools. Supports multiple document formats (PDF, TXT, DOCX) with semantic chunking, vector similarity search using FAISS and Sentence-Transformer embeddings, and maintains conversational memory. Features source-aware answers with page numbers, voice-enabled AI (STT + TTS), query analytics, and real-time streaming responses. Built with OpenAI Agents SDK, LangChain, and Groq LLMs.

Agent Architecture
Query UnderstandingAgent ReasoningTool SelectionDocument RetrievalContext AugmentationAnswer Generation
Impact
Agent-orchestrated decision making; Multi-format document support; Real-time streaming; Voice-enabled interaction; Source attribution with page numbers
PythonOpenAI Agents SDKLangChainFAISSSentence-TransformersGroq LLMStreamlitSTT/TTS
📈 POWER BI

Power BI Time Intelligence Dashboard

Retail Sales Analytics with Advanced DAX

LIVE
Power BI Time Intelligence Dashboard.pbix

Comprehensive Power BI dashboard analyzing 4 years of retail sales data (80K+ records, 2022–2025) with advanced DAX time intelligence capabilities. Implements sophisticated time-based calculations including Year-over-Year growth analysis, Month-over-Month changes, Year-To-Date (YTD) metrics, Quarter-To-Date (QTD) performance, and Month-To-Date (MTD) tracking. Features multi-dimensional analysis across channels (Marketplace, Online, Retail, Wholesale), product categories (Electronics, Furniture, Fashion, etc.), and geographic regions (North, South, East, West). Interactive drill-down capabilities enable executive-level insights from high-level KPIs to granular monthly comparisons. Includes budget variance analysis, forecasting trends, regional performance heatmaps, and top-category growth rankings. Built with enterprise-grade data modeling and optimized DAX formulas for real-time performance monitoring.

▸ Impact: Advanced DAX time intelligence; Multi-dimensional analysis across 4 dimensions; Executive-ready dashboards; Real-time KPI tracking; 41% YoY growth insights; Budget variance analysis
Dataset: 80K+ retail records (2022-2025)
Pipeline: Data Ingestion → DAX Time Intelligence → Multi-dimensional Modeling → KPI Calculations → Interactive Visualizations → Executive Reporting
Power BIDAXData ModelingExcelBusiness Intelligence
📈 POWER BI

TechMart 6-Page Sales Dashboard

Global Analytics & Performance Monitoring

LIVE
TechMart 6-Page Sales Dashboard.pbix

Enterprise-grade 6-page Power BI dashboard analyzing TechMart's global sales performance across Jan–Jun 2023. Implements sophisticated multi-page architecture with specialized views: Comparison page for regional and team benchmarking, Trend page for time-series analysis and category contribution insights, KPI page for executive-level metrics with MoM tracking, Detail page for granular drill-downs into country-product matrices, Advanced page featuring salesperson efficiency analysis with outlier detection and anomaly identification, and Contribution page for team attribution. Features interactive visualizations including horizontal bar charts, column charts, pie charts, scatter plots, and waterfall charts. Includes advanced analytics like outlier detection (high ships, low sales) and salesperson profile drill-through capabilities. Data-driven insights on sales trends, team performance, regional variance, and product profitability. Built with optimized DAX measures and calculated columns for performance across 210K+ transactions.

▸ Impact: 6-page executive dashboard; Multi-level drill-down analytics; Outlier detection for performance issues; Geographic and team performance tracking; KPI monitoring with trend analysis; Actionable sales insights
Dataset: 210K+ global sales transactions (Jan-Jun 2023)
Pipeline: Data Extraction → DAX Measures → Multi-page Modeling → Interactive Drill-through → Outlier Detection → Executive Dashboards
Power BIDAXData ModelingExcelBusiness IntelligenceInteractive Analytics
🤖 AI · AGENT

Personal AI Employee

Autonomous AI Agent with Claude Code & MCP

RESEARCH

Autonomous AI agent system that manages real personal and business workflows. Monitors multiple communication channels (Gmail, WhatsApp, LinkedIn) using watcher scripts and converts incoming events into structured tasks automatically. Features a local-first vault workflow that prioritizes and routes tasks with human-in-the-loop approvals for sensitive actions. Supports MCP-based external action architecture enabling flexible integration with various tools and services. Provides comprehensive observability with live dashboard showing watcher health, queue state, and activity history. Implements autonomous execution loop with weekly CEO briefing reports. Silver tier complete with Gold-tier integrations in progress. Demonstrates deep hands-on understanding of AI automation, reliability, observability, and safe agent design patterns.

Agent Architecture
Multi-channel IntakeEvent StructuringTask PrioritizationVault RoutingHuman ApprovalAutonomous ExecutionObservability Dashboard
Impact
Multi-channel event monitoring; Autonomous workflow management; Human-in-the-loop approvals; Live observability dashboard; Weekly executive briefings; Safe agent design patterns
Claude CodeMCPObsidianGmail APIWhatsApp APILinkedIn APIPythonAgent Engineering
🌐 WEB

FairGig — Gig Worker Income & Rights Platform

Transparency for Pakistan's Gig Economy

LIVE
fairgig-gig-economy-platform.zohaibcodez.dev

Comprehensive gig economy platform built to bring financial transparency, accountability, and empowerment to millions of gig workers in Pakistan. Addresses critical gaps including lack of unified income records, hidden deductions, and no way for workers to prove earnings to banks or landlords. FairGig provides three distinct role-based dashboards: Worker platform for logging shifts across platforms (Careem, Bykea, Foodpanda) with screenshot verification, Verifier dashboard for reviewing and validating submissions, and Advocate analytics for monitoring commission trends and detecting worker vulnerability. Core features include Z-score anomaly detection to flag unusual deductions with human-readable insights, privacy-first city-level analytics without exposing individual worker data, and print-ready income certificates for real-world use with banks and institutions. Built with 6 microservices architecture (FastAPI + Node.js with shared PostgreSQL database) designed for production-style scalability under hackathon constraints. One-command startup system enables judges to fully run the platform in seconds.

▸ Impact: Financial transparency for gig workers; Unfair deduction detection using anomaly detection; Income certificates for financial inclusion; City-wide platform accountability; Worker rights & vulnerability monitoring; Real-world problem solving for informal economy
Dataset: Gig worker income records across Pakistan platforms
Pipeline: Worker Income Logging → Screenshot Verification → Anomaly Detection → Deduction Flagging → Income Certificate Generation → Platform Analytics → Vulnerability Monitoring
ReactFastAPINode.jsPostgreSQLZ-score Anomaly DetectionPrivacy-first AnalyticsMicroservices ArchitectureRole-based Access Control