Atmospheric intelligence for the modern era. Predicting the unseen to protect the living.
AQILYTICS is a full-stack, AI-driven Environmental Dashboard that provides real-time Air Quality Index (AQI) telemetry, cutting-edge machine learning forecasting, and detailed health intelligence using generative AI. It empowers users to track pollutants globally, read AI-generated analyses of the air they breathe, and subscribe to automated daily reports.
- Real-time Global Pulse: Interactive global map and localized searches for granular air quality data.
- Machine Learning Forecasts: Next-generation predictions powered by an XGBoost model running on a FastAPI backend.
- AI Analyst: Instant, intelligent reports generated by Google Gemini, summarizing the impact of various pollutants (PM2.5, PM10, NO2, SO2, Ozone...).
- Daily Briefings: Email subscriptions to receive daily AQI updates for selected cities (powered by Next.js APIs and Resend).
- Export Intelligence: Downloadable PDF reports featuring comprehensive analyses.
| Domain / Technology | What It's Doing |
|---|---|
| Next.js 15 (React 19) | Acts as the core frontend network and orchestrates serverless API routes for email subscriptions and PDF generation. Handles dynamic routing between the dashboard and specific city analyses. |
| FastAPI (Python) | Powers the high-performance telemetry backend. It ingests geospatial queries, processes real-time weather/pollutant data, and serves the XGBoost ML predictions asynchronously. |
| XGBoost & Scikit-learn | The machine learning brains of the operation. Trained on historical atmospheric data to generate accurate 5-day Air Quality forecasts for any given location. |
| Google Gemini 2.5 Flash | The generative AI engine behind the "AI Analyst" feature. It parses raw numeric pollutant data to return formal, human-readable executive health summaries and specific hazard insights. |
| PostgreSQL (Neon) | The primary relational database storing persistent configuration data such as user email subscriptions, tracked cities, and automated reporting preferences. |
| Resend | The transactional email service used to dispatch daily automated AQI briefings and handle email verification links for subscribed users. |
| Tailwind CSS & Framer Motion | Tailwind provides the responsive, utility-first styling system, while Framer Motion handles the complex, physics-based UI orchestration (the breathing orb, layout transitions, animated graphs). |
Below is the architectural workflow detailing how users interact with AQILYTICS from the landing page to generating reports.
Agent Search (Desktop)
|
Result Dashboard (Desktop)
|
AI Analysis Detail
|
Report Generation View
|
Global Pulse (Mobile)
|
Result Dashboard (Mobile)
|
Daily Email Briefings (Resend)
|
|
- Kalash Pratap Gaur (@CaSh007s) - Project Lead & Full Stack Developer
- [Teammate Name 1] - [Role]
- [Teammate Name 2] - [Role]
- [Teammate Name 3] - [Role]
Developed with ❤️ for a cleaner, strictly monitored environment.