NASA-Hackathon

This project is WeatherLens

---

Project Structure

NASA-Hackthon/
│
├── backend/                   
│   ├── main.py                 # Main backend server using FastAPI
│   ├── requirements.txt       # Python dependencies
│
└── frontend/                  # Vite + React Frontend for user interactions
    ├── src/
    │   └── components/        # React components for UI
    ├── package.json           # Node.js dependencies
    └── public/                # Public assets (e.g., index.html, images, and other static files)

---

Prerequisites

Backend:

• Python 3.7 or higher
• Pip (Python package manager)
• Virtual Environment (optional but recommended)

Frontend:

• Node.js (v14 or higher recommended)
• npm (Node package manager)
• Vite for React development

---

Setup Instructions

1. Clone the Repository

git clone https://github.com/dfsb4/NASA-Hackathon.git

---

2. Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Create and activate a virtual environment (optional but recommended):

   python3 -m venv venv
   source venv/bin/activate  # For MacOS / Linux
   .\venv\Scripts\activate   # For Windows

3. Install dependencies:

   pip install -r requirements.txt

4. Configure Environment Variables:

   • Create a .env file in the backend directory.
   • Add your Gemini API Key
   • Add your Earthdata account

     GEMINI_API_KEY=your_gemini_api_key_here
     EARTHDATA_USERNAME=dfsb4
     [email protected]
     

5. Download the Dataset

   cd backend/utils
   python download_mon.py

6. Start the Backend Server:

   uvicorn main:app --host 0.0.0.0 --port 8000 # For MacOS
   python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload # For Windows
   

7. Backend Server will run at:

   curl http://127.0.0.1:8000/api/health
   

---

3. Frontend Setup (Vite + React)

1. Navigate to the frontend directory:

   cd ../frontend

2. Install dependencies:

   npm install
   npm install react-simple-maps d3-geo

3. Start the Vite Development Server:

   npm run dev

4. Frontend will be accessible at:

   http://localhost:5173/
   

---

What It Does

• Provides intuitive comfort/risk cues (heat, humidity, wind, precipitation likelihood) and map-based city comparisons.
• Offers a “backup” mode that suggests better time windows or alternative activities when weather is unfavorable.
• Designed for travelers, event organizers, and volunteers who want quick, visual decisions.

---

Deployed URLs

Backend (Render): https://nasa-hackathon-3dwe.onrender.com

Frontend (Vercel): https://nasa-hackathon-five.vercel.app/

---

Tech & Design Highlights

Frontend: React + modern UI utilities for smooth geospatial interaction.

Backend: Python-based service layer for model inference and data orchestration.

Data: Open satellite/reanalysis sources; timestamps and uncertainty communicated in-app.

UX: Color-safe indicators, mobile performance, accessibility, and multilingual readiness.

Privacy: No personal data collection; sources and limitations clearly labeled.

License

This project is licensed under the MIT License. Feel free to use and modify it for your own purposes.