🇺🇦 UKRAINE IS BEING ATTACKED BY RUSSIAN ARMY. CIVILIANS ARE GETTING KILLED. RESIDENTIAL AREAS ARE GETTING BOMBED.

• Help Ukraine via:
  • Serhiy Prytula Charity Foundation
  • Come Back Alive Charity Foundation
  • National Bank of Ukraine
• More info on war.ukraine.ua and MFA of Ukraine

This is a collection of interactive machine-learning experiments. Each experiment consists of 🏋️ Jupyter/Colab notebook (to see how a model was trained) and 🎨 demo page (to see a model in action right in your browser).

• 🎨 Launch ML experiments demo
• 🏋️ Launch ML experiments Jupyter notebooks

⚠️ This repository contains machine learning experiments and not a production ready, reusable, optimised and fine-tuned code and models. This is rather a sandbox or a playground for learning and trying different machine learning approaches, algorithms and data-sets. Models might not perform well and there is a place for overfitting/underfitting.

Most of the models in these experiments were trained using TensorFlow 2 with Keras support.

Supervised learning is when you have input variables X and an output variable Y and you use an algorithm to learn the mapping function from the input to the output: Y = f(X). The goal is to approximate the mapping function so well that when you have new input data X that you can predict the output variables Y for that data. It is called supervised learning because the process of an algorithm learning from the training dataset can be thought of as a teacher supervising the learning process.

A multilayer perceptron (MLP) is a class of feedforward artificial neural network (ANN). Multilayer perceptrons are sometimes referred to as "vanilla" neural networks (composed of multiple layers of perceptrons), especially when they have a single hidden layer. It can distinguish data that is not linearly separable.

	Experiment	Model demo & training	Tags	Dataset
	Handwritten Digits Recognition (MLP)		MLP	MNIST
	Handwritten Sketch Recognition (MLP)		MLP	QuickDraw

A convolutional neural network (CNN, or ConvNet) is a class of deep neural networks, most commonly applied to analyzing visual imagery (photos, videos). They are used for detecting and classifying objects on photos and videos, style transfer, face recognition, pose estimation etc.

	Experiment	Model demo & training	Tags	Dataset
	Handwritten Digits Recognition (CNN)		CNN	MNIST
	Handwritten Sketch Recognition (CNN)		CNN	QuickDraw
	Rock Paper Scissors (CNN)		CNN	RPS
	Rock Paper Scissors (MobilenetV2)		MobileNetV2, Transfer learning, CNN	RPS , ImageNet
	Objects Detection (MobileNetV2)		MobileNetV2, SSDLite, CNN	COCO
	Image Classification (MobileNetV2)		MobileNetV2, CNN	ImageNet

A recurrent neural network (RNN) is a class of deep neural networks, most commonly applied to sequence-based data like speech, voice, text or music. They are used for machine translation, speech recognition, voice synthesis etc.

	Experiment	Model demo & training	Tags	Dataset
	Numbers Summation (RNN)		LSTM, Sequence-to-sequence	Auto-generated
	Shakespeare Text Generation (RNN)		LSTM, Character-based RNN	Shakespeare
	Wikipedia Text Generation (RNN)		LSTM, Character-based RNN	Wikipedia
	Recipe Generation (RNN)		LSTM, Character-based RNN	Recipe box

Unsupervised learning is when you only have input data X and no corresponding output variables. The goal for unsupervised learning is to model the underlying structure or distribution in the data in order to learn more about the data. These are called unsupervised learning because unlike supervised learning above there is no correct answers and there is no teacher. Algorithms are left to their own to discover and present the interesting structure in the data.

A generative adversarial network (GAN) is a class of machine learning frameworks where two neural networks contest with each other in a game. Two models are trained simultaneously by an adversarial process. For example a generator ("the artist") learns to create images that look real, while a discriminator ("the art critic") learns to tell real images apart from fakes.

	Experiment	Model demo & training	Tags	Dataset
	Clothes Generation (DCGAN)		DCGAN	Fashion MNIST

# Create "experiments" environment (from the project root folder).
python3 -m venv .virtualenvs/experiments

# Activate environment.
source .virtualenvs/experiments/bin/activate
# or if you use Fish...
source .virtualenvs/experiments/bin/activate.fish

To quit an environment run deactivate.

# Upgrade pip and setuptools to the latest versions.
pip install --upgrade pip setuptools

# Install packages
pip install -r requirements.txt

To install new packages run pip install package-name. To add new packages to the requirements run pip freeze > requirements.txt.

In order to play around with Jupyter notebooks and see how models were trained you need to launch a Jupyter Notebook server.

# Launch Jupyter server.
jupyter notebook

Jupyter will be available locally at http://localhost:8888/. Notebooks with experiments may be found in experiments folder.

Demo application is made on React by means of create-react-app.

# Switch to demos folder from project root.
cd demos

# Install all dependencies.
yarn install

# Start demo server on http. 
yarn start

# Or start demo server on https (for camera access in browser to work on localhost).
yarn start-https

Demos will be available locally at http://localhost:3000/ or at https://localhost:3000/.

The converter environment is used to convert the models that were trained during the experiments from .h5 Keras format to Javascript understandable formats (tfjs_layers_model or tfjs_graph_model formats with .json and .bin files) for further usage with TensorFlow.js in Demo application.

# Create "converter" environment (from the project root folder).
python3 -m venv .virtualenvs/converter

# Activate "converter" environment.
source .virtualenvs/converter/bin/activate
# or if you use Fish...
source .virtualenvs/converter/bin/activate.fish

# Install converter requirements.
pip install -r requirements.converter.txt

The conversion of keras models to tfjs_layers_model/tfjs_graph_model formats is done by tfjs-converter:

For example:

tensorflowjs_converter --input_format keras \
  ./experiments/digits_recognition_mlp/digits_recognition_mlp.h5 \
  ./demos/public/models/digits_recognition_mlp

⚠️ Converting the models to JS understandable formats and loading them to the browser directly might not be a good practice since in this case the user might need to load tens or hundreds of megabytes of data to the browser which is not efficient. Normally the model is being served from the back-end (i.e. TensorFlow Extended) and instead of loading it all to the browser the user will do a lightweight HTTP request to do a prediction. But since the Demo App is just an experiment and not a production-ready app and for the sake of simplicity (to avoid having an up and running back-end) we're converting the models to JS understandable formats and loading them directly into the browser.

Recommended versions:

• Python: > 3.7.3.
• Node: >= 12.4.0.
• Yarn: >= 1.13.0.

In case if you have Python version 3.7.3 you might experience RuntimeError: dictionary changed size during iteration error when trying to import tensorflow (see the issue).

• Homemade Machine Learning - Python examples of popular machine learning algorithms with interactive Jupyter demos and math being explained.
• NanoNeuron - 7 simple JavaScript functions that will give you a feeling of how machines can actually "learn".
• Playground and Cheatsheet for Learning Python - Collection of Python scripts that are split by topics and contain code examples with explanations.

• 📝 Story behind the project
• 📝 Generating cooking recipes using TensorFlow and LSTM Recurrent Neural Network (a step-by-step guide)

• @trekhleb