mlecho 0.0.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- mlecho-0.0.1/LICENSE +21 -0
- mlecho-0.0.1/PKG-INFO +55 -0
- mlecho-0.0.1/README.md +30 -0
- mlecho-0.0.1/pyproject.toml +43 -0
- mlecho-0.0.1/setup.cfg +4 -0
- mlecho-0.0.1/src/mlecho/__init__.py +35 -0
- mlecho-0.0.1/src/mlecho.egg-info/PKG-INFO +55 -0
- mlecho-0.0.1/src/mlecho.egg-info/SOURCES.txt +8 -0
- mlecho-0.0.1/src/mlecho.egg-info/dependency_links.txt +1 -0
- mlecho-0.0.1/src/mlecho.egg-info/top_level.txt +1 -0
mlecho-0.0.1/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Thanuja Liyanage
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
mlecho-0.0.1/PKG-INFO
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: mlecho
|
|
3
|
+
Version: 0.0.1
|
|
4
|
+
Summary: Real-time CNN-VAE poisoning detection for MLOps pipelines
|
|
5
|
+
Author: Thanuja Liyanage
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Repository, https://github.com/justthzz/mlecho
|
|
8
|
+
Project-URL: Issues, https://github.com/justthzz/mlecho/issues
|
|
9
|
+
Keywords: machine-learning,mlops,data-poisoning,anomaly-detection,mlflow,vae,reinforcement-learning
|
|
10
|
+
Classifier: Development Status :: 2 - Pre-Alpha
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: Intended Audience :: Science/Research
|
|
13
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
20
|
+
Classifier: Topic :: Security
|
|
21
|
+
Requires-Python: >=3.9
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
License-File: LICENSE
|
|
24
|
+
Dynamic: license-file
|
|
25
|
+
|
|
26
|
+
# MLEcho
|
|
27
|
+
|
|
28
|
+
**A Real-Time CNN-VAE and Reinforcement Learning Framework for Detecting and Responding to Training Data Poisoning in MLOps Pipelines.**
|
|
29
|
+
|
|
30
|
+
> ⚠️ **Work in progress.** MLEcho is under active development as part of an ongoing Final Year Project (FYP). Core detection, classification, and response modules are not yet functional — see [Status](#status) below.
|
|
31
|
+
|
|
32
|
+
## What is MLEcho?
|
|
33
|
+
|
|
34
|
+
MLEcho monitors training batches as they stream through an MLOps pipeline, flagging poisoned data during active training rather than before or after it. It combines:
|
|
35
|
+
|
|
36
|
+
- A **CNN feature extractor** and **VAE anomaly scorer** that flag anomalous batches by reconstruction error — clean batches reconstruct faithfully (a true "echo"), poisoned batches produce a distorted one.
|
|
37
|
+
- An **attack-type classifier** that identifies the likely poisoning strategy (backdoor, label-flip, gradient-based, accumulative).
|
|
38
|
+
- A **deterministic rule-based response module** (quarantine, rollback, retrain, escalate).
|
|
39
|
+
- *(Research enhancement, in progress)* A **PPO-based reinforcement-learning response agent**, evaluated against the rule-based baseline.
|
|
40
|
+
|
|
41
|
+
MLEcho integrates with **MLflow**, **Weights & Biases**, and **Docker** for experiment tracking, live monitoring, and reproducible deployment.
|
|
42
|
+
|
|
43
|
+
## Installation
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pip install mlecho
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Status
|
|
50
|
+
|
|
51
|
+
This package currently ships a placeholder API only. Calling `mlecho.detect()` raises `NotImplementedError`. Follow the repository for progress as the core CNN-VAE detector, classifier, and response modules are implemented.
|
|
52
|
+
|
|
53
|
+
## License
|
|
54
|
+
|
|
55
|
+
MIT — see [LICENSE](LICENSE).
|
mlecho-0.0.1/README.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# MLEcho
|
|
2
|
+
|
|
3
|
+
**A Real-Time CNN-VAE and Reinforcement Learning Framework for Detecting and Responding to Training Data Poisoning in MLOps Pipelines.**
|
|
4
|
+
|
|
5
|
+
> ⚠️ **Work in progress.** MLEcho is under active development as part of an ongoing Final Year Project (FYP). Core detection, classification, and response modules are not yet functional — see [Status](#status) below.
|
|
6
|
+
|
|
7
|
+
## What is MLEcho?
|
|
8
|
+
|
|
9
|
+
MLEcho monitors training batches as they stream through an MLOps pipeline, flagging poisoned data during active training rather than before or after it. It combines:
|
|
10
|
+
|
|
11
|
+
- A **CNN feature extractor** and **VAE anomaly scorer** that flag anomalous batches by reconstruction error — clean batches reconstruct faithfully (a true "echo"), poisoned batches produce a distorted one.
|
|
12
|
+
- An **attack-type classifier** that identifies the likely poisoning strategy (backdoor, label-flip, gradient-based, accumulative).
|
|
13
|
+
- A **deterministic rule-based response module** (quarantine, rollback, retrain, escalate).
|
|
14
|
+
- *(Research enhancement, in progress)* A **PPO-based reinforcement-learning response agent**, evaluated against the rule-based baseline.
|
|
15
|
+
|
|
16
|
+
MLEcho integrates with **MLflow**, **Weights & Biases**, and **Docker** for experiment tracking, live monitoring, and reproducible deployment.
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
pip install mlecho
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Status
|
|
25
|
+
|
|
26
|
+
This package currently ships a placeholder API only. Calling `mlecho.detect()` raises `NotImplementedError`. Follow the repository for progress as the core CNN-VAE detector, classifier, and response modules are implemented.
|
|
27
|
+
|
|
28
|
+
## License
|
|
29
|
+
|
|
30
|
+
MIT — see [LICENSE](LICENSE).
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=61.0"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "mlecho"
|
|
7
|
+
version = "0.0.1"
|
|
8
|
+
description = "Real-time CNN-VAE poisoning detection for MLOps pipelines"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.9"
|
|
11
|
+
license = { text = "MIT" }
|
|
12
|
+
authors = [
|
|
13
|
+
{ name = "Thanuja Liyanage" }
|
|
14
|
+
]
|
|
15
|
+
keywords = [
|
|
16
|
+
"machine-learning",
|
|
17
|
+
"mlops",
|
|
18
|
+
"data-poisoning",
|
|
19
|
+
"anomaly-detection",
|
|
20
|
+
"mlflow",
|
|
21
|
+
"vae",
|
|
22
|
+
"reinforcement-learning",
|
|
23
|
+
]
|
|
24
|
+
classifiers = [
|
|
25
|
+
"Development Status :: 2 - Pre-Alpha",
|
|
26
|
+
"Intended Audience :: Developers",
|
|
27
|
+
"Intended Audience :: Science/Research",
|
|
28
|
+
"License :: OSI Approved :: MIT License",
|
|
29
|
+
"Programming Language :: Python :: 3",
|
|
30
|
+
"Programming Language :: Python :: 3.9",
|
|
31
|
+
"Programming Language :: Python :: 3.10",
|
|
32
|
+
"Programming Language :: Python :: 3.11",
|
|
33
|
+
"Programming Language :: Python :: 3.12",
|
|
34
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
35
|
+
"Topic :: Security",
|
|
36
|
+
]
|
|
37
|
+
|
|
38
|
+
[project.urls]
|
|
39
|
+
Repository = "https://github.com/justthzz/mlecho"
|
|
40
|
+
Issues = "https://github.com/justthzz/mlecho/issues"
|
|
41
|
+
|
|
42
|
+
[tool.setuptools.packages.find]
|
|
43
|
+
where = ["src"]
|
mlecho-0.0.1/setup.cfg
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
"""MLEcho: Real-Time CNN-VAE and Reinforcement Learning Framework for
|
|
2
|
+
Detecting and Responding to Training Data Poisoning in MLOps Pipelines.
|
|
3
|
+
|
|
4
|
+
MLEcho monitors training batches as they stream through an MLOps
|
|
5
|
+
pipeline. A CNN feature extractor and VAE anomaly scorer flag batches
|
|
6
|
+
whose reconstruction ("echo") deviates significantly from clean,
|
|
7
|
+
calibrated training data. Flagged batches are classified by attack
|
|
8
|
+
type and handled by a deterministic rule-based response module
|
|
9
|
+
(quarantine, rollback, retrain, escalate), with a PPO-based
|
|
10
|
+
reinforcement-learning response agent under investigation as a
|
|
11
|
+
research enhancement.
|
|
12
|
+
|
|
13
|
+
This is an early-stage release. Core detection, classification, and
|
|
14
|
+
response modules are under active development as part of an ongoing
|
|
15
|
+
Final Year Project (FYP). See the project README and repository for
|
|
16
|
+
current status.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
__version__ = "0.0.1"
|
|
20
|
+
__all__ = ["detect", "__version__"]
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def detect(*args, **kwargs):
|
|
24
|
+
"""Run poisoning detection on a training batch.
|
|
25
|
+
|
|
26
|
+
Not yet implemented. This is a placeholder for the CNN-VAE
|
|
27
|
+
detection pipeline, which is under active development.
|
|
28
|
+
|
|
29
|
+
Raises:
|
|
30
|
+
NotImplementedError: Always, until the core detector ships.
|
|
31
|
+
"""
|
|
32
|
+
raise NotImplementedError(
|
|
33
|
+
"MLEcho's core detection module is still in development. "
|
|
34
|
+
"Track progress at the project repository."
|
|
35
|
+
)
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: mlecho
|
|
3
|
+
Version: 0.0.1
|
|
4
|
+
Summary: Real-time CNN-VAE poisoning detection for MLOps pipelines
|
|
5
|
+
Author: Thanuja Liyanage
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Repository, https://github.com/justthzz/mlecho
|
|
8
|
+
Project-URL: Issues, https://github.com/justthzz/mlecho/issues
|
|
9
|
+
Keywords: machine-learning,mlops,data-poisoning,anomaly-detection,mlflow,vae,reinforcement-learning
|
|
10
|
+
Classifier: Development Status :: 2 - Pre-Alpha
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: Intended Audience :: Science/Research
|
|
13
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
20
|
+
Classifier: Topic :: Security
|
|
21
|
+
Requires-Python: >=3.9
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
License-File: LICENSE
|
|
24
|
+
Dynamic: license-file
|
|
25
|
+
|
|
26
|
+
# MLEcho
|
|
27
|
+
|
|
28
|
+
**A Real-Time CNN-VAE and Reinforcement Learning Framework for Detecting and Responding to Training Data Poisoning in MLOps Pipelines.**
|
|
29
|
+
|
|
30
|
+
> ⚠️ **Work in progress.** MLEcho is under active development as part of an ongoing Final Year Project (FYP). Core detection, classification, and response modules are not yet functional — see [Status](#status) below.
|
|
31
|
+
|
|
32
|
+
## What is MLEcho?
|
|
33
|
+
|
|
34
|
+
MLEcho monitors training batches as they stream through an MLOps pipeline, flagging poisoned data during active training rather than before or after it. It combines:
|
|
35
|
+
|
|
36
|
+
- A **CNN feature extractor** and **VAE anomaly scorer** that flag anomalous batches by reconstruction error — clean batches reconstruct faithfully (a true "echo"), poisoned batches produce a distorted one.
|
|
37
|
+
- An **attack-type classifier** that identifies the likely poisoning strategy (backdoor, label-flip, gradient-based, accumulative).
|
|
38
|
+
- A **deterministic rule-based response module** (quarantine, rollback, retrain, escalate).
|
|
39
|
+
- *(Research enhancement, in progress)* A **PPO-based reinforcement-learning response agent**, evaluated against the rule-based baseline.
|
|
40
|
+
|
|
41
|
+
MLEcho integrates with **MLflow**, **Weights & Biases**, and **Docker** for experiment tracking, live monitoring, and reproducible deployment.
|
|
42
|
+
|
|
43
|
+
## Installation
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pip install mlecho
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Status
|
|
50
|
+
|
|
51
|
+
This package currently ships a placeholder API only. Calling `mlecho.detect()` raises `NotImplementedError`. Follow the repository for progress as the core CNN-VAE detector, classifier, and response modules are implemented.
|
|
52
|
+
|
|
53
|
+
## License
|
|
54
|
+
|
|
55
|
+
MIT — see [LICENSE](LICENSE).
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
mlecho
|