Metadata-Version: 2.1
Name: RootsWeatherProject
Version: 1.0.14
Summary: A package holding microservices to create video from compiled weather image data
Home-page: https://github.com/johncanthony/RootsWeatherProject
Author: John Anthony
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.12
Description-Content-Type: text/markdown
Requires-Dist: pytest
Requires-Dist: fastapi
Requires-Dist: pydantic
Requires-Dist: uvicorn
Requires-Dist: httpx
Requires-Dist: redis
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: bs4
Requires-Dist: setuptools
Requires-Dist: ffmpeg-python
Requires-Dist: google_auth_oauthlib
Requires-Dist: google-api-python-client

# Roots Weather Project v2

![Build Workflow](https://github.com/johncanthony/RootsWeatherProject/actions/workflows/python-package.yml/badge.svg) [![PyPI](https://badge.fury.io/py/RootsWeatherProject.svg)](https://badge.fury.io/py/RootsWeatherProject)


`RootsWeatherProjectv2` is a Python package that contains pipeline microservices designed to create videos (h.264) from compiled NOAA GOES image data. 

Project Youtube Link : [https://www.youtube.com/@rweather](https://www.youtube.com/@rWeather)

## Services

- **Manager API**: Uvicorn wrapped FastAPI server for managing video creation jobs state. [ Supported state backend: Redis ]
- **Image Resolver**: Resolves NOAA GOES image urls for a provided region and image resolution
- **Image Grabber**: Fetches the resolved image urls and stores in the shared file storage. 
- **Video Maker**: FFMpeg runner to encode the images into video (h.264 + AAC). [ Encoding Resolutions - 1920x1080, 1080x1920]
- **Video Uploader**: Uploads encoded video to the host service (Youtube is currently the only supported hosting service)

## Installation

The project can be installed using pip:

```bash
$ pip install RootsWeatherProject
```

## Example Architecture (K3S)
![Architecture Diagram](docs/images/RWDArchitecture.png)







