Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
rhammell authored Jul 16, 2017
1 parent 996570c commit c9cc106
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# mnist-draw
This repository contains a single page website that enables users to draw and classify digits (0-9) using machine learning.
This repository contains a single page website that enables users to draw and classify digits (0-9) using machine learning. Included is a TFLearn model trained against the MNIST dataset,

# Setup
Python 3.5+ is required for compatability with all required modules
Expand All @@ -15,6 +15,15 @@ cd mnist-draw
pip install -r requirements.txt
```

## Machine Learning Model
Python scripts related to defining, training, and implementing the machine learning model are contained within the `cgi-bin` folder.

A convolutional neural network (CNN) is defined within the `model.py` module using the [TFLearn](http://tflearn.org/) library. This model is designed for MNIST image input.

The defined CNN can be trained against the MNIST dataset by running the `train.py` script. This script will automaticallly load the MNIST dataset from the TFLearn library to use as input, and the trained model's parameter files are saved into the `models` directory. Pre-trained model files are made available in this directory already.

The `mnist.py` script implements this trained model against the user's handdrawn input.

# Usage
To launch the website, begin by starting a Python server from the repository folder:
```bash
Expand Down

0 comments on commit c9cc106

Please sign in to comment.