Installing MXNet on Amazon Linux

For users of Python on Amazon Linux operating systems, MXNet provides a set of Git Bash scripts that installs all of the required MXNet dependencies and the MXNet library.

The simple installation scripts set up MXNet for Python on computers running Amazon Linux. The scripts install MXNet in your home folder ~/mxnet.

Quick Installation

Install MXNet for Python

To clone the MXNet source code repository to your computer, use git.

  # Install git if not already installed.
  sudo yum -y install git-all

Clone the MXNet source code repository to your computer, run the installation script, and refresh the environment variables. In addition to installing MXNet, the script installs all MXNet dependencies: Numpy, OpenBLAS and OpenCV. It takes around 5 minutes to complete the installation.

  # Clone mxnet repository. In terminal, run the commands WITHOUT "sudo"
  git clone ~/mxnet --recursive

  # Install MXNet for Python with all required dependencies
  cd ~/mxnet/setup-utils

  # We have added MXNet Python package path in your ~/.bashrc.
  # Run the following command to refresh environment variables.
  $ source ~/.bashrc

You can view the installation script here. If you are unable to install MXNet with the Bash script, see the following detailed installation instructions.

Standard installation

Installing MXNet is a two-step process:

  1. Build the shared library from the MXNet C++ source code.
  2. Install the supported language-specific packages for MXNet.

Note: To change the compilation options for your build, edit the make/ file and submit a build request with the make command.

Build the Shared Library

On Amazon Linux, you need the following dependencies:

  • Git (to pull code from GitHub)
  • libatlas-base-dev (for linear algebraic operations)
  • libopencv-dev (for computer vision operations)

Install these dependencies using the following commands:

      # CMake is required for installing dependencies.
      sudo yum install -y cmake

      # Set appropriate library path env variables
      echo 'export PATH=/usr/local/bin:$PATH' >> ~/.profile
      echo 'export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH' >> ~/.profile
      echo 'export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH' >> ~/.profile
      echo '. ~/.profile' >> ~/.bashrc
      source ~/.profile

      # Install gcc-4.8/make and other development tools on Amazon Linux
      # Reference:
      # Install Python, Numpy, Scipy and set up tools.
      sudo yum groupinstall -y "Development Tools"
      sudo yum install -y python27 python27-setuptools python27-tools python-pip
      sudo yum install -y python27-numpy python27-scipy python27-nose python27-matplotlib graphviz

      # Install OpenBLAS at /usr/local/openblas
      git clone
      cd OpenBLAS
      make FC=gfortran -j $(($(nproc) + 1))
      sudo make PREFIX=/usr/local install
      cd ..

      # Install OpenCV at /usr/local/opencv
      git clone
      cd opencv
      mkdir -p build
      cd build
      sudo make PREFIX=/usr/local install

      # Install Graphviz for visualization and Jupyter notebook for running examples and tutorials
      sudo pip install graphviz
      sudo pip install jupyter

      # Export env variables for pkg config
      export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH

After installing the dependencies, use the following command to pull the MXNet source code from GitHub

    # Get MXNet source code
    git clone ~/mxnet --recursive
    # Move to source code parent directory
    cd ~/mxnet
    cp make/ .
    echo "USE_BLAS=openblas" >>
    echo "ADD_CFLAGS += -I/usr/include/openblas" >>
    echo "ADD_LDFLAGS += -lopencv_core -lopencv_imgproc -lopencv_imgcodecs" >>

If building with GPU support, run below commands to add GPU dependency configurations to file:

    echo "USE_CUDA=1" >>
    echo "USE_CUDA_PATH=/usr/local/cuda" >>
    echo "USE_CUDNN=1" >>

Then build mxnet:

    make -j$(nproc)

Executing these commands creates a library called

We have installed MXNet core library. Next, we will install MXNet interface package for the programming language of your choice:

Install the MXNet Package for Python

Next, we install Python interface for MXNet. Assuming you are in ~/mxnet directory, run below commands.

    # Install MXNet Python package
    cd python
    sudo python install

Check if MXNet is properly installed.

    # You can change mx.cpu to mx.gpu
    >>> import mxnet as mx
    >>> a = mx.nd.ones((2, 3), mx.cpu())
    >>> print ((a * 2).asnumpy())
    [[ 2.  2.  2.]
     [ 2.  2.  2.]]

If you don’t get an import error, then MXNet is ready for python.

Note: You can update mxnet for python by repeating this step after re-building

Install the MXNet Package for R

Run the following commands to install the MXNet dependencies and build the MXNet R package.

  Rscript -e "install.packages('devtools', repo = '')"
  cd R-package
  Rscript -e "library(devtools); library(methods); options(repos=c(CRAN='')); install_deps(dependencies = TRUE)"
  cd ..
  make rpkg

Note: R-package is a folder in the MXNet source.

These commands create the MXNet R package as a tar.gz file that you can install as an R package. To install the R package, run the following command, use your MXNet version number:

  R CMD INSTALL mxnet_current_r.tar.gz

Install the MXNet Package for Julia

The MXNet package for Julia is hosted in a separate repository, MXNet.jl, which is available on GitHub. To use Julia binding it with an existing libmxnet installation, set the MXNET_HOME environment variable by running the following command:

  export MXNET_HOME=/<path to>/libmxnet

The path to the existing libmxnet installation should be the root directory of libmxnet. In other words, you should be able to find the file at $MXNET_HOME/lib. For example, if the root directory of libmxnet is ~, you would run the following command:

  export MXNET_HOME=/~/libmxnet

You might want to add this command to your ~/.bashrc file. If you do, you can install the Julia package in the Julia console using the following command:


For more details about installing and using MXNet with Julia, see the MXNet Julia documentation.

Install the MXNet Package for Scala

There are two ways to install the MXNet package for Scala:

  • Use the prebuilt binary package
  • Build the library from source code

Use the Prebuilt Binary Package

For Linux users, MXNet provides prebuilt binary packages that support computers with either GPU or CPU processors. To download and build these packages using Maven, change the artifactId in the following Maven dependency to match your architecture:

  <artifactId>mxnet-full_<system architecture></artifactId>

For example, to download and build the 64-bit CPU-only version for Linux, use:


If your native environment differs slightly from the assembly package, for example, if you use the openblas package instead of the atlas package, it’s better to use the mxnet-core package and put the compiled Java native library in your load path:


Build the Library from Source Code

Before you build MXNet for Scala from source code, you must complete building the shared library. After you build the shared library, run the following command from the MXNet source root directory to build the MXNet Scala package:

  make scalapkg

This command creates the JAR files for the assembly, core, and example modules. It also creates the native library in the native/{your-architecture}/target directory, which you can use to cooperate with the core module.

To install the MXNet Scala package into your local Maven repository, run the following command from the MXNet source root directory:

  make scalainstall

Install the MXNet Package for Perl

Before you build MXNet for Scala from source code, you must complete building the shared library. After you build the shared library, run the following command from the MXNet source root directory to build the MXNet Scala package:

    ## install PDL, Graphviz, Mouse, App::cpanminus, swig via yum before running these commands
    cpanm -q -L "${HOME}/perl5" Function::Parameters

    export LD_LIBRARY_PATH=${MXNET_HOME}/lib
    export PERL5LIB=${HOME}/perl5/lib/perl5

    cd ${MXNET_HOME}/perl-package/AI-MXNetCAPI/
    perl Makefile.PL INSTALL_BASE=${HOME}/perl5
    make install

    cd ${MXNET_HOME}/perl-package/AI-NNVMCAPI/
    perl Makefile.PL INSTALL_BASE=${HOME}/perl5
    make install

    cd ${MXNET_HOME}/perl-package/AI-MXNet/
    perl Makefile.PL INSTALL_BASE=${HOME}/perl5
    make install

**Note - ** You are more than welcome to contribute easy installation scripts for other operating systems and programming languages, see community page for contributors guidelines.