Dahbaeraychy/airsense-bot

WhatsApp-based AI bot that delivers real-time air quality alerts and personalized health guidance for every city in Nigeria — no app download required. # 🌬️ AirSense > Real-time air quality alerts for every Nigerian city — delivered straight to WhatsApp. No app download required. --- ## What is AirSense? AirSense is a WhatsApp-native air quality assistant built specifically for Nigeria. Users simply message the bot with any Nigerian city name or share their GPS location, and instantly receive: - Their **Air Quality Index (AQI)** reading - A breakdown of key **pollutants** (PM2.5, PM10, NO₂, O₃, Dust) - **AI-powered health guidance** tailored to their reading - The ability to **subscribe for daily alerts** - A way to **report local pollution** events Powered by Open-Meteo satellite data — covering all **36 states and the FCT** — with no API key required for air quality data. --- ## Why AirSense? Nigeria loses over **21,000 lives per year** to air pollution. The average Nigerian city exceeds WHO PM2.5 limits by **8 times**. Yet no accessible tool exists to help everyday Nigerians monitor the air they breathe. AirSense solves this by meeting people where they already are — **WhatsApp**, which has over 90% penetration in Nigerian urban areas. No app to download, no account to create, no data to waste. --- ## Features - 🇳🇬 **Full Nigeria coverage** — 100+ cities across all 36 states + FCT - 📡 **Satellite-based data** — powered by Open-Meteo, free and always available - 🤖 **AI health tips** — Claude AI generates personalized guidance per reading - 🔔 **Daily alert subscriptions** — morning air quality briefings - 📢 **Community pollution reporting** — crowdsourced local incident logging - 💬 **WhatsApp-native** — zero friction, works on any phone - 🌍 **GPS support** — share location for hyperlocal readings - ⚡ **Fast** — results in under 5 seconds --- ## Tech Stack | Layer | Technology | |---|---| | Runtime | Node.js 18+ | | Framework | Express.js | | Messaging | WhatsApp Cloud API (Meta) | | Air Quality Data | Open-Meteo (satellite, free) | | AI Guidance | Anthropic Claude Haiku | | Deployment | Render.co …