Skip to main content

A minimum-lovable machine-learning pipeline, built on top of AWS SageMaker.

Project description

ML2P – or (ML)^2P – is the minimal lovable machine-learning pipeline and a friendlier interface to AWS SageMaker.

Design goals:

  • support the full machine learning lifecyle

  • support custom feature engineering

  • support building custom models in Python

  • provide reproducible training and deployment of models

  • support the use of customised base Docker images for training and deployment

Concretely it provides a command line interface and a Python library to assist with:

  • S3:
    • Managing training data

  • SageMaker:
    • Launching training jobs

    • Deploying trained models

    • Creating notebook instances

  • On your local machine or in a SageMaker notebook:
    • Downloading training datasets from S3

    • Training models

    • Loading trained models from SageMaker / S3

Installing

Install ML2P with:

$ pip install ml2p

Mailing list

If you have questions about ML2P, or would like to contribute or have suggestions for improvements, you are welcome to join the project mailing list at https://groups.google.com/g/ml2p and write us a letter there.

Overview

ML2P helps manage a machine learning project. You’ll define your project by writing a small YAML file named ml2p.yml:

project: "ml2p-tutorial"
s3folder: "s3://your-s3-bucket/"
models:
  bob: "models.RegressorModel"
defaults:
  image: "XXXXX.dkr.ecr.REGION.amazonaws.com/your-docker-image:X.Y.Z"
  role: "arn:aws:iam::XXXXX:role/your-role"
train:
  instance_type: "ml.m5.large"
deploy:
  instance_type: "ml.t2.medium"
  record_invokes: true

This specifies:

  • project: the name of your project

  • s3folder: the S3 bucket that will hold the models and data sets for your project

  • models: a list of model names and the Python classes that will be used to train the models and make predictions

  • defaults:

    • image: the docker image that your project will use for training and prediction

    • role: the AWS role your project will run under

  • train:

    • instance_type: the AWS instance type that will be used when training your model

  • deploy:

    • instance_type: the AWS instance type that will be used when deploying your model

    • record_invokes: whether to record prediction requests in S3

The name of your project functions as a prefix to the names of SageMaker training jobs, models and endpoints that ML2P creates (since these names are global within a SageMaker account).

ML2P also tags all of the AWS objects it creates with your project name.

Tutorial

See https://ml2p.readthedocs.io/en/latest/tutorial/ for a step-by-step tutorial.

Project details


Download files

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

Source Distribution

ml2p-0.2.4.tar.gz (37.8 kB view details)

Uploaded Source

Built Distribution

ml2p-0.2.4-py2.py3-none-any.whl (40.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ml2p-0.2.4.tar.gz.

File metadata

  • Download URL: ml2p-0.2.4.tar.gz
  • Upload date:
  • Size: 37.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for ml2p-0.2.4.tar.gz
Algorithm Hash digest
SHA256 87907af37db90ac016d1a60bee5f675b44586498baa89ff5bf893703b97205b8
MD5 74aa1fb5a22214ea1051c0635a20c162
BLAKE2b-256 946e85dfea30acd5995016b721f94691715b2844eecc53a1c918e99bdc504105

See more details on using hashes here.

File details

Details for the file ml2p-0.2.4-py2.py3-none-any.whl.

File metadata

  • Download URL: ml2p-0.2.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 40.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for ml2p-0.2.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 06df141301c57d9399d8fce3f1119f1fd5f09761d18ef2ead28e363e551c424d
MD5 c7cb21b4256a4a0cddb97f0803758ded
BLAKE2b-256 7accab2863323876d831aa92cc84b0b5312415af0bb4178be240640c4412ecf6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page