=============================================
MLflow: A Machine Learning Lifecycle Platform
=============================================
MLflow is a platform to streamline machine learning development, including tracking experiments, packaging code
into reproducible runs, and sharing and deploying models. MLflow offers a set of lightweight APIs that can be
used with any existing machine learning application or library (TensorFlow, PyTorch, XGBoost, etc), wherever you
currently run ML code (e.g. in notebooks, standalone applications or the cloud). MLflow's current components are:
* `MLflow Tracking <https://mlflow.org/docs/latest/tracking.html>`_: An API to log parameters, code, and
results in machine learning experiments and compare them using an interactive UI.
* `MLflow Projects <https://mlflow.org/docs/latest/projects.html>`_: A code packaging format for reproducible
runs using Conda and Docker, so you can share your ML code with others.
* `MLflow Models <https://mlflow.org/docs/latest/models.html>`_: A model packaging format and tools that let
you easily deploy the same model (from any ML library) to batch and real-time scoring on platforms such as
Docker, Apache Spark, Azure ML and AWS SageMaker.
* `MLflow Model Registry <https://mlflow.org/docs/latest/model-registry.html>`_: A centralized model store, set of APIs, and UI, to collaboratively manage the full lifecycle of MLflow Models.
|docs| |pypi| |conda-forge| |cran| |maven| |license| |downloads| |slack| |twitter|
.. |docs| image:: https://img.shields.io/badge/docs-latest-success.svg?style=for-the-badge
:target: https://mlflow.org/docs/latest/index.html
:alt: Latest Docs
.. |pypi| image:: https://img.shields.io/pypi/v/mlflow.svg?style=for-the-badge&logo=pypi&logoColor=white
:target: https://pypi.org/project/mlflow/
:alt: Latest Python Release
.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/mlflow.svg?style=for-the-badge&logo=anaconda
:target: https://anaconda.org/conda-forge/mlflow
:alt: Latest Conda Release
.. |cran| image:: https://img.shields.io/cran/v/mlflow.svg?style=for-the-badge&logo=r
:target: https://cran.r-project.org/package=mlflow
:alt: Latest CRAN Release
.. |maven| image:: https://img.shields.io/maven-central/v/org.mlflow/mlflow-parent.svg?style=for-the-badge&logo=apache-maven
:target: https://mvnrepository.com/artifact/org.mlflow
:alt: Maven Central
.. |license| image:: https://img.shields.io/badge/license-Apache%202-brightgreen.svg?style=for-the-badge&logo=apache
:target: https://github.com/mlflow/mlflow/blob/master/LICENSE.txt
:alt: Apache 2 License
.. |downloads| image:: https://img.shields.io/pypi/dw/mlflow?style=for-the-badge&logo=pypi&logoColor=white
:target: https://pepy.tech/project/mlflow
:alt: Total Downloads
.. |slack| image:: https://img.shields.io/badge/slack-@mlflow--users-CF0E5B.svg?logo=slack&logoColor=white&labelColor=3F0E40&style=for-the-badge
:target: `Slack`_
:alt: Slack
.. |twitter| image:: https://img.shields.io/twitter/follow/MLflow?style=for-the-badge&labelColor=00ACEE&logo=twitter&logoColor=white
:target: https://twitter.com/MLflow
:alt: Account Twitter
.. _Slack: https://join.slack.com/t/mlflow-users/shared_invite/zt-1iffrtbly-UNU8hV03aV8feUeGmqf_uA
Job Statuses
|examples| |cross-version-tests| |r-devel| |test-requirements| |stale| |push-images|
.. |examples| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/examples.yml?branch=master&event=schedule&label=Examples&style=for-the-badge&logo=github
:target: https://github.com/mlflow-automation/mlflow/actions/workflows/examples.yml?query=workflow%3AExamples+event%3Aschedule
:alt: Examples Action Status
.. |cross-version-tests| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/cross-version-tests.yml?branch=master&event=schedule&label=Cross%20version%20tests&style=for-the-badge&logo=github
:target: https://github.com/mlflow-automation/mlflow/actions/workflows/cross-version-tests.yml?query=workflow%3A%22Cross+version+tests%22+event%3Aschedule
.. |r-devel| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/r.yml?branch=master&event=schedule&label=r-devel&style=for-the-badge&logo=github
:target: https://github.com/mlflow-automation/mlflow/actions/workflows/r.yml?query=workflow%3AR+event%3Aschedule
.. |test-requirements| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/requirements.yml?branch=master&event=schedule&label=test%20requirements&logo=github&style=for-the-badge
:target: https://github.com/mlflow-automation/mlflow/actions/workflows/requirements.yml?query=workflow%3A"Test+requirements"+event%3Aschedule
.. |stale| image:: https://img.shields.io/github/actions/workflow/status/mlflow/mlflow/stale.yml?branch=master&event=schedule&label=stale&logo=github&style=for-the-badge
:target: https://github.com/mlflow/mlflow/actions?query=workflow%3AStale+event%3Aschedule
.. |push-images| image:: https://img.shields.io/github/actions/workflow/status/mlflow/mlflow/push-images.yml?event=release&label=push-images&logo=github&style=for-the-badge
:target: https://github.com/mlflow/mlflow/actions/workflows/push-images.yml?query=event%3Arelease
Installing
----------
Install MLflow from PyPI via ``pip install mlflow``
MLflow requires ``conda`` to be on the ``PATH`` for the projects feature.
Nightly snapshots of MLflow master are also available `here <https://mlflow-snapshots.s3-us-west-2.amazonaws.com/>`_.
Install a lower dependency subset of MLflow from PyPI via ``pip install mlflow-skinny``
Extra dependencies can be added per desired scenario.
For example, ``pip install mlflow-skinny pandas numpy`` allows for mlflow.pyfunc.log_model support.
Documentation
-------------
Official documentation for MLflow can be found at https://mlflow.org/docs/latest/index.html.
Roadmap
-------
The current MLflow Roadmap is available at https://github.com/mlflow/mlflow/milestone/3. We are
seeking contributions to all of our roadmap items with the ``help wanted`` label. Please see the
`Contributing`_ section for more information.
Community
---------
For help or questions about MLflow usage (e.g. "how do I do X?") see the `docs <https://mlflow.org/docs/latest/index.html>`_
or `Stack Overflow <https://stackoverflow.com/questions/tagged/mlflow>`_.
To report a bug, file a documentation issue, or submit a feature request, please open a GitHub issue.
For release announcements and other discussions, please subscribe to our mailing list (mlflow-users@googlegroups.com)
or join us on `Slack`_.
Running a Sample App With the Tracking API
------------------------------------------
The programs in ``examples`` use the MLflow Tracking API. For instance, run::
python examples/quickstart/mlflow_tracking.py
This program will use `MLflow Tracking API <https://mlflow.org/docs/latest/tracking.html>`_,
which logs tracking data in ``./mlruns``. This can then be viewed with the Tracking UI.
Launching the Tracking UI
-------------------------
The MLflow Tracking UI will show runs logged in ``./mlruns`` at `<http://localhost:5000>`_.
Start it with::
mlflow ui
**Note:** Running ``mlflow ui`` from within a clone of MLflow is not recommended - doing so will
run the dev UI from source. We recommend running the UI from a different working directory,
specifying a backend store via the ``--backend-store-uri`` option. Alternatively, see
instructions for running the dev UI in the `contributor guide <CONTRIBUTING.md>`_.
Running a Project from a URI
----------------------------
The ``mlflow run`` command lets you run a project packaged with a MLproject file from a local path
or a Git URI::
mlflow run examples/sklearn_elasticnet_wine -P alpha=0.4
mlflow run https://github.com/mlflow/mlflow-example.git -P alpha=0.4
See ``examples/sklearn_elasticnet_wine`` for a sample project with an MLproject file.
Saving and Serving Models
-------------------------
To illustrate managing models, the ``mlflow.sklearn`` package can log scikit-learn models as
MLflow artifacts and then load them again for serving. There is an example training application in
``examples/sklearn_logistic_regression/train.py`` that you can run as follows::
$ python examples/sklearn_logistic_regression/train.py
Score: 0.666
Model saved in run <run-id>
$ mlflow models serve --model-uri runs:/<run-id>/model
$ curl -d '{"dataframe_split": {"columns":[0],"index":[0,1],"data":[[1],[-1]]}}' -H 'Content-Type: application/json' localhost:5000/invocations
**Note:** If using MLflow skinny (``pip install mlflow-skinny``) for model serving, additional
required dependencies (namely, ``flask``) will need to be installed for the MLflow server to function.
Official MLflow Docker Image
----------------------------
The official MLflow Docker image is available on GitHub Container Registry at https://ghcr.io/mlflow/mlflow.
.. code-block:: shell
export CR_PAT=YOUR_TOKEN
echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
# Pull the latest version
docker pull ghcr.io/mlflow/mlflow
# Pull 2.2.1
docker pull ghcr.io/mlflow/mlflow:v2.2.1
Contributing
------------
We happily welcome contributions to MLflow. We are also seeking contributions to items on the
`MLflow Roadmap <https://github.com/mlflow/mlflow/milestone/3>`_. Please see our
`contribution guide <CONTRIBUTING.md>`_ to learn more about contributing to MLflow.
Core Members
------------
MLflow is currently maintained by the following core members with significant contributions from hundreds of exceptionally talented community members.
- `Harutaka Kawamura <https://github.com/harupy>`_
- `Weichen Xu <https://github.com/WeichenXu123>`_
- `Corey Zumar <https://github.com/dbczumar>`_
- `Ben Wilson <https://github.com/BenWilson2>`_
- `Serena Ruan <https://github.com/serena-ruan>`_
- `Gabriel Fu <https://github.com/gabrielfu>`_
Raw data
{
"_id": null,
"home_page": "https://mlflow.org/",
"name": "mlflow-by-johnsnowlabs",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "ml ai databricks",
"author": "Databricks",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/05/cf/966bc4fc99ade3a5d40e8a3deb13f3ccac5aa4198e953aaa6edf285735ce/mlflow_by_johnsnowlabs-2.40.0.tar.gz",
"platform": null,
"description": "=============================================\nMLflow: A Machine Learning Lifecycle Platform\n=============================================\n\nMLflow is a platform to streamline machine learning development, including tracking experiments, packaging code\ninto reproducible runs, and sharing and deploying models. MLflow offers a set of lightweight APIs that can be\nused with any existing machine learning application or library (TensorFlow, PyTorch, XGBoost, etc), wherever you\ncurrently run ML code (e.g. in notebooks, standalone applications or the cloud). MLflow's current components are:\n\n* `MLflow Tracking <https://mlflow.org/docs/latest/tracking.html>`_: An API to log parameters, code, and\n results in machine learning experiments and compare them using an interactive UI.\n* `MLflow Projects <https://mlflow.org/docs/latest/projects.html>`_: A code packaging format for reproducible\n runs using Conda and Docker, so you can share your ML code with others.\n* `MLflow Models <https://mlflow.org/docs/latest/models.html>`_: A model packaging format and tools that let\n you easily deploy the same model (from any ML library) to batch and real-time scoring on platforms such as\n Docker, Apache Spark, Azure ML and AWS SageMaker.\n* `MLflow Model Registry <https://mlflow.org/docs/latest/model-registry.html>`_: A centralized model store, set of APIs, and UI, to collaboratively manage the full lifecycle of MLflow Models.\n\n|docs| |pypi| |conda-forge| |cran| |maven| |license| |downloads| |slack| |twitter|\n\n.. |docs| image:: https://img.shields.io/badge/docs-latest-success.svg?style=for-the-badge\n :target: https://mlflow.org/docs/latest/index.html\n :alt: Latest Docs\n.. |pypi| image:: https://img.shields.io/pypi/v/mlflow.svg?style=for-the-badge&logo=pypi&logoColor=white\n :target: https://pypi.org/project/mlflow/\n :alt: Latest Python Release\n.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/mlflow.svg?style=for-the-badge&logo=anaconda\n :target: https://anaconda.org/conda-forge/mlflow\n :alt: Latest Conda Release\n.. |cran| image:: https://img.shields.io/cran/v/mlflow.svg?style=for-the-badge&logo=r\n :target: https://cran.r-project.org/package=mlflow\n :alt: Latest CRAN Release\n.. |maven| image:: https://img.shields.io/maven-central/v/org.mlflow/mlflow-parent.svg?style=for-the-badge&logo=apache-maven\n :target: https://mvnrepository.com/artifact/org.mlflow\n :alt: Maven Central\n.. |license| image:: https://img.shields.io/badge/license-Apache%202-brightgreen.svg?style=for-the-badge&logo=apache\n :target: https://github.com/mlflow/mlflow/blob/master/LICENSE.txt\n :alt: Apache 2 License\n.. |downloads| image:: https://img.shields.io/pypi/dw/mlflow?style=for-the-badge&logo=pypi&logoColor=white\n :target: https://pepy.tech/project/mlflow\n :alt: Total Downloads\n.. |slack| image:: https://img.shields.io/badge/slack-@mlflow--users-CF0E5B.svg?logo=slack&logoColor=white&labelColor=3F0E40&style=for-the-badge\n :target: `Slack`_\n :alt: Slack\n.. |twitter| image:: https://img.shields.io/twitter/follow/MLflow?style=for-the-badge&labelColor=00ACEE&logo=twitter&logoColor=white\n :target: https://twitter.com/MLflow\n :alt: Account Twitter\n\n.. _Slack: https://join.slack.com/t/mlflow-users/shared_invite/zt-1iffrtbly-UNU8hV03aV8feUeGmqf_uA\n\nJob Statuses\n\n|examples| |cross-version-tests| |r-devel| |test-requirements| |stale| |push-images|\n\n.. |examples| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/examples.yml?branch=master&event=schedule&label=Examples&style=for-the-badge&logo=github\n :target: https://github.com/mlflow-automation/mlflow/actions/workflows/examples.yml?query=workflow%3AExamples+event%3Aschedule\n :alt: Examples Action Status\n.. |cross-version-tests| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/cross-version-tests.yml?branch=master&event=schedule&label=Cross%20version%20tests&style=for-the-badge&logo=github\n :target: https://github.com/mlflow-automation/mlflow/actions/workflows/cross-version-tests.yml?query=workflow%3A%22Cross+version+tests%22+event%3Aschedule\n.. |r-devel| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/r.yml?branch=master&event=schedule&label=r-devel&style=for-the-badge&logo=github\n :target: https://github.com/mlflow-automation/mlflow/actions/workflows/r.yml?query=workflow%3AR+event%3Aschedule\n.. |test-requirements| image:: https://img.shields.io/github/actions/workflow/status/mlflow-automation/mlflow/requirements.yml?branch=master&event=schedule&label=test%20requirements&logo=github&style=for-the-badge\n :target: https://github.com/mlflow-automation/mlflow/actions/workflows/requirements.yml?query=workflow%3A\"Test+requirements\"+event%3Aschedule\n.. |stale| image:: https://img.shields.io/github/actions/workflow/status/mlflow/mlflow/stale.yml?branch=master&event=schedule&label=stale&logo=github&style=for-the-badge\n :target: https://github.com/mlflow/mlflow/actions?query=workflow%3AStale+event%3Aschedule\n.. |push-images| image:: https://img.shields.io/github/actions/workflow/status/mlflow/mlflow/push-images.yml?event=release&label=push-images&logo=github&style=for-the-badge\n :target: https://github.com/mlflow/mlflow/actions/workflows/push-images.yml?query=event%3Arelease\n\nInstalling\n----------\nInstall MLflow from PyPI via ``pip install mlflow``\n\nMLflow requires ``conda`` to be on the ``PATH`` for the projects feature.\n\nNightly snapshots of MLflow master are also available `here <https://mlflow-snapshots.s3-us-west-2.amazonaws.com/>`_.\n\nInstall a lower dependency subset of MLflow from PyPI via ``pip install mlflow-skinny``\nExtra dependencies can be added per desired scenario.\nFor example, ``pip install mlflow-skinny pandas numpy`` allows for mlflow.pyfunc.log_model support.\n\nDocumentation\n-------------\nOfficial documentation for MLflow can be found at https://mlflow.org/docs/latest/index.html.\n\nRoadmap\n-------\nThe current MLflow Roadmap is available at https://github.com/mlflow/mlflow/milestone/3. We are\nseeking contributions to all of our roadmap items with the ``help wanted`` label. Please see the\n`Contributing`_ section for more information.\n\nCommunity\n---------\nFor help or questions about MLflow usage (e.g. \"how do I do X?\") see the `docs <https://mlflow.org/docs/latest/index.html>`_\nor `Stack Overflow <https://stackoverflow.com/questions/tagged/mlflow>`_.\n\nTo report a bug, file a documentation issue, or submit a feature request, please open a GitHub issue.\n\nFor release announcements and other discussions, please subscribe to our mailing list (mlflow-users@googlegroups.com)\nor join us on `Slack`_.\n\nRunning a Sample App With the Tracking API\n------------------------------------------\nThe programs in ``examples`` use the MLflow Tracking API. For instance, run::\n\n python examples/quickstart/mlflow_tracking.py\n\nThis program will use `MLflow Tracking API <https://mlflow.org/docs/latest/tracking.html>`_,\nwhich logs tracking data in ``./mlruns``. This can then be viewed with the Tracking UI.\n\n\nLaunching the Tracking UI\n-------------------------\nThe MLflow Tracking UI will show runs logged in ``./mlruns`` at `<http://localhost:5000>`_.\nStart it with::\n\n mlflow ui\n\n**Note:** Running ``mlflow ui`` from within a clone of MLflow is not recommended - doing so will\nrun the dev UI from source. We recommend running the UI from a different working directory,\nspecifying a backend store via the ``--backend-store-uri`` option. Alternatively, see\ninstructions for running the dev UI in the `contributor guide <CONTRIBUTING.md>`_.\n\n\nRunning a Project from a URI\n----------------------------\nThe ``mlflow run`` command lets you run a project packaged with a MLproject file from a local path\nor a Git URI::\n\n mlflow run examples/sklearn_elasticnet_wine -P alpha=0.4\n\n mlflow run https://github.com/mlflow/mlflow-example.git -P alpha=0.4\n\nSee ``examples/sklearn_elasticnet_wine`` for a sample project with an MLproject file.\n\n\nSaving and Serving Models\n-------------------------\nTo illustrate managing models, the ``mlflow.sklearn`` package can log scikit-learn models as\nMLflow artifacts and then load them again for serving. There is an example training application in\n``examples/sklearn_logistic_regression/train.py`` that you can run as follows::\n\n $ python examples/sklearn_logistic_regression/train.py\n Score: 0.666\n Model saved in run <run-id>\n\n $ mlflow models serve --model-uri runs:/<run-id>/model\n\n $ curl -d '{\"dataframe_split\": {\"columns\":[0],\"index\":[0,1],\"data\":[[1],[-1]]}}' -H 'Content-Type: application/json' localhost:5000/invocations\n\n**Note:** If using MLflow skinny (``pip install mlflow-skinny``) for model serving, additional\nrequired dependencies (namely, ``flask``) will need to be installed for the MLflow server to function.\n\nOfficial MLflow Docker Image\n----------------------------\n\nThe official MLflow Docker image is available on GitHub Container Registry at https://ghcr.io/mlflow/mlflow.\n\n.. code-block:: shell\n\n export CR_PAT=YOUR_TOKEN\n echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin\n # Pull the latest version\n docker pull ghcr.io/mlflow/mlflow\n # Pull 2.2.1\n docker pull ghcr.io/mlflow/mlflow:v2.2.1\n\nContributing\n------------\nWe happily welcome contributions to MLflow. We are also seeking contributions to items on the\n`MLflow Roadmap <https://github.com/mlflow/mlflow/milestone/3>`_. Please see our\n`contribution guide <CONTRIBUTING.md>`_ to learn more about contributing to MLflow.\n\nCore Members\n------------\n\nMLflow is currently maintained by the following core members with significant contributions from hundreds of exceptionally talented community members.\n\n- `Harutaka Kawamura <https://github.com/harupy>`_\n- `Weichen Xu <https://github.com/WeichenXu123>`_\n- `Corey Zumar <https://github.com/dbczumar>`_\n- `Ben Wilson <https://github.com/BenWilson2>`_\n- `Serena Ruan <https://github.com/serena-ruan>`_\n- `Gabriel Fu <https://github.com/gabrielfu>`_\n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "MLflow: A Platform for ML Development and Productionization",
"version": "2.40.0",
"project_urls": {
"Bug Tracker": "https://github.com/mlflow/mlflow/issues",
"Documentation": "https://mlflow.org/docs/latest/index.html",
"Homepage": "https://mlflow.org/",
"Source Code": "https://github.com/mlflow/mlflow"
},
"split_keywords": [
"ml",
"ai",
"databricks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d044a60b2d56b7fa25d52adddb88890d931be3b6535aefaf11374b1bad99bf71",
"md5": "e1e6dd129aabea32313072c467678b01",
"sha256": "4bf4202e8218a361ef2d0723306dc4575cf1b08bc2ed677c17cc78282cc2516e"
},
"downloads": -1,
"filename": "mlflow_by_johnsnowlabs-2.40.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e1e6dd129aabea32313072c467678b01",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 4517832,
"upload_time": "2023-10-10T23:32:17",
"upload_time_iso_8601": "2023-10-10T23:32:17.524961Z",
"url": "https://files.pythonhosted.org/packages/d0/44/a60b2d56b7fa25d52adddb88890d931be3b6535aefaf11374b1bad99bf71/mlflow_by_johnsnowlabs-2.40.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "05cf966bc4fc99ade3a5d40e8a3deb13f3ccac5aa4198e953aaa6edf285735ce",
"md5": "8c61d7f54767c7ea917f5689b457558e",
"sha256": "2796b2dc8acc30c6e16f4497d112bdeba8700c3831fdb1144747eff85608e0e9"
},
"downloads": -1,
"filename": "mlflow_by_johnsnowlabs-2.40.0.tar.gz",
"has_sig": false,
"md5_digest": "8c61d7f54767c7ea917f5689b457558e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4267670,
"upload_time": "2023-10-10T23:32:21",
"upload_time_iso_8601": "2023-10-10T23:32:21.198871Z",
"url": "https://files.pythonhosted.org/packages/05/cf/966bc4fc99ade3a5d40e8a3deb13f3ccac5aa4198e953aaa6edf285735ce/mlflow_by_johnsnowlabs-2.40.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-10 23:32:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mlflow",
"github_project": "mlflow",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"circle": true,
"lcname": "mlflow-by-johnsnowlabs"
}
JSON
