🌤️ AtmosIQ

Premium atmospheric intelligence and flood risk monitoring.
AtmosIQ is a serverless, AI-powered weather platform that transforms raw atmospheric data into actionable, localized insights and dynamic risk maps.

---

✨ Features

• 🧠 AI-Powered Reasoning: Integrates Llama 3.3 70B (via Groq) to provide intelligent atmospheric analysis, safety recommendations, and a conversational AI assistant (AtmosChat).
• ⚡ Real-Time Data Streams: Aggregates live weather data from OpenWeather and Tomorrow.io with 5-minute refresh cycles for unmatched precision.
• 🗺️ Interactive Risk Mapping: Features a highly customized, hardware-accelerated heatmap using Leaflet to visualize flood risk zones and atmospheric density.
• 🛡️ Stateless & Secure: Operates entirely on Vercel Edge Functions with zero database footprint, utilizing strict CORS, input validation, and secure secret management.
• 🎨 Premium UI/UX: Built with Tailwind CSS and Framer Motion, offering a responsive, glassmorphism-inspired dark mode interface.

---

🛠️ Tech Stack

• Frontend: React 19, Next.js 16 (App Router), Tailwind CSS v4, Framer Motion, Radix UI, Leaflet
• Backend: Next.js API Routes (Vercel Serverless Functions)
• AI / LLM: Groq API (Llama-3.3-70B-Versatile)
• APIs: OpenWeather API, Tomorrow.io API, Open-Meteo
• Deployment: Vercel

---

🚀 Getting Started

Follow these instructions to set up the project locally.

Prerequisites

• Node.js (v18 or higher)
• npm or pnpm
• API Keys for:
  • OpenWeatherMap
  • Tomorrow.io
  • Groq

Environment Variables

Create a .env.local file in the root directory and add the following:

OPENWEATHER_API_KEY="your_openweather_api_key"
TOMORROW_API_KEY="your_tomorrow_io_api_key"
GROQ_API_KEY="your_groq_api_key"

# Optional: Set to 'true' to run the app using local mock data without hitting APIs
NEXT_PUBLIC_DEMO_MODE="false"

Installation

Clone the repository and install the dependencies:

# Clone the repo
git clone https://github.com/Asmit1211/AtmosIQ-Project.git

# Navigate to the project directory
cd AtmosIQ

# Install dependencies
npm install

Running Locally

Start the development server (Webpack is recommended to avoid Turbopack conflicts in Next.js 16):

npm run dev

Open http://localhost:3000 in your browser to view the application.

---

📂 Architecture / Folder Structure

AtmosIQ/
├── app/
│   ├── api/                  # Vercel Serverless Edge Functions
│   │   ├── chat/             # AI AtmosChat endpoint
│   │   └── dashboard-data/   # Unified data orchestration API
│   ├── dashboard/            # Main dashboard route
│   ├── layout.tsx            # Root layout and global providers
│   └── page.tsx              # Landing page
├── components/               # Reusable React components
│   ├── chat/                 # AtmosChat UI
│   ├── dashboard/            # Dashboard widgets (Charts, Insights, Forecast)
│   ├── map/                  # Leaflet interactive map & layers
│   └── ui/                   # Radix UI primitive components
├── hooks/                    # Custom React hooks (Geolocation, Dashboard Data)
├── lib/                      # Core logic and utilities
│   ├── api-security.ts       # CORS, sanitization, validation
│   ├── risk-engine.ts        # Flood & weather risk score calculation
│   └── types.ts              # TypeScript interfaces
├── public/                   # Static assets & icons
├── styles/                   # Global CSS & Tailwind configuration
├── next.config.mjs           # Next.js configuration and headers
└── vercel.json               # Vercel deployment & security settings

---

🤝 Contributors

• Asmit - Lead Developer / Architect - GitHub

---

Built with passion for the WeatherWise Hackathon.