Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 2 KB

install.md

File metadata and controls

67 lines (45 loc) · 2 KB

Installation Options and Troubleshooting

Prerequisites

  • python: required; MMS works with Python 2 or 3; you may also want to use a Python/Conda environment when installing MMS, so it doesn't conflict with your other MXNet or ONNX installations.
  • protoc: optional; if you plan to use the ONNX features, you will need to have the protobuf compiler installed. Install this before installing MMS.
  • curl: optional; it's used in all of the examples, so install it via your package manager of choice.
  • unzip: optional; it's nice to have and to associate with .model extensions, so you can easily extract model files and inspect their contents.

Install with pip

Make sure you have Python installed, then run:

pip install mxnet-model-server

If you're upgrading from a previous version of MMS, use the following:

pip install -U mxnet-model-server

Install from Source

Alternatively, you may clone MMS from source:

git clone https://github.com/awslabs/mxnet-model-server.git && cd mxnet-model-server

Then using the following will install from source:

pip install .

Or use the following to upgrade from source:

pip install -U .

Development Installation

If you plan to develop with MMS and change some of the source, then use the -e option. Then using the following will install from source and make your changes executable:

pip install -e .

Or use the following to upgrade from source and make your changes executable:

pip install -U -e .

Installation Troubleshooting

Issue Platform Solution
Could not find "protoc" executable! Ubuntu: sudo apt-get install protobuf-compiler libprotoc-dev
MacOS: conda install -c conda-forge protobuf
Missing LibGFortran library Ubuntu: apt-get install libgfortran3
Amazon Linux: yum install gcc-gfortran