https://github.com/mr-ravin/auto_mlflow
Auto MLFlow is an open-source automated MLOps library for MLFlow in Python. While MLFlow provides a UI for tracking experiments, Auto MLFlow automates and simplifies the logging process, reducing manual effort and ensuring seamless integration with ML workflows.
https://github.com/mr-ravin/auto_mlflow
architecture auto-mlflow automation deep-learning deployment mlflow mlflow-projects mlops mlops-project
Last synced: 5 months ago
JSON representation
Auto MLFlow is an open-source automated MLOps library for MLFlow in Python. While MLFlow provides a UI for tracking experiments, Auto MLFlow automates and simplifies the logging process, reducing manual effort and ensuring seamless integration with ML workflows.
- Host: GitHub
- URL: https://github.com/mr-ravin/auto_mlflow
- Owner: mr-ravin
- Archived: true
- Created: 2024-01-17T16:45:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-04T18:46:25.000Z (about 1 year ago)
- Last Synced: 2025-03-04T19:24:42.821Z (about 1 year ago)
- Topics: architecture, auto-mlflow, automation, deep-learning, deployment, mlflow, mlflow-projects, mlops, mlops-project
- Language: Python
- Homepage: https://pypi.org/project/auto-mlflow/
- Size: 44.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## π¦ **Auto MLFlow**
## πΉ **Overview**
Auto MLFlow is an open-source automated MLOps library for MLFlow in Python. While MLFlow provides a UI for tracking experiments, Auto MLFlow automates and simplifies the logging process, reducing manual effort and ensuring seamless integration with ML workflows.
With Auto MLFlow, you can:
- **Automatically log** experiment parameters, metrics, artifacts, and models.
- **Store images, textual data, and logs** in MLFlow without additional configuration.
- **Seamlessly integrate** with deep learning frameworks like PyTorch and TensorFlow.
- **Simplify MLOps workflows** by handling experiment tracking with minimal code.
- **Maintain reproducibility and transparency** in ML experiments.
This library is designed for researchers, data scientists, and ML engineers who want a streamlined approach to tracking and managing ML experiments.
---
## π§ **Development Details**
- **π¨βπ» Developer:** [Ravin Kumar](https://mr-ravin.github.io)
- **π GitHub Repository:** [https://github.com/mr-ravin/auto_mlflow](https://github.com/mr-ravin/auto_mlflow)
---
## π₯ **Installation**
Install using pip:
```sh
pip install auto_mlflow
```
or,
```sh
pip install git+https://github.com/mr-ravin/auto_mlflow.git
```
---
### π **Dependencies:**
- Python >= 3.7, < 3.13
- mlflow: >= 2.9.2, <= 2.20.3
- opencv-contrib-python: >= 4.7.0.72
- opencv-python: >= 4.7.0.72
- opencv-python-headless: >= 4.8.0.74
---
## π **Example Usage**
- Start a MLFlow Server.
```
mlflow server --host 127.0.0.1 --port 5555
```
- Use Auto MLFlow to log model and experiment related information.
```python
import auto_mlflow
user_name = "Ravin Kumar"
project_name = "Object Detection"
experiment_name = "Using Yolo approach"
runName = "using yolov3"
total_epochs = 30
mlflow_server_uri = "http://127.0.0.1:5555" # IP address of the MLFlow Server.
# initialisation
auto_mlflow.init_run(user_name, project_name, experiment_name, runName, mlflow_server_uri) # project, experiment, and run is created
# below this line, whatever is printed in the terminal will also get logged in the MLFlow inside the file log.txt
auto_mlflow.write_param(param_dict={"learning_rate": "0.001", "total_epochs": str(total_epochs)}) # save training related information
# storing train, val, and test loss values
model_architecture = get_model_architecture()
for epoch in range(total_epochs):
train_loss = ...
valid_loss = ...
test_loss = ...
metric_dict={"train_loss": train_loss, "valid_loss": valid_loss, "test_loss": test_loss}
auto_mlflow.write_metric(metric_dict, step = epoch)
# storing an image in MLFlow Server
numpy_array_bgr = visualised_image(.....)
auto_mlflow.write_image(numpy_array_bgr, image_name="image.jpg")
# storing text in a file inside MLFlow Server
auto_mlflow.write_text(filename="additional_file.txt", filedata="object detection model")
# storing already existing local file inside MLFlow Server
# example- incase one wants to save only weights, and not rely on model registry. This will get saved inside weights/ in MLFlow Sever
auto_mlflow.write_files("yolo_weights.pth", filepath="weights")
# storing an entire directory present in local system, to the MLFlow Server
auto_mlflow.write_directory("./other_data", mlflow_dir_path="artifacts") # this will copy all the content of ./other_data to MLFlow inside artifacts/
# Logging a model
auto_mlflow.log_model(model_architecture, model_run_path="models") # the logged model can be used for model registry
auto_mlflow.end_run() # all the information is successfully saved.
# complete
```
---
## π **Copyright License**
```
Copyright (c) 2024 Ravin Kumar
Website: https://mr-ravin.github.io
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
files (the βSoftwareβ), to deal in the Software without restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED βAS ISβ, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
```