Metadata-Version: 2.2
Name: model-monitor
Version: 0.1.1
Summary: A comprehensive library for automated model monitoring and drift detection
Home-page: https://github.com/biswanathroul/model-monitor
Author: Biswanath Roul
Project-URL: Bug Tracker, https://github.com/biswanathroul/model-monitor/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: scikit-learn>=1.0.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: matplotlib>=3.4.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: plotly>=5.0.0
Requires-Dist: pydantic>=1.8.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: joblib>=1.0.0
Requires-Dist: tqdm>=4.62.0
Requires-Dist: statsmodels>=0.13.0
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: pytest-cov>=2.12.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: isort>=5.10.0; extra == "dev"
Requires-Dist: mypy>=0.910; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Requires-Dist: sphinx>=4.3.0; extra == "dev"
Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "dev"
Provides-Extra: notification
Requires-Dist: slack-sdk>=3.15.0; extra == "notification"
Requires-Dist: sendgrid>=6.9.0; extra == "notification"
Provides-Extra: cloud
Requires-Dist: boto3>=1.20.0; extra == "cloud"
Requires-Dist: google-cloud-storage>=2.0.0; extra == "cloud"
Requires-Dist: azure-storage-blob>=12.9.0; extra == "cloud"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Model Monitor

![PyPI](https://img.shields.io/pypi/v/model-monitor)
![Python](https://img.shields.io/pypi/pyversions/model-monitor)
![License](https://img.shields.io/pypi/l/model-monitor)
![Build Status](https://img.shields.io/github/workflow/status/biswanathroul/model-monitor/Python%20package)

A comprehensive Python library for automated model monitoring and drift detection in machine learning systems.

## Features

- **Data Drift Detection**: Identify shifts in feature distributions using statistical tests and distance metrics
- **Model Performance Monitoring**: Track key metrics over time and detect degradation
- **Prediction Drift Analysis**: Monitor changes in model output distributions
- **Customizable Alerting**: Set thresholds and receive notifications when drift is detected
- **Visualization Tools**: Generate comprehensive reports and visualizations of drift metrics
- **Integration Flexibility**: Works with various ML frameworks and data sources
- **Scalable Architecture**: Efficiently handle large datasets and high-throughput models

## Installation

```bash
pip install model-monitor
```

## Quick Start

```python
from model_monitor import Monitor
import pandas as pd

# Initialize monitor with baseline data
baseline_data = pd.read_csv("baseline_data.csv")
production_data = pd.read_csv("production_data.csv") 

monitor = Monitor()
monitor.set_baseline(baseline_data)

# Run drift detection
results = monitor.detect_drift(production_data)

# Generate report
monitor.generate_report("drift_report.html")

# Set up automated monitoring
monitor.schedule(
    data_source="s3://bucket/path/to/data/",
    frequency="daily",
    alert_threshold=0.05,
    notification_email="alerts@example.com"
)
```


## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Author

- **Biswanath Roul** - [GitHub](https://github.com/biswanathroul/model-monitor)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
