शहरAI — AI-Powered Relocation Decision Platform
🌐 Live Demo: https://frontend-44079236102.asia-south1.run.app/
An AI-powered web platform that helps users make data-backed relocation decisions, combining health, affordability, job opportunities, and lifestyle factors into a single, intelligent recommendation system.
🚀 Core Idea Relocation today is fragmented — users rely on multiple platforms for jobs, housing, healthcare, and safety. शहरAI solves this by integrating everything into one unified decision system, powered by Google technologies and AI.
🚀 Features AI-Powered Recommendations (Gemini) Personalized city and locality suggestions with explainable reasoning Multi-Factor Decision Engine Combines 10+ datasets including AQI, healthcare, cost of living, and job match Locality-Level Insights Not just which city, but where inside the city to live Interactive Maps Visualize 50+ POIs per city (hospitals, schools, housing, transport) Migration Readiness Score Quantifies how suitable a move is based on user profile Multilingual Support AI-generated insights in multiple Indian languages using Gemini Report Generation Exportable, structured relocation reports
🧠 How It Works User enters: Profession Budget Family & health preferences Backend computes: AQI improvement Healthcare access Job compatibility Cost of living Gemini generates personalized advisory explaining: Why a city is recommended Expected lifestyle impact User receives: Top 3–5 city recommendations Deep-dive locality insights
🏗️ Tech Stack (Google-Centric Architecture) Frontend Next.js (React) TailwindCSS Leaflet.js (Maps UI) Backend FastAPI (Python) Modular API architecture AI Layer Google Gemini API Advisory generation Multilingual output Explainable insights Authentication Firebase Authentication Cloud & Deployment Google Cloud Run (frontend + backend) Cloud Build (CI/CD pipelines) Secret Manager (secure API key handling) Cloud Logging & Monitoring Data & Geospatial OpenStreetMap + Overpass API Government datasets (AQI, healthcare, cost)
📁 Project Structure shahar-ai/ ├── frontend/ # Next.js app │ ├── app/ │ │ ├── page.tsx # Landing page │ │ ├── wizard/ # Multi-step input flow │ │ └── results/ # Recommendation output │ ├── components/ │ └── lib/ ├── backend/ # FastAPI backend │ ├── app/ │ │ ├── main.py │ │ ├── routers/ # API endpoints │ │ ├── services/ # Recommendation logic │ │ ├── models/ # Schemas │ │ └── utils/ │ └── requirements.txt └── README.md
🌐 API Endpoints Endpoint Method Description /api/recommendations POST Get city recommendations /api/city-explore GET Deep-dive city insights /api/places GET Retrieve POIs (maps data) /api/advisory POST Generate AI advisory /api/report POST Generate exportable report
📊 Data Sources Government datasets (AQI, healthcare, education) OpenStreetMap (geospatial data) Public datasets (cost of living, demographics) Job platforms (integration-ready)
⚙️ Setup Frontend: npm install npm run dev
Backend: cd backend pip install -r requirements.txt uvicorn app.main:app --reload
🚢 Deployment (Google Cloud) Frontend → Cloud Run / Firebase Hosting Backend → Cloud Run Secrets → Secret Manager Monitoring → Cloud Logging
📈 Key Highlights Processes 10+ datasets per request Generates 3–5 personalized recommendations Handles multi-step user flow (3–4 steps) Displays 50+ POIs per city Fully scalable via Google Cloud infrastructure
🧠 Why शहरAI? Most platforms help you: Find jobs, Find houses. But none help you: 👉 Decide where and how to live
📝 License MIT License — Built for Google Lakecity Hackathon 2026