Skip to content

README.md

Latest commit

 

History

History
116 lines (91 loc) · 2.71 KB

README.md

File metadata and controls

116 lines (91 loc) · 2.71 KB

🪪 UIDAI Aadhaar Analytics Dashboard

An AI-powered analytics dashboard built for the UIDAI Hackathon — visualizing Aadhaar enrolment trends across India with state & district level insights.

🔗 Live Demo: https://uidai-hackathon-phi.vercel.app/ 📦 Repository: https://github.com/sweetylearner-max/UIDAI-Hackathon

✨ Features

  • 🗺️ Interactive India Map — click any state or district to drill down
  • 📊 Enrolment statistics by state, district & pincode
  • 👥 Age distribution charts (enrolment vs population)
  • 🤖 AI-generated insights using LangGraph + Groq LLM
  • 🌐 Web search-enriched regional context
  • 📡 Real-time streaming AI overview (SSE)
  • 🔍 Low & high enrolment district detection

🛠️ Tech Stack

Frontend

Technology Usage
Next.js 16 Framework
React 19 UI
Tailwind CSS v4 Styling
React Leaflet India Map
Lucide React Icons
React Markdown AI output rendering

Backend

Technology Usage
FastAPI API Server
Pandas Data processing
LangGraph AI Agent
LangChain + Groq LLM Integration
Uvicorn ASGI Server

🚀 Getting Started

Prerequisites

  • Python 3.11+
  • Node.js 18+

Installation

  1. Clone the repository:

    git clone https://github.com/sweetylearner-max/UIDAI-Hackathon.git
cd UIDAI-Hackathon

  2. Setup environment variables:

    cp .env.example .env

  3. Install & run Backend:

    cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

  4. Install & run Frontend:

    cd frontend
npm install
npm run dev

📁 Project Structure

UIDAI-Hackathon/
├── backend/
│   ├── AI_backend/         # LangGraph AI agent
│   │   ├── overview_agent.py
│   │   └── web_tool.py
│   ├── app/
│   │   ├── main.py         # FastAPI entry point
│   │   ├── data_loader.py  # CSV data loading
│   │   ├── filters.py      # Region filters
│   │   ├── stats.py        # Statistics
│   │   └── insights.py     # Insights logic
│   ├── data/               # Aadhaar CSV datasets
│   └── requirements.txt
├── frontend/
│   ├── app/                # Next.js pages
│   ├── components/         # UI components
│   └── lib/                # API & utilities
└── .env.example

👥 Contributors

  • Akanksha Bursu
  • Ayaansh
  • Likitha
  • Prem Kumar
  • Ajith
  • Saanvika

Built with ❤️ by Team UIDAI Hackathon