Edit on GitHub


Apply provided model against provided data.

def apply_remote(
    client: Union[str, Client],
    *data: Union[str, MlemData, Any],
    method: str = None,
    output: str = None,
    target_project: str = None,
) -> Optional[Any]


from mlem.api import apply_remote

res = apply_remote(client_obj, data, method="predict")


This API is the underlying mechanism for the mlem apply-remote command and facilitates running inferences on entire datasets for models which are deployed remotely or are being served locally. The API requires an explicit client object, which knows how to make requests to the deployed model.


  • client (required) - The client to access methods of deployed model.
  • data (required) - Input to the model.
  • method (required) - Which model method to use.If None, use the only method model has.If more than one is available, will fail.
  • output (optional) - If value is provided,assume it's path and save output there.
  • target_project (optional) - Path to MLEM project to save the result to.
  • **client_kwargs (optional) - Additional arguments to pass to client.


If output=None, returns results for given data. Otherwise returns None.


  • WrongMethodError - Thrown if wrong method name for model is provided
  • InvalidArgumentError - Thrown if arguments are invalid, when method cannot be None
  • NotImplementedError - Saving several input data objects is not implemented yet


from numpy import ndarray
from sklearn.datasets import load_iris
from mlem.api import apply_remote
from mlem.runtime.client import HTTPClient

train, _ = load_iris(return_X_y=True)
client = HTTPClient(host="", port=8080)

res = apply_remote(client, train, method="predict")
assert isinstance(res, ndarray)

­čÉŤ Found an issue? Let us know! Or fix it:

Edit on GitHub

ÔŁô Have a question? Join our chat, we will help you:

Discord Chat