Quick start

No matter what your level of experience with Deep Learning systems may be, nGraph provides a path to start working with the DL stack. Let’s begin with the easiest and most straightforward options.


The easiest way to get started is to use the latest PyPI ngraph-tensorflow-bridge, which has instructions for Linux* systems, and tips for users of Mac OS X.

You can install TensorFlow and nGraph in a virtual environment; otherwise, the code will install to a system location.

pip install --upgrade pip==19.3.1
pip install tensorflow
pip install ngraph-tensorflow-bridge


You may need to use the latest versions of tensorflow and the bridge to get pip installs to work. See the TensorFlow* file for more detail about working with TensorFlow*.

That’s it! Now you can test the installation by running the following command:

python -c "import tensorflow as tf; print('TensorFlow version: ',tf.__version__);import ngraph_bridge; print(ngraph_bridge.__version__)"

Output will look something like:

TensorFlow version:  [version]
nGraph bridge version: b'[version]'
nGraph version used for this build: b'[version-rc-hash]'
TensorFlow version used for this build: v[version-hash]
CXX11_ABI flag used for this build: boolean

More detail in the ngraph_bridge examples directory.

See also the diagnostic tools.


Another easy way to get started working with the DL stack is to try the examples available via nGraph ONNX.

To prepare your environment to use nGraph and ONNX, install the Python packages for nGraph, ONNX and NumPy:

$ pip install ngraph-core onnx numpy

Now you can start exploring some of the ONNX examples.

See also nGraph’s Python API.