Metadata-Version: 2.1
Name: bigmlflow
Version: 1.0.2
Summary: An open source library to add BigML models to the MLFlow API
Home-page: https://bigml.com/
Download-URL: https://github.com/bigmlcom/bigmlflow
Author: The BigML Team
Author-email: bigml@bigml.com
License: http://www.apache.org/licenses/LICENSE-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: test
License-File: LICENSE

# BigMLFlow

This library defines the connectors needed for the integration and
deployment of [BigML](https://bigml.com) models using
[MLFlow](https://mlflow.org/).

## Introduction

All the resources generated by the `BigML` API-first platform, including
models, are totally white-box, and they can be downloaded as JSON and used
to predict anywhere. The `bigmlflow` library uses
[BigML's Python bindings](https://bigml.readthedocs.io/en/latest/local_resources.html)
to integrate with `MLFlow` tracking and deploying capacities.

The [examples/README.md](./examples/README.md) file shows a few use cases
that cover some of the Supervised Models available in BigML and
a full training example to demo the logging and tracking of `BigML's models`
using `MLFlow`.

## Installation

This library is available as a PyPI package. To install it, just run:

```bash
    pip install bigmlflow
```

## Tests

The `tests` directory contains some tests for the logging of models.
We use `Pytest` to run the tests, so you can install it separately

```bash
    pip install pytest
```

or as an extra for development and testing purposes

```bash
    pip install -e .[tests]
```


How to Contribute
-----------------

Please follow the next steps:

  1. Fork the project on github.com.
  2. Create a new branch.
  3. Commit changes to the new branch.
  4. Send a [pull request](https://github.com/bigmlcom/bigmlflow/pulls).


.. :changelog:

History
-------

1.0.2 (2022-11-29)
~~~~~~~~~~~~~~~~~~

- Adding documentation and updating MLFlow version.

1.0.1 (2022-11-02)
~~~~~~~~~~~~~~~~~~

- Adding MANIFEST.in file to fix the distribution file.

1.0.0 (2022-10-19)
~~~~~~~~~~~~~~~~~~

- First version of the library.
