Home

Awesome

πŸ€– Interactive Machine Learning Experiments

πŸ‡ΊπŸ‡¦ UKRAINE IS BEING ATTACKED BY RUSSIAN ARMY. CIVILIANS ARE GETTING KILLED. RESIDENTIAL AREAS ARE GETTING BOMBED.

<hr/>

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).

⚠️ 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.

Experiments

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

Supervised Machine Learning

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.

Multilayer Perceptron (MLP) or simple Neural Network (NN)

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.

<table> <thead> <tr> <th align="left" width="150" style="width: 150px !important"> </th> <th align="left" width="200" style="width: 200px !important">Experiment</th> <th align="left" width="140" style="width: 140px !important">Model demo & training</th> <th align="left">Tags</th> <th align="left" width="140" style="width: 140px !important">Dataset</th> </tr> </thead> <tbody> <!-- Experiment --> <tr> <td> <img src="demos/src/images/digits_recognition_mlp.png" alt="Handwritten digits recognition (MLP)" width="150" /> </td> <td> <a href="experiments/digits_recognition_mlp/digits_recognition_mlp.ipynb"> <b>Handwritten Digits Recognition (MLP)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/DigitsRecognitionMLP"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/digits_recognition_mlp/digits_recognition_mlp.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/digits_recognition_mlp/digits_recognition_mlp.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>MLP</code> </td> <td> <a href="https://www.tensorflow.org/datasets/catalog/mnist"> MNIST </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/sketch_recognition_mlp.png" alt="Handwritten sketch recognition (MLP)" width="150" /> </td> <td> <a href="experiments/sketch_recognition_mlp/sketch_recognition_mlp.ipynb"> <b>Handwritten Sketch Recognition (MLP)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/SketchRecognitionMLP"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/sketch_recognition_mlp/sketch_recognition_mlp.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/sketch_recognition_mlp/sketch_recognition_mlp.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>MLP</code> </td> <td> <a href="https://github.com/googlecreativelab/quickdraw-dataset"> QuickDraw </a> </td> </tr> </tbody> </table>

Convolutional Neural Networks (CNN)

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.

<table> <thead> <tr> <th align="left" width="150" style="width: 150px !important"> </th> <th align="left" width="200" style="width: 200px !important">Experiment</th> <th align="left" width="140" style="width: 140px !important">Model demo & training</th> <th align="left">Tags</th> <th align="left" width="140" style="width: 140px !important">Dataset</th> </tr> </thead> <tbody> <!-- Experiment --> <tr> <td> <img src="demos/src/images/digits_recognition_cnn.png" alt="Handwritten digits recognition (CNN)" /> </td> <td> <a href="experiments/digits_recognition_cnn/digits_recognition_cnn.ipynb"> <b>Handwritten Digits Recognition (CNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/DigitsRecognitionCNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/digits_recognition_cnn/digits_recognition_cnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/digits_recognition_cnn/digits_recognition_cnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>CNN</code> </td> <td> <a href="https://www.tensorflow.org/datasets/catalog/mnist"> MNIST </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/sketch_recognition_cnn.png" alt="Handwritten sketch recognition (CNN)" width="150" /> </td> <td> <a href="experiments/sketch_recognition_cnn/sketch_recognition_cnn.ipynb"> <b>Handwritten Sketch Recognition (CNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/SketchRecognitionCNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/sketch_recognition_cnn/sketch_recognition_cnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/sketch_recognition_cnn/sketch_recognition_cnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>CNN</code> </td> <td> <a href="https://github.com/googlecreativelab/quickdraw-dataset"> QuickDraw </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/rock_paper_scissors_cnn.jpg" alt="Rock Paper Scissors" width="150" /> </td> <td> <a href="experiments/rock_paper_scissors_cnn/rock_paper_scissors_cnn.ipynb"> <b>Rock Paper Scissors (CNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/RockPaperScissorsCNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/rock_paper_scissors_cnn/rock_paper_scissors_cnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/rock_paper_scissors_cnn/rock_paper_scissors_cnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>CNN</code> </td> <td> <a href="http://www.laurencemoroney.com/rock-paper-scissors-dataset/"> RPS </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/rock_paper_scissors_mobilenet_v2.jpg" alt="Rock Paper Scissors" width="150" /> </td> <td> <a href="experiments/rock_paper_scissors_mobilenet_v2/rock_paper_scissors_mobilenet_v2.ipynb"> <b>Rock Paper Scissors (MobilenetV2)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/RockPaperScissorsMobilenetV2"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/rock_paper_scissors_mobilenet_v2/rock_paper_scissors_mobilenet_v2.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/rock_paper_scissors_mobilenet_v2/rock_paper_scissors_mobilenet_v2.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>MobileNetV2</code>, <code>Transfer learning</code>, <code>CNN</code> </td> <td> <a href="http://www.laurencemoroney.com/rock-paper-scissors-dataset/"> RPS </a>, <a href="http://image-net.org/explore"> ImageNet </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/objects_detection_ssdlite_mobilenet_v2.jpg" alt="Objects detection" width="150" /> </td> <td> <a href="experiments/objects_detection_ssdlite_mobilenet_v2/objects_detection_ssdlite_mobilenet_v2.ipynb"> <b>Objects Detection (MobileNetV2)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/ObjectsDetectionSSDLiteMobilenetV2"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/objects_detection_ssdlite_mobilenet_v2/objects_detection_ssdlite_mobilenet_v2.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/objects_detection_ssdlite_mobilenet_v2/objects_detection_ssdlite_mobilenet_v2.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>MobileNetV2</code>, <code>SSDLite</code>, <code>CNN</code> </td> <td> <a href="http://cocodataset.org/#home"> COCO </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/image_classification_mobilenet_v2.jpg" alt="Objects detection" width="150" /> </td> <td> <a href="experiments/image_classification_mobilenet_v2/image_classification_mobilenet_v2.ipynb"> <b>Image Classification (MobileNetV2)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/ImageClassificationMobilenetV2"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/image_classification_mobilenet_v2/image_classification_mobilenet_v2.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/image_classification_mobilenet_v2/image_classification_mobilenet_v2.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>MobileNetV2</code>, <code>CNN</code> </td> <td> <a href="http://image-net.org/explore"> ImageNet </a> </td> </tr> </tbody> </table>

Recurrent Neural Networks (RNN)

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.

<table> <thead> <tr> <th align="left" width="150" style="width: 150px !important"> </th> <th align="left" width="200" style="width: 200px !important">Experiment</th> <th align="left" width="140" style="width: 140px !important">Model demo & training</th> <th align="left">Tags</th> <th align="left" width="140" style="width: 140px !important">Dataset</th> </tr> </thead> <tbody> <!-- Experiment --> <tr> <td> <img src="demos/src/images/numbers_summation_rnn.png" alt="Numbers summation (RNN)" width="150" /> </td> <td> <a href="experiments/numbers_summation_rnn/numbers_summation_rnn.ipynb"> <b>Numbers Summation (RNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/NumbersSummationRNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/numbers_summation_rnn/numbers_summation_rnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/numbers_summation_rnn/numbers_summation_rnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>LSTM</code>, <code>Sequence-to-sequence</code> </td> <td> Auto-generated </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/text_generation_shakespeare_rnn.jpg" alt="Shakespeare Text Generation (RNN)" width="150" /> </td> <td> <a href="experiments/text_generation_shakespeare_rnn/text_generation_shakespeare_rnn.ipynb"> <b>Shakespeare Text Generation (RNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/TextGenerationShakespeareRNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/text_generation_shakespeare_rnn/text_generation_shakespeare_rnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/text_generation_shakespeare_rnn/text_generation_shakespeare_rnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>LSTM</code>, <code>Character-based RNN</code> </td> <td> <a href="https://storage.googleapis.com/download.tensorflow.org/data/shakespeare.txt"> Shakespeare </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/text_generation_wikipedia_rnn.png" alt="Wikipedia Text Generation (RNN)" width="150" /> </td> <td> <a href="experiments/text_generation_wikipedia_rnn/text_generation_wikipedia_rnn.ipynb"> <b>Wikipedia Text Generation (RNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/TextGenerationWikipediaRNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/text_generation_wikipedia_rnn/text_generation_wikipedia_rnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/text_generation_wikipedia_rnn/text_generation_wikipedia_rnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>LSTM</code>, <code>Character-based RNN</code> </td> <td> <a href="https://www.tensorflow.org/datasets/catalog/wikipedia"> Wikipedia </a> </td> </tr> <!-- Experiment --> <tr> <td> <img src="demos/src/images/recipe_generation_rnn.jpg" alt="Recipe Generation (RNN)" width="150" /> </td> <td> <a href="experiments/recipe_generation_rnn/recipe_generation_rnn.ipynb"> <b>Recipe Generation (RNN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/RecipeGenerationRNN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/recipe_generation_rnn/recipe_generation_rnn.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/recipe_generation_rnn/recipe_generation_rnn.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>LSTM</code>, <code>Character-based RNN</code> </td> <td> <a href="https://eightportions.com/datasets/Recipes/"> Recipe box </a> </td> </tr> </tbody> </table>

Unsupervised Machine Learning

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.

Generative Adversarial Networks (GANs)

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.

<table> <thead> <tr> <th align="left" width="150" style="width: 150px !important"> </th> <th align="left" width="200" style="width: 200px !important">Experiment</th> <th align="left" width="140" style="width: 140px !important">Model demo & training</th> <th align="left">Tags</th> <th align="left" width="140" style="width: 140px !important">Dataset</th> </tr> </thead> <tbody> <!-- Experiment --> <tr> <td> <img src="demos/src/images/clothes_generation_dcgan.jpg" alt="Clothes Generation (DCGAN)" width="150" /> </td> <td> <a href="experiments/clothes_generation_dcgan/clothes_generation_dcgan.ipynb"> <b>Clothes Generation (DCGAN)</b> </a> </td> <td> <a href="https://trekhleb.github.io/machine-learning-experiments/#/experiments/ClothesGenerationDCGAN"> <img src="https://img.shields.io/static/v1?label=%F0%9F%8E%A8%20Launch&message=Demo&color=green" alt="Launch demo"> </a> <a href="https://nbviewer.jupyter.org/github/trekhleb/machine-learning-experiments/blob/master/experiments/clothes_generation_dcgan/clothes_generation_dcgan.ipynb"> <img src="https://mybinder.org/badge_logo.svg" alt="Open in Binder"/> </a> <a href="https://colab.research.google.com/github/trekhleb/machine-learning-experiments/blob/master/experiments/clothes_generation_dcgan/clothes_generation_dcgan.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/> </a> </td> <td> <code>DCGAN</code> </td> <td> <a href="https://www.tensorflow.org/datasets/catalog/fashion_mnist"> Fashion MNIST </a> </td> </tr> </tbody> </table>

How to use this repository locally

Setup virtual environment for Experiments

# 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.

Install dependencies

# 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.

Launch Jupyter locally

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.

Launch demos locally

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/.

Convert models

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.

Requirements

Recommended versions:

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).

You might also be interested in

Articles

Author