https://github.com/lugolbis/waives

AI to predict surf conditions 🏄🤖
https://github.com/lugolbis/waives

machine-learning python pytorch rust tensorflow tensorflowjs web-development

Last synced: 2 months ago
JSON representation

AI to predict surf conditions 🏄🤖

• Host: GitHub
• URL: https://github.com/lugolbis/waives
• Owner: LugolBis
• Created: 2025-01-04T00:01:58.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-21T03:21:25.000Z (about 1 year ago)
• Last Synced: 2025-10-28T06:25:24.240Z (8 months ago)
• Topics: machine-learning, python, pytorch, rust, tensorflow, tensorflowjs, web-development
• Language: Rust
• Homepage: https://lugolbis.github.io/wAIves/
• Size: 9.76 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# wAIves 🏄

## Project Objective :

The objective of this **personal** project is to develop **AI** models that predicting Surf conditions based on weather data.  

This involves Data Mining, Supervised Learning, and Web Application development.

## Key Project Steps :

- **Data Mining** : Text Scraping, Data Analysis, and Formatting to build a large dataset (4GB)

- **Supervised Learning** : Training models using *TensorFlow* and *PyTorch* libraries

- **Web Development** : Setting up server logic (each project branch contains a different implementation of this part) and communication with an API (*OpenWeatherMap*)

## Weather Data :

The weather data collected using *OpenWeatherMap* (and provided to the models) includes: **longitude**, **latitude**, **temperature**, **pressure**, **wind speed**, **wind direction**.  

The value inferred by the models: **wave height**.  

For more information, see the [Data](https://github.com/LugolBis/wAIves/tree/main/DATA) folder.

## Models :

Numerous models have been trained with various parameter variations (epochs, metrics, layers, and datasets).  

These tests have identified the models providing the best results.  

For more information, see the [Models](https://github.com/LugolBis/wAIves/tree/main/Models) folder.

## Online usage :

### [wAIves](https://lugolbis.github.io/wAIves/)

## Local Usage :

### Linux

Download the project and add an ```api_key.txt``` file containing your *OpenWeatherMap* API key in the **wAIves/Python/** folder.  

Run the Python script ***manage_env.py*** :

```

$ python3 manage_env.py

```

Open the ***index.html*** file and start surfing !

### Windows :

Download the project and add an ```api_key.txt``` file containing your *OpenWeatherMap* API key in the **wAIves/Python/** folder.  

Run the Python script ***manage_env.py*** from the **wAIves/Python/** folder.  

Open the ***index.html*** file and start surfing !

## Requirements :

- [OpenWeatherMap](https://openweathermap.org/appid) API key (free)

- | Python version | Compatibility |

  |:-:|:-:|

  | >= v3.10 | ✅ |

  | >= v3.9 | ✅ |

  | >= v3.8 | ✅ |

  | >= v3.7 | ✅ |

  | >= v3.6 | ✅ |

  | >= v3.5 | ✅ |

  | >= v2.7  | ✅ |

  | v3.0.* | ❌ |

  | v3.1.* | ❌ |

  | v3.2.* | ❌ |

  | v3.3.* | ❌ |

  | v3.4.* | ❌ |

## Weather Data Sources :

- NOAA

- NDBC

- Météo France

- SeaDataNet