Skip to main content

MLgym, a python framework for distributed machine learning model training in research.

Project description

mlGym_logo

MLgym

a python framework for distributed machine learning model training in research.

CircleCI

At its core, MLgym offers functionality to run gridsearches of Pytorch models at scale split over multiple GPUs and centrally store the results using DashifyML.

Futhermore, MLgym provides the following key features:

  • Reproducibility of results due to full experiment specification including dataset, preprocessing routines, model architecture, loss function, metrics and more within a single YAML config.

  • Component registry to register custom components with dependencies. For instance one can define a new preprocessing routine component. This component may depend on an iterator component, as specified in the experiment config. During runtime these components are instantiated on the fly.

  • Resume training after crash

  • Custom training routines, e.g., training with partially frozen network weights

  • Large scale, multi GPU training supporting Grid Search, Nested Cross Validation, Cross Validation

  • Reduced logging to reduce storage footprint of model and optimizer states

Please note, that at the moment this code should be treated as experimental and is not production ready.

Install

there are two options to install MLgym, the easiest way is to install it from the pip repository:

pip install mlgym

For the latest version, one can directly install it from source by cd into the root folder and then running

pip install src/

Usage

NOTE: This framework is still under heavy development and mainly used in research projects. It's most likely not free of bugs and interfaces can still change.

For usage see this example.

Copyright

Copyright (c) 2020 Max Lübbering, Rajkumar Ramamurthy

For license see: https://github.com/le1nux/mlgym/blob/master/LICENSE

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

mlgym-0.0.54.tar.gz (43.7 kB view details)

Uploaded Source

Built Distribution

mlgym-0.0.54-py3-none-any.whl (63.0 kB view details)

Uploaded Python 3

File details

Details for the file mlgym-0.0.54.tar.gz.

File metadata

  • Download URL: mlgym-0.0.54.tar.gz
  • Upload date:
  • Size: 43.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for mlgym-0.0.54.tar.gz
Algorithm Hash digest
SHA256 120cd9e00b953cb463e47dd82e251b66e9e06958036a61c6167a6b55136289fa
MD5 24511352ef34f052469f1221a1618b04
BLAKE2b-256 49826905810c59e2e672e92cd2f1f754ea2975ada42e54eda5d5febc3e29b416

See more details on using hashes here.

File details

Details for the file mlgym-0.0.54-py3-none-any.whl.

File metadata

  • Download URL: mlgym-0.0.54-py3-none-any.whl
  • Upload date:
  • Size: 63.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for mlgym-0.0.54-py3-none-any.whl
Algorithm Hash digest
SHA256 7a014b61093d72b9e08d4eb2d07591cd104e217358c71c6b6e8988f7691ca04c
MD5 0bfed8af38ae8e566a992d0eb385cc1f
BLAKE2b-256 5551f6ffaf651d61d3a42eb031923ddfb061b0c1d1dcb514fec70411fe159fbd

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