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

For license see: https://github.com/mlgym/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.61.tar.gz (45.1 kB view details)

Uploaded Source

Built Distribution

mlgym-0.0.61-py3-none-any.whl (64.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mlgym-0.0.61.tar.gz
  • Upload date:
  • Size: 45.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.13

File hashes

Hashes for mlgym-0.0.61.tar.gz
Algorithm Hash digest
SHA256 d06003e46abd6b7892aff3a2b6ba886f7adc62806c35a9094d97c5b64be08c08
MD5 60ce8bcbb2fb3f2d07704a89f3eae683
BLAKE2b-256 4aada91e6e09aa3a063f492ff6f23c93d136b3c6d59e6b14c7b52113adca5deb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mlgym-0.0.61-py3-none-any.whl
  • Upload date:
  • Size: 64.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.13

File hashes

Hashes for mlgym-0.0.61-py3-none-any.whl
Algorithm Hash digest
SHA256 fdbf30145529be320c04f3d4f9203e99c9ddb66b25b4f24c6d9bc5344c3ed5b9
MD5 7c757749711798307f484280ab451758
BLAKE2b-256 56879341ad1e7edec580bf7929a740d0eec78fef9182e50435ebbe0d2be4ba73

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