Introduction
Samples in Visual Studio solution format are provided for users to get started with deep learning using Microsoft Visual Studio Tools for AI. Each solution has one or more sample projects. Solutions are separated by different deep learning frameworks they use:
- CNTK (both BrainScript and Python languages)
- Tensorflow
- Caffe2
- Keras
- MXNet
- Chainer
- Theano
Getting Started
Prerequisites to run the samples
- Install Microsoft Visual Studio 2017 or 2015.
- Install Microsoft Visual Studio Tools for AI.
- Pre-download data
- For CNTK BrainScript MNIST project, in the "input" folder, run "python install_mnist.py" to download data.
Preparing development environment
Before training deep learning models on your local or remote computer you should make sure you have the latest applicable prerequisites installed. This includes making sure the latest drivers and libraries for your NVIDIA GPU (if you have one). You should also ensure you have installed Python and Python libraries such as NumPy, SciPy, Python support for Visual Studio, and appropriate deep learning frameworks such as Microsoft Cognitive Toolkit (CNTK), TensorFlow, Caffe2, MXNet, Keras, Theano, PyTorch and/or Chainer.
Please visit here for detailed instruction.
Using a one-click installer to setup deep learning frameworks
Currently, this installer works on Windows and Linux:
- Install NVIDIA GPU driver, CUDA and cuDNN.
- Install latest Python 3.5 or 3.6. Other Python versions are not supported yet.
- Run the following commands in a terminal:
git clone https://github.com/Microsoft/samples-for-ai.git cd samples-for-ai cd installer - Windows: python.exe install.py - Non-Windows: python3 install.py
Note
On Linux, you may need 'sudo' to install deep learning frameworks into system directory.
Runing samples locally
-
CNTK BrainScript Projects
- Set the project you want to run as "Startup Project".
- Set the script you want to run as "Startup File".
- Click "Run CNTK Brain Script".
-
Python Projects
- Set the "Startup File".
- Right click the startup Python script, and click "Start without Debugging" or "Start with Debugging" context menus.
License
The samples scripts are from official github of each framework. They are under different licenses.
The scripts of CNTK are under MIT license.
The scripts of Tensorflow samples are under Apache 2.0 license. There are no changes on the original code.
For the scripts of Caffe2, different versions released with different licenses. Currently, the master branch is under Apache 2.0 license. But the version 0.7 and 0.8.1 were released with BSD 2-Clause license. The scripts in our solution are based on caffe2 github source tree version 0.7 and 0.8.1, with BSD 2-Clause license.
The scripts of Keras are under MIT license.
The scripts of Theano are under BSD license.
The scripts of MXNet are under Apache 2.0 license. There are no changes on the original code.
The scripts of Chainer are under MIT license.