🌪️ Vayu Mitra - AI-Powered Clean Air Intelligence

Smart India Hackathon 2025 - Winning Solution for Delhi-NCR Air Pollution

🎯 Problem Statement

Delhi-NCR faces severe air pollution with multiple overlapping sources (stubble burning, vehicles, industry, dust). Current solutions lack source-level granularity, citizen accessibility, and real-time policy feedback.

🚀 Our Solution

An integrated platform with 4 modules:

1. MOOL - AI source identification
2. DRISTI - AI forecasting
3. Vayu Mitra - Citizen mobile app
4. NIVARAN - Policy dashboard

🏗️ Architecture

[React Dashboard] ←→ [FastAPI Backend] ←→ [Flutter App]
                      ↓
[SQLite] ←→ [Mock AI Engine] ←→ [External APIs]

🛠️ Tech Stack

• Backend: Python FastAPI, SQLAlchemy, SQLite
• Frontend: React.js, Chart.js, Leaflet, TailwindCSS
• Mobile: Flutter (Dart) with multilingual support
• AI/ML: Mock data engine (ready for real models)
• APIs: CPCB, OpenWeatherMap, Google Earth Engine (Phase 2)

📦 Project Structure

vayu-mitra/
├── app/                    # FastAPI Backend
│   ├── main.py            # API endpoints
│   ├── models.py          # Database models
│   ├── schemas.py         # Pydantic schemas
│   ├── database.py        # Database connection
│   └── mock_engine.py     # Mock data generation
├── nivaran-dashboard/     # React Dashboard
│   ├── src/
│   │   ├── components/    # React components
│   │   └── App.js         # Main app
│   └── package.json
├── vayu_mitra_app/        # Flutter Mobile App
│   ├── lib/
│   │   ├── screens/       # App screens
│   │   ├── widgets/       # Reusable widgets
│   │   ├── models/        # Data models
│   │   ├── services/      # API services
│   │   └── providers/     # State management
│   └── pubspec.yaml
├── start_server.py        # Backend startup
├── start_mvp.sh          # Complete MVP startup
├── quick_start.sh        # Quick start script
├── stop_project.sh       # Stop all services
├── manage_project.sh     # Main management script
└── README.md

🚀 Quick Start

Prerequisites

• Python 3.8+
• Node.js 16+
• Flutter 3.0+

1. Clone and Setup

git clone <repository-url>
cd vayu-mitra

2. Start Complete MVP

# Option 1: Use management script (Recommended)
./manage_project.sh start

# Option 2: Use quick start
./quick_start.sh

# Option 3: Use full MVP script
./start_mvp.sh

This will start:

• ✅ Backend API on http://localhost:8000
• ✅ React Dashboard on http://localhost:3000
• ✅ Flutter App (ready to run)

3. Project Management

# Check status
./manage_project.sh status

# Stop all services
./manage_project.sh stop

# Restart everything
./manage_project.sh restart

# Run Flutter mobile app
./manage_project.sh mobile

4. Individual Component Setup

Backend API

cd vayu-mitra
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python start_server.py

React Dashboard

cd nivaran-dashboard
npm install
npm start

Flutter Mobile App

cd vayu_mitra_app
flutter pub get
flutter run

📱 Features

React Dashboard (NIVARAN)

• 📊 Real-time AQI monitoring
• 📈 Interactive charts and visualizations
• 🎛️ Policy simulation sandbox
• 🗺️ Location-based data
• 🤖 AI-powered recommendations

Flutter Mobile App (Vayu Mitra)

• 🌍 Multilingual support (English/Hindi)
• 📍 Location-based AQI display
• ⚠️ Health alerts and advice
• 📸 Pollution reporting with photos
• 📊 24-hour forecast
• 🛣️ Safe routes (coming soon)

Backend API

• 🔌 RESTful API endpoints
• 📊 Real-time data processing
• 🤖 Mock AI engine
• 📈 Policy impact simulation
• 🔄 CORS enabled for frontend

🔗 API Endpoints

Endpoint	Method	Description
/	GET	API information
/health	GET	Health check
/locations	GET	Available locations
/aqi/current/{location}	GET	Current AQI data
/aqi/forecast/{location}	GET	24-hour forecast
/sources/{location}	GET	Pollution source breakdown
/policy/simulate	POST	Policy impact simulation
/init-data	POST	Initialize mock data

🎨 UI/UX Highlights

• Modern Design: Clean, professional interface
• Responsive: Works on desktop and mobile
• Accessible: Color-coded AQI levels
• Interactive: Real-time data updates
• Multilingual: English and Hindi support
• Intuitive: Easy-to-use navigation

🧪 Testing

Backend Testing

# Test API endpoints
curl http://localhost:8000/health
curl http://localhost:8000/locations
curl http://localhost:8000/aqi/current/Delhi-Central

Frontend Testing

• Open http://localhost:3000
• Test location switching
• Verify chart rendering
• Test policy simulation

Mobile Testing

cd vayu_mitra_app
flutter test
flutter run

🚀 Demo Features

For Judges

1. Live Dashboard: Real-time pollution data visualization
2. Policy Simulation: Interactive sliders showing policy impact
3. Mobile App: Multilingual citizen interface
4. AI Integration: Mock AI engine ready for real models
5. End-to-End Flow: Complete data pipeline demonstration

Key Metrics

• ⚡ Real-time data updates
• 📊 9 Delhi-NCR locations
• 🎯 Source-level granularity
• 🌍 Multilingual support
• 📱 Cross-platform compatibility

🔮 Phase 2 Enhancements

• Real AI Models: Replace mock engine with actual ML models
• Satellite Data: Google Earth Engine integration
• Advanced Forecasting: Temporal Fusion Transformer
• Real-time Routing: Live safe route calculation
• Push Notifications: Health alerts and updates
• Social Features: Community reporting and sharing

👥 Team

• Backend Development: FastAPI, PostgreSQL, SQLAlchemy
• Frontend Development: React.js, Chart.js, TailwindCSS
• Mobile Development: Flutter, Dart, Provider
• AI/ML Integration: Mock engine, ready for real models
• UI/UX Design: Modern, accessible, multilingual

📄 License

This project is developed for Smart India Hackathon 2025.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📞 Support

For questions or support, please contact the Vayu Mitra team.

🐙 GitHub Setup

Initial Setup

# Initialize git repository
git init

# Add all files
git add .

# Initial commit
git commit -m "Initial commit: Vayu Mitra MVP for Smart India Hackathon 2025"

# Add remote repository (replace with your GitHub URL)
git remote add origin https://github.com/yourusername/vayu-mitra.git

# Push to GitHub
git push -u origin main

Daily Workflow

# Check status
git status

# Add changes
git add .

# Commit changes
git commit -m "Description of changes"

# Push to GitHub
git push

Project Files Included

• ✅ Complete source code
• ✅ Management scripts
• ✅ Documentation
• ✅ .gitignore (excludes sensitive files)
• ✅ README with setup instructions

---

🌪️ Vayu Mitra - Breathing Clean, Living Smart 🌪️