---
title: Alex Weather App
emoji: 🚀
colorFrom: green
colorTo: gray
sdk: docker
pinned: false
license: apache-2.0
app_port: 8501
---

# BYU Weather App
__Historic Weather Data as Seen in All 3 BYU Campus Locations__

## Overview
This streamlit app uses the Open-Meteo API to read historic weather data based on user input. It provides data tables, visualizations, and data customization. You can compare Hawaii, Idaho, and Provo locations through variables such as temperature, wind speed, precipitation, and several more. You can also customize through what date range the comparisons are made. ie. You can pull data from January of 2 years ago if you like. 

## Development Environment
Run through docker
Hosted on Hugging Face
Built in streamlit
Noteable libraries: openmeteo-requests, polars, altair

## Running the App
The app runs through a docker container, meaning no python software or libraries need to be pre-installed locally. First, ensure [docker desktop](https://www.docker.com/products/docker-desktop/) is installed and open. This can handle all remaining dependencies on a virtual machine. From here, simply clone the repository, and in some terminal, navigate to the cloned folder, and run _docker compose up_. If used for the first time, this will build the docker image, and start the web-app locally. Navigating to http://localhost:8501 for windows, or http://0.0.0.0:8501 on mac/linux will bring you to the app.