Created by Irfan
Fullstack AI/ML Project

This repository hosts the Weather App, a robust full-stack application designed to provide real-time weather data and air quality information for any location—using a modern, user-friendly interface and a scalable, extensible backend.

Built as part of an AI/ML Software Engineer technical assessment, this project demonstrates best practices in API design, user input handling, data validation, database CRUD operations, and optional integrations with third-party platforms (e.g., YouTube, Google Maps).

Key Value:

• Real-world API integration
• Clean, modular codebase
• Designed for extensibility and professional deployment
• Ready for demonstration, portfolio, or further development

• Universal Location Input:
  Search weather and air quality by city, zip code, coordinates, or landmarks. Robust validation and fuzzy matching for user convenience.

• Real-Time Weather & 5-Day Forecast:
  Live data from OpenWeatherMap, including detailed weather info, icons, and at-a-glance summaries.

• Air Quality Index (AQI) Data:
  Instantly retrieve current air quality information for user-selected locations, powered by OpenWeatherMap Air Pollution API.

• Geolocation Support:
  Instantly fetch weather and air quality for your current position—using your browser/device location (with user permission).

• Comprehensive CRUD:
  Save, update, view, and delete weather and air quality queries/records. All data is persisted in a robust SQLite database via SQLAlchemy ORM.

• Data Export:
  Export your search history or saved records to JSON, CSV, XML, or PDF formats with one click. Great for data portability, analytics, and reporting.

• API Integrations:

  • Google Maps: Visualize searched locations on the map.
  • YouTube: Watch trending videos about your searched location.
  • OpenWeatherMap Weather & Air Quality APIs

• Responsive & Accessible UI:
  Clean, mobile-friendly design with flexible color gradients and intuitive controls. Accessibility best practices followed.

• Error Handling:
  Clear, actionable error messages for every input and API call.

• No Authentication Required:
  All features are open for demonstration and review.

• Info Button:
  Learn more about the project and about me, Mohd Irfan, from the Info page.

• Backend: Python 3.12+, Flask, SQLAlchemy, SQLite
• Frontend: HTML5, CSS3, JavaScript (ES6+), Jinja2
• APIs: OpenWeatherMap (Weather & Air Quality), YouTube Data API, Google Maps
• Utilities: Pandas (export), FPDF (PDF export), python-dotenv (for secure API key management)
• Testing: (Add your test framework, e.g., pytest, if implemented)
• Deployment: Easily deployable on Heroku, Render, or any WSGI-compatible service

Home Page

Search Result

Air Quality

Google Location & YouTube Videos

Records (CRUD)

Info Page

weather-app/ │ ├── .env ├── .gitignore ├── README.md ├── requirements.txt ├── run.py ├── test.py │ ├── app/ │ ├── air_quality.py │ ├── export.py │ ├── forms.py │ ├── geocode.py │ ├── maps_api.py │ ├── models.py │ ├── routes.py │ ├── utils.py │ ├── weather_api.py │ ├── youtube_api.py │ └── __init__.py │ ├── instance/ │ └── weather_app.db │ ├── static/ │ ├── style.css │ ├── css/ │ ├── img/ │ └── js/ │ ├── templates/ │ ├── base.html │ ├── create.html │ ├── edit.html │ ├── history.html │ ├── index.html │ ├── info.html │ ├── list.html │ ├── view.html │ └── weather.html │ └── __pycache__/ 

git clone https://github.com/yourusername/weather-app.git cd weather-app

python -m venv venv # Activate: # Windows: venv\Scripts\activate # Mac/Linux: source venv/bin/activate

pip install -r requirements.txt

• Copy the example file and add your API keys:

  cp .env.example .env

• Get a free OpenWeatherMap API Key
• Get a YouTube Data API Key

flask run

• Open http://localhost:5000 in your browser.

• Create: Save any weather or air quality search with location and date range.
• Read: Review all your saved queries and their results.
• Update: Modify existing records (location or date).
• Delete: Remove any record with one click.
• Export: Download all your data in JSON, CSV, XML, or PDF.

Embed your screencast or YouTube demo link below for reviewers and LinkedIn viewers:

📹 Watch Demo on Vimeo

• Author: Irfan
• Email: mohdirfanwork786@gmail.com
• LinkedIn: Mohd Irfan
• GitHub: mohdirfan-code
• Twitter/X: @Irfu6428

If you found this project useful or inspiring:

• Star this repo ⭐
• Fork and contribute 🤝

Thank you so much for checking out my Weather App!