🌍 AirSense – Multi-Agentic Air Quality Trends Analysis System
AirSense is a full-stack air quality monitoring and analytics platform designed to transform fragmented environmental data into actionable insights.
The system aggregates multi-source PM2.5 and PM10 data, performs comparative analytics, delivers AI-powered forecasts, and enables natural-language analytics through an LLM-based planning agent.
This project was developed as a collaborative group project at SLIIT for the Information Retrieval and Web Analytics (IT3041) module.
🚀 Key Features
🌐 Multi-Source Data Aggregation
- Scrapes hourly air quality data from Open-Meteo, OpenAQ, IQAir, and WAQI
- Applies weighted aggregation with outlier trimming to ensure reliable data
- Persists clean, aggregated time-series data in MySQL
📊 Advanced Analytics
- Multi-city comparison with KPIs (mean, min, max PM levels)
- Best vs worst city ranking
- Part-to-whole and trend-based analysis
📈 AI-Powered Forecasting
- Time-series forecasting using SARIMAX
- Confidence intervals and backtesting (MAE, RMSE)
- Single-city and multi-city prediction support
🤖 LLM-Based Planning Agent (Enterprise Tier)
- Natural-language queries converted into executable analysis plans
- Uses a critic-based reflection pattern to ensure security and capability limits
- Transparent execution traces for explainability
🔐 Security & Tiered Access
- JWT-based authentication with bcrypt password hashing
- Subscription tiers: Free, Pro, Enterprise
- Plan-based enforcement of data windows, city limits, and forecast horizons
🧾 Professional Reporting
- Auto-generated PDF reports with charts and KPI tables
- Server-side rendering using ReportLab
🧱 System Architecture
AirSense follows a four-layer architecture:
- Presentation Layer – React SPA with interactive charts
- Application Layer – FastAPI backend with modular routers
- Data Layer – MySQL + SQLAlchemy ORM
- Intelligent Agent Layer – LLM planner with MCP-style tool orchestration
This architecture enables scalability, security, and clear separation of concerns :contentReference[oaicite:1]{index=1}.
🛠️ Tech Stack
- Frontend: React, Tailwind CSS, Recharts
- Backend: FastAPI (Python), Uvicorn
- Database: MySQL, SQLAlchemy
- AI / Analytics: SARIMAX, LLM (Ollama / Gemma), Agent Planning
- Security: JWT, bcrypt
- Reporting: ReportLab (PDF generation)
🧠 Responsible AI Practices
- Fairness: Multi-source aggregation to reduce sensor bias
- Explainability: Interpretable SARIMAX models + execution traces
- Transparency: Visible data sources, KPIs, and agent steps
- Privacy: No personal location tracking; secure credential handling
👥 Team & Leadership
Team Leader & Full-Stack Integration Architect:
Hirusha D G A D (IT23183018)
Key contributions include:
- AI forecasting engine & backtesting
- LLM agent design and orchestration
- Authentication & tier enforcement
- System-wide integration and documentation leadership
(Full contribution breakdown available in the final report) :contentReference[oaicite:2]{index=2}.
🎯 Academic Context
- Institution: Sri Lanka Institute of Information Technology (SLIIT)
- Module: IT3041 – Information Retrieval and Web Analytics
- Year: 2025
- Project Type: Group Project (Industry-oriented system)
📌 Future Enhancements
- Real-time alerts for pollution thresholds
- Additional data sources & ML models
- Extended agent reasoning capabilities
- Cloud deployment and CI/CD pipelines
📜 License
This project is released for academic and learning purposes.