Skip to main content

Python library for retrieving models from Faculty platform.

Project description

faculty-models is a tool to help you use models from the model registry in Faculty Platform.

Warning

This library’s API is subject to change as new functionality is added to the model registry feature in Faculty Platform.

Installation

faculty-models comes preinstalled in Python environments available in Faculty platform. To use it externally, install it from PyPI with pip:

pip install faculty-models

If you’ve not already done so on the computer you’re using, you’ll also need to generate and store CLI credentials for the Platform. You can do this with the Faculty CLI.

Usage

The model registry in Faculty Platform includes a feature that helps you generate the snippets you need. It will help you get the project and model IDs you need to use faculty-models.

If your model is in the MLmodel format (likely because you used MLflow to store it), you can load it directly back into Python with:

import faculty_models

model = faculty_models.load_mlmodel(
    project_id="998328c3-23df-4225-a3ee-0a53d1409fbd",
    model_id="c998fca9-e093-47ea-9896-8f75db695b91"
)

Otherwise, you can use the following to download the contents of the model to the local filesystem. download returns the path of the downloaded model files:

import faculty_models

path = faculty_models.download(
    project_id="998328c3-23df-4225-a3ee-0a53d1409fbd",
    model_id="c998fca9-e093-47ea-9896-8f75db695b91"
)

The above examples always download the latest version of a model. To get a specific verion, pass the version number when calling either function:

import faculty_models

model = faculty_models.load_mlmodel(
    project_id="998328c3-23df-4225-a3ee-0a53d1409fbd",
    model_id="c998fca9-e093-47ea-9896-8f75db695b91",
    version=4
)

If you only wish to download part of the model, or if you wish to load an MLmodel that is in a subdirectory of the model, pass the path argument to either function:

import faculty_models

model = faculty_models.load_mlmodel(
    project_id="998328c3-23df-4225-a3ee-0a53d1409fbd",
    model_id="c998fca9-e093-47ea-9896-8f75db695b91",
    path="sub/path"
)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for faculty-models, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size faculty_models-0.1.1-py2.py3-none-any.whl (7.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size faculty-models-0.1.1.tar.gz (8.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page