This tool kit is intended to help people who are interested in using Numenta's NuPIC on vision problems.

We plan to do minor releases only, and limit changes in NuPIC and NuPIC Core to:

• Fixing critical bugs.
• Features needed to support ongoing research.

1. Install nupic.vision and its dependencies

   pip install -e .
   

2. Prepare MNIST data

   cd src/nupic/vision/mnist
   ./extract_mnist.sh
   mkdir mnist
   mv mnist_extraction_source/training mnist/
   mv mnist_extraction_source/testing mnist/
   python ./convertImages.py mnist
   ./create_training_sample.sh
   

3. Run experiment

   python run_mnist_experiment.py --data-dir mnist
   

1. Build docker image with prepared MNIST data

   docker build -t nupic.vision .
   

2. Run MNIST experiment (See Dockerfile for details)

   docker run nupic.vision