openvino/docs/model_server/README.md

OpenVINO™ Model Server

OpenVINO™ Model Server (OVMS) is a scalable, high-performance solution for serving machine learning models optimized for Intel® architectures. The server provides an inference service via gRPC or REST API - making it easy to deploy new algorithms and AI experiments using the same architecture as TensorFlow* Serving for any models trained in a framework that is supported by OpenVINO.

The server implements gRPC and REST API framework with data serialization and deserialization using TensorFlow Serving API, and OpenVINO™ as the inference execution provider. Model repositories may reside on a locally accessible file system (for example, NFS), Google Cloud Storage* (GCS), Amazon S3*, MinIO*, or Azure Blob Storage*.

OVMS is now implemented in C++ and provides much higher scalability compared to its predecessor in the Python version. You can take advantage of all the power of Xeon® CPU capabilities or AI accelerators and expose it over the network interface. Read the release notes to find out what's new in the C++ version.

Review the Architecture Concept document for more details.

A few key features:

• Support for multiple frameworks. Serve models trained in popular formats such as Caffe*, TensorFlow*, MXNet*, and ONNX*.
• Deploy new model versions without changing client code.
• Support for AI accelerators including Intel Movidius Myriad VPUs, GPU, and HDDL.
• The server can be enabled both on Bare Metal Hosts or in Docker* containers.
• Kubernetes deployments. The server can be deployed in a Kubernetes cluster allowing the inference service to scale horizontally and ensure high availability.
• Model reshaping. The server supports reshaping models in runtime.
• Model ensemble (preview). Connect multiple models to deploy complex processing solutions and reduce overhead of sending data back and forth.

Note

: OVMS has been tested on CentOS* and Ubuntu*. Publicly released Docker images are based on CentOS.

Build OpenVINO Model Server

1. Go to the root directory of the repository.

2. Build the Docker image with the command below:

make docker_build

The command generates:

• Image tagged as openvino/model_server:latest with CPU, NCS, and HDDL support
• Image tagged as openvino/model_server:latest-gpu with CPU, NCS, HDDL, and iGPU support
• .tar.gz release package with OVMS binary and necessary libraries in the ./dist directory.

The release package is compatible with Linux machines on which glibc version is greater than or equal to the build image version. For debugging, the command also generates an image with a suffix -build, namely openvino/model_server-build:latest.

Note

: Images include OpenVINO 2021.1 release.

Run OpenVINO Model Server

Find a detailed description of how to use the OpenVINO Model Server in the OVMS Quick Start Guide.

For more detailed guides on using the Model Server in various scenarios, visit the links below:

• Models repository configuration

• Using a Docker container

• Landing on bare metal or virtual machine

• Performance tuning

• Model Ensemble Scheduler

API Documentation

GRPC

OpenVINO™ Model Server gRPC API is documented in the proto buffer files in tensorflow_serving_api.

Note

: The implementations for Predict, GetModelMetadata, and GetModelStatus function calls are currently available. These are the most generic function calls and should address most of the usage scenarios.

Predict proto defines two message specifications: PredictRequest and PredictResponse used while calling Prediction endpoint.

• PredictRequest specifies information about the model spec, that is name and version, and a map of input data serialized via TensorProto to a string format.
• PredictResponse includes a map of outputs serialized by TensorProto and information about the used model spec.

Get Model Metadata proto defines three message definitions used while calling Metadata endpoint: SignatureDefMap, GetModelMetadataRequest, GetModelMetadataResponse.

A function call GetModelMetadata accepts model spec information as input and returns Signature Definition content in the format similar to TensorFlow Serving.

Get Model Status proto defines three message definitions used while calling Status endpoint: GetModelStatusRequest, ModelVersionStatus, GetModelStatusResponse that report all exposed versions including their state in their lifecycle.

Refer to the example client code to learn how to use this API and submit the requests using the gRPC interface.

Using the gRPC interface is recommended for optimal performance due to its faster implementation of input data deserialization. It enables you to achieve lower latency, especially with larger input messages like images.

REST

OpenVINO™ Model Server RESTful API follows the documentation from the TensorFlow Serving REST API.

Both row and column format of the requests are implemented.

Note

: Just like with gRPC, only the implementations for Predict, GetModelMetadata, and GetModelStatus function calls are currently available.

Only the numerical data types are supported.

Review the exemplary clients below to find out more how to connect and run inference requests.

REST API is recommended when the primary goal is in reducing the number of client side Python dependencies and simpler application code.

Known Limitations

• Currently, Predict, GetModelMetadata, and GetModelStatus calls are implemented using the TensorFlow Serving API.
• Classify, Regress, and MultiInference are not included.
• Output_filter is not effective in the Predict call. All outputs defined in the model are returned to the clients.

OpenVINO Model Server Contribution Policy

• All contributed code must be compatible with the Apache 2 license.

• All changes have to pass linter, unit, and functional tests.

• All new features need to be covered by tests.

References

• Speed and Scale AI Inference Operations Across Multiple Architectures - webinar recording

• OpenVINO™

• TensorFlow Serving

• gRPC

• RESTful API

• Inference at Scale in Kubernetes

---

* Other names and brands may be claimed as the property of others.