ai-critic 0.1.0__py3-none-any.whl

ai_critic/__init__.py

@@ -0,0 +1,3 @@
+from .critic import AICritic
+
+__all__ = ["AICritic"]

ai_critic/critic.py

@@ -0,0 +1,30 @@
+from ai_critic.evaluators import (
+    robustness,
+    config,
+    data,
+    performance
+)
+
+class AICritic:
+    """
+    Orquestrador principal da avaliação de modelos sklearn
+    """
+
+    def __init__(self, model, X, y):
+        self.model = model
+        self.X = X
+        self.y = y
+
+    def evaluate(self):
+        report = {}
+
+        report["config"] = config(self.model)
+        report["data"] = data(self.X, self.y)
+        report["performance"] = performance(
+            self.model, self.X, self.y
+        )
+        report["robustness"] = robustness(
+            self.model, self.X, self.y
+        )
+
+        return report

ai_critic/evaluators/__init__.py

@@ -0,0 +1,4 @@
+from .robustness import evaluate as robustness
+from .config import evaluate as config
+from .data import evaluate as data
+from .performance import evaluate as performance

ai_critic/evaluators/config.py

@@ -0,0 +1,6 @@
+def evaluate(model):
+    return {
+        "model_type": type(model).__name__,
+        "n_params": len(model.get_params()),
+        "uses_random_state": "random_state" in model.get_params()
+    }

ai_critic/evaluators/data.py

@@ -0,0 +1,14 @@
+import numpy as np
+
+def evaluate(X, y):
+    return {
+        "n_samples": X.shape[0],
+        "n_features": X.shape[1],
+        "has_nan": bool(
+            np.isnan(X).any() or np.isnan(y).any()
+        ),
+        "class_balance": (
+            dict(zip(*np.unique(y, return_counts=True)))
+            if len(set(y)) < 20 else "many_classes"
+        )
+    }

ai_critic/evaluators/performance.py

@@ -0,0 +1,11 @@
+from sklearn.model_selection import cross_val_score
+
+def evaluate(model, X, y):
+    scores = cross_val_score(
+        model, X, y, cv=3, n_jobs=1
+    )
+
+    return {
+        "cv_mean_score": float(scores.mean()),
+        "cv_std": float(scores.std())
+    }

ai_critic/evaluators/robustness.py

@@ -0,0 +1,18 @@
+import numpy as np
+from sklearn.base import clone
+
+def evaluate(model, X, y):
+    model_1 = clone(model)
+    model_2 = clone(model)
+
+    model_1.fit(X, y)
+    model_2.fit(X + np.random.normal(0, 1e-6, X.shape), y)
+
+    score_1 = model_1.score(X, y)
+    score_2 = model_2.score(X, y)
+
+    return {
+        "score_original": float(score_1),
+        "score_perturbed": float(score_2),
+        "delta": float(abs(score_1 - score_2))
+    }

ai_critic-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: ai-critic
+Version: 0.1.0
+Summary: Fast AI evaluator for scikit-learn models
+Author-email: Luiz Seabra <seu-email@exemplo.com>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: numpy
+Requires-Dist: scikit-learn
+
+# AI Critic 🧠⚖️
+
+**AI Critic** is a fast evaluator for scikit-learn models.
+It analyzes configuration, robustness, data quality and performance in minutes.
+
+## Install
+
+```bash
+pip install ai-critic
+```
+
+## Quick Example
+
+```python
+from sklearn.datasets import load_breast_cancer
+from sklearn.ensemble import RandomForestClassifier
+from ai_critic import AICritic
+
+X, y = load_breast_cancer(return_X_y=True)
+
+model = RandomForestClassifier(n_estimators=50, max_depth=3)
+
+critic = AICritic(model, X, y)
+report = critic.evaluate()
+
+print(report)
+```
+
+## What it evaluates
+
+*   Model configuration sanity
+*   Data consistency
+*   Robustness to noise
+*   Basic performance metrics
+
+## Philosophy
+
+Fast, modular, and brutally honest AI evaluation.
+
+📌 README simples = mais confiança
+
+---
+
+## Development & Testing
+
+To test the package locally as an end-user (mandatory for development):
+
+In the root directory:
+
+```bash
+pip install -e .
+python -c "from ai_critic import AICritic; print('OK')"
+python -m pytest
+```

ai_critic-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+ai_critic/__init__.py,sha256=H6DlPMmbcFUamhsNULPLk9vHx81XCiXuKKf63EJ8eM0,53
+ai_critic/critic.py,sha256=ulkj6A6flREQy4HMdFj8ktp-iH_-5bsGkxsYE6zCMBE,635
+ai_critic/evaluators/__init__.py,sha256=Jmmz9899YD__4Uj3bA6R7vYOwlH2giPc1wuCSLv7FVw,170
+ai_critic/evaluators/config.py,sha256=3q4_Wg-lbrM_I_tcZl4InL0_OijlHNtnDBnewaGDtco,195
+ai_critic/evaluators/data.py,sha256=gbDz1NdJ3vZuXRGV3mQtpfLgmVRnowfCTCJ0RH5SlxM,359
+ai_critic/evaluators/performance.py,sha256=25Ja6jOaSc-maSVJNABrhGrxElYQH7IDGGbYx_Rr0J8,257
+ai_critic/evaluators/robustness.py,sha256=InBx3bmTTGBU8yQ4I-E81xOC2gEAOpwpKRSqkxn2Cw4,435
+ai_critic-0.1.0.dist-info/METADATA,sha256=iO4Oz0mSHsm0YzpeEzmwzAwJaNvY2hzb2dfn4RbBSaE,1286
+ai_critic-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ai_critic-0.1.0.dist-info/top_level.txt,sha256=TRyZkm1vyLLcFDg_80yeg5cHvPis_oW1Ti170417jkw,10
+ai_critic-0.1.0.dist-info/RECORD,,

ai_critic-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ai_critic-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ai_critic