Metadata-Version: 2.1
Name: mloq
Version: 0.0.64
Summary: Package for initializing ML projects following ML Ops best practices.
Home-page: https://github.com/FragileTech/ml-ops-quickstart
Author: FragileTech
Author-email: guillem@fragile.tech
License: MIT
Download-URL: https://github.com/FragileTech/ml-ops-quickstart/releases
Description: # ML Ops Quickstart
        [![Documentation Status](https://readthedocs.org/projects/mloq/badge/?version=latest)](https://mloq.readthedocs.io/en/latest/?badge=latest)
        [![Code coverage](https://codecov.io/github/fragiletech/ml-ops-quickstart/coverage.svg)](https://codecov.io/github/fragiletech/ml-ops-quickstart)
        [![PyPI package](https://badgen.net/pypi/v/mloq)](https://pypi.org/project/mloq/)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
        [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
        
        ML Ops Quickstart is a tool for initializing Machine Learning projects following ML Ops best practices.
        
        Setting up new repositories is a time-consuming task that involves creating different files and 
        configuring tools such as linters, docker containers and continuous integration pipelines. 
        The goal of `mloq` is to simplify that process, so you can start writing code as fast as possible.
        
        `mloq` generates customized templates for Python projects with focus on Maching Learning. An example of 
        the generated templates can be found in [mloq-template](https://github.com/FragileTech/mloq-template).
        
        ## [1.](#Index) Installation
        
        `mloq` is tested on Ubuntu 18.04+, and supports Python 3.6+.
        
        ### Install from pypi
        ```bash
        pip install mloq
        ```
        ### Install from source
        ```bash
        git clone https://github.com/FragileTech/ml-ops-quickstart.git
        cd ml-ops-quickstart
        pip install -e .
        ```
        
        ## [2.](#Index) Usage
        ### [2.1](#Index) Command line interface
        
        Options:
        * `--file` `-f`: Name of the configuration file. If `file` it's a directory it will load the `mloq.yml` file present in it.
        
        * `--overwrite` `-o`: Rewrite files that already exist in the target project.
        * `--interactive` `-i`: Missing configuration data can be defined interactively from the CLI.
        
        #### Usage examples
        Arguments:
        * `OUTPUT_DIRECTORY`: Path to the target project.
        
        To set up a new repository from scratch interactively in the curren working directory:
        ```bash
        mloq setup -i .
        ```
        
        To load a `mloq.yml` configuration file from the current repository, and initialize the directory `example`, and 
        overwrite all existing files with no interactivity:
        ```bash
        mloq setup -f . -o example
        ```
        
        ![ci python](docs/images/mloq_setup.png)
        
        ## [5.](#Index) License
        ML Ops Quickstart is released under the [MIT](LICENSE) license.
        
        ## [6.](#Index) Contributing
        
        Contributions are very welcome! Please check the [contributing guidelines](CONTRIBUTING.md) before opening a pull request.
        
        ## [7.](#Index) Roadmap
        
        - [ ] Improve documentation and test coverage.
        - [ ] Configure sphinx to build the docs automatically.
        - [ ] Expose all api as a CLI interface
        - [ ] Add new customization options.
Keywords: Machine learning,artificial intelligence
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
