kaizenstat 0.2.0__tar.gz → 0.2.2__tar.gz

kaizenstat-0.2.2/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: kaizenstat
+Version: 0.2.2
+Summary: Zero-friction AutoML + Data Cleaning Toolkit
+Author: Masuddar Rahman
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: scikit-learn
+Requires-Dist: rich
+Requires-Dist: joblib
+Provides-Extra: ui
+Requires-Dist: streamlit; extra == "ui"
+Provides-Extra: gpu
+Requires-Dist: xgboost; extra == "gpu"
+Provides-Extra: fast
+Requires-Dist: polars; extra == "fast"
+Provides-Extra: all
+Requires-Dist: streamlit; extra == "all"
+Requires-Dist: xgboost; extra == "all"
+Requires-Dist: polars; extra == "all"
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🚀 KaizenStat
+
+[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg?style=flat-square&color=blue)](https://pypi.org/project/kaizenstat/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg?style=flat-square)](https://www.python.org/downloads/)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
+
+**KaizenStat** is a zero-friction, production-grade AutoML, automated data cleaning, and model explanation engine. It allows you to audit datasets, repair data issues, benchmark models with hardware-aware optimization, export standalone pipeline code, and host web-based dashboards—all with a single command or Python import.
+
+---
+
+## 🎯 Core Philosophy
+
+* **Zero-Friction AutoML:** No complex configuration files. Pass your dataset, name your target, and KaizenStat does the rest.
+* **Production Crash-Proofing:** Automatically handles messy real-world data issues: high-cardinality ID columns, datetime parsing, missing inputs, class imbalance, and label encoding.
+* **Explainable AI:** Breaks open the "black box" by generating standalone, human-readable Python training code reproducing the best-found pipeline.
+* **Hybrid Interface:** 100% parity between CLI and Python API.
+
+---
+
+## 📦 Installation
+
+Install the core package with zero heavy external dependencies:
+
+```bash
+pip install kaizenstat
+```
+
+### Optional Drivers & Accelerators
+
+Tailor KaizenStat to your specific workload:
+
+```bash
+pip install kaizenstat[ui]     # Install Streamlit for web dashboards
+pip install kaizenstat[gpu]    # Install XGBoost with GPU/MPS support
+pip install kaizenstat[fast]   # Install Polars for ultra-fast CSV parsing
+pip install kaizenstat[all]    # Install all optional components
+```
+
+---
+
+## ⚔️ CLI & Python API Feature Matrix
+
+KaizenStat is designed around a single unified vocabulary. Every CLI command has a direct, equivalent function in the Python SDK.
+
+| Command | Python API | Purpose |
+| :--- | :--- | :--- |
+| `kz audit` | `KaizenStat.audit()` | 🔍 Runs a diagnostic sweep (missing values, duplicates, imbalance, dead features). |
+| `kz heal` | `KaizenStat.heal()` | 🩹 Clean, impute, parse datetimes, drop IDs, and encode string labels. |
+| `kz benchmark` | `KaizenStat.benchmark()` | 🚀 Automatically trains, optimizes, and ranks model pipelines. |
+| `kz auto` | `KaizenStat.auto()` | ⚡ Orchestrates the entire pipeline in sequence (Audit ➔ Heal ➔ Benchmark). |
+| `kz explain` | `KaizenStat.explain()` | 💬 Generates plain-English diagnostic summaries and model recommendations. |
+| `kz codegen` | `KaizenStat.codegen()` | 📝 Generates standalone, dependency-free Python code for the best model. |
+| `kz export-model` | `KaizenStat.save_model()` | 💾 Trains the top pipeline and saves it directly to a `.joblib` binary. |
+| `kz report` | `KaizenStat.report()` | 📊 Generates a beautiful, interactive HTML profiling report with Chart.js. |
+| `kz serve` | `KaizenStat.serve()` | 🌐 Launches a local web dashboard to explore the data and run predictions. |
+
+---
+
+## 💡 Quick Start Guide
+
+### 1. Python SDK Usage
+
+```python
+from kaizenstat import KaizenStat
+import pandas as pd
+
+# Load your dataset
+df = pd.read_csv("dataset.csv")
+
+# 1. Diagnose issues
+findings = KaizenStat.audit(df, target="target_column")
+
+# 2. Automatically heal dirty data
+clean_df = KaizenStat.heal(df, target="target_column")
+
+# 3. Benchmark models with cross-validation
+leaderboard = KaizenStat.benchmark(clean_df, target="target_column")
+
+# 4. Generate standalone code for reproduction
+KaizenStat.codegen("dataset.csv", target="target_column", output_path="reproduce.py")
+```
+
+### 2. Command Line Interface (CLI)
+
+```bash
+# Get quick help and list commands
+kz --help
+
+# Run the full pipeline in one command
+kz auto dataset.csv --target target_column
+
+# Repair a dataset and save the clean file
+kz heal dataset.csv --target target_column -o cleaned_dataset.csv
+
+# Launch a local Streamlit app to preview and test model performance
+kz serve dataset.csv --target target_column --port 8501
+```
+
+---
+
+## 🧠 Behind the Scenes: Core Engines
+
+### 1. Hardware-Aware Execution
+KaizenStat automatically checks your environment using `detect_device()`. It leverages CUDA on Nvidia GPUs and MPS on Apple Silicon (M1/M2/M3 Mac) to accelerate training when optional dependencies (like `xgboost`) are installed.
+
+### 2. Smart Model Selection
+The benchmarking engine adjusts its logic dynamically based on the dataset properties:
+* **Large Datasets (>100k rows):** Excludes slow estimators (like Gradient Boosting) on standard CPU hosts to prevent compute lockups.
+* **High-Cardinality Categoricals:** Optimizes feature preprocessors and prioritizes tree-based models (Random Forests, Gradient Boosting, XGBoost).
+* **Float Targets:** Detects values with a continuous numeric profile and switches the entire pipeline to regression mode automatically.
+
+### 3. Automatic Imbalance Correction
+During data healing, KaizenStat computes target ratios. If target class distribution has a skew larger than `65% / 35%`, it adjusts model parameters dynamically (e.g. setting `class_weight="balanced"` in scikit-learn estimators).
+
+---
+
+## 🛠 Developer Guide
+
+### Setting up a local workspace
+
+To contribute or run local enhancements:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/masuddarrahaman/KaizenStat-Library.git
+   cd KaizenStat-Library
+   ```
+2. Install the package in editable mode with all optional drivers:
+   ```bash
+   pip install -e ".[all]"
+   ```
+3. Run tests or validation:
+   ```bash
+   python3 -m unittest discover -s tests
+   ```
+
+---
+
+## 📄 License
+
+Distributed under the MIT License. See `LICENSE` for details.

kaizenstat-0.2.2/README.md

@@ -0,0 +1,142 @@
+# 🚀 KaizenStat
+
+[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg?style=flat-square&color=blue)](https://pypi.org/project/kaizenstat/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg?style=flat-square)](https://www.python.org/downloads/)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
+
+**KaizenStat** is a zero-friction, production-grade AutoML, automated data cleaning, and model explanation engine. It allows you to audit datasets, repair data issues, benchmark models with hardware-aware optimization, export standalone pipeline code, and host web-based dashboards—all with a single command or Python import.
+
+---
+
+## 🎯 Core Philosophy
+
+* **Zero-Friction AutoML:** No complex configuration files. Pass your dataset, name your target, and KaizenStat does the rest.
+* **Production Crash-Proofing:** Automatically handles messy real-world data issues: high-cardinality ID columns, datetime parsing, missing inputs, class imbalance, and label encoding.
+* **Explainable AI:** Breaks open the "black box" by generating standalone, human-readable Python training code reproducing the best-found pipeline.
+* **Hybrid Interface:** 100% parity between CLI and Python API.
+
+---
+
+## 📦 Installation
+
+Install the core package with zero heavy external dependencies:
+
+```bash
+pip install kaizenstat
+```
+
+### Optional Drivers & Accelerators
+
+Tailor KaizenStat to your specific workload:
+
+```bash
+pip install kaizenstat[ui]     # Install Streamlit for web dashboards
+pip install kaizenstat[gpu]    # Install XGBoost with GPU/MPS support
+pip install kaizenstat[fast]   # Install Polars for ultra-fast CSV parsing
+pip install kaizenstat[all]    # Install all optional components
+```
+
+---
+
+## ⚔️ CLI & Python API Feature Matrix
+
+KaizenStat is designed around a single unified vocabulary. Every CLI command has a direct, equivalent function in the Python SDK.
+
+| Command | Python API | Purpose |
+| :--- | :--- | :--- |
+| `kz audit` | `KaizenStat.audit()` | 🔍 Runs a diagnostic sweep (missing values, duplicates, imbalance, dead features). |
+| `kz heal` | `KaizenStat.heal()` | 🩹 Clean, impute, parse datetimes, drop IDs, and encode string labels. |
+| `kz benchmark` | `KaizenStat.benchmark()` | 🚀 Automatically trains, optimizes, and ranks model pipelines. |
+| `kz auto` | `KaizenStat.auto()` | ⚡ Orchestrates the entire pipeline in sequence (Audit ➔ Heal ➔ Benchmark). |
+| `kz explain` | `KaizenStat.explain()` | 💬 Generates plain-English diagnostic summaries and model recommendations. |
+| `kz codegen` | `KaizenStat.codegen()` | 📝 Generates standalone, dependency-free Python code for the best model. |
+| `kz export-model` | `KaizenStat.save_model()` | 💾 Trains the top pipeline and saves it directly to a `.joblib` binary. |
+| `kz report` | `KaizenStat.report()` | 📊 Generates a beautiful, interactive HTML profiling report with Chart.js. |
+| `kz serve` | `KaizenStat.serve()` | 🌐 Launches a local web dashboard to explore the data and run predictions. |
+
+---
+
+## 💡 Quick Start Guide
+
+### 1. Python SDK Usage
+
+```python
+from kaizenstat import KaizenStat
+import pandas as pd
+
+# Load your dataset
+df = pd.read_csv("dataset.csv")
+
+# 1. Diagnose issues
+findings = KaizenStat.audit(df, target="target_column")
+
+# 2. Automatically heal dirty data
+clean_df = KaizenStat.heal(df, target="target_column")
+
+# 3. Benchmark models with cross-validation
+leaderboard = KaizenStat.benchmark(clean_df, target="target_column")
+
+# 4. Generate standalone code for reproduction
+KaizenStat.codegen("dataset.csv", target="target_column", output_path="reproduce.py")
+```
+
+### 2. Command Line Interface (CLI)
+
+```bash
+# Get quick help and list commands
+kz --help
+
+# Run the full pipeline in one command
+kz auto dataset.csv --target target_column
+
+# Repair a dataset and save the clean file
+kz heal dataset.csv --target target_column -o cleaned_dataset.csv
+
+# Launch a local Streamlit app to preview and test model performance
+kz serve dataset.csv --target target_column --port 8501
+```
+
+---
+
+## 🧠 Behind the Scenes: Core Engines
+
+### 1. Hardware-Aware Execution
+KaizenStat automatically checks your environment using `detect_device()`. It leverages CUDA on Nvidia GPUs and MPS on Apple Silicon (M1/M2/M3 Mac) to accelerate training when optional dependencies (like `xgboost`) are installed.
+
+### 2. Smart Model Selection
+The benchmarking engine adjusts its logic dynamically based on the dataset properties:
+* **Large Datasets (>100k rows):** Excludes slow estimators (like Gradient Boosting) on standard CPU hosts to prevent compute lockups.
+* **High-Cardinality Categoricals:** Optimizes feature preprocessors and prioritizes tree-based models (Random Forests, Gradient Boosting, XGBoost).
+* **Float Targets:** Detects values with a continuous numeric profile and switches the entire pipeline to regression mode automatically.
+
+### 3. Automatic Imbalance Correction
+During data healing, KaizenStat computes target ratios. If target class distribution has a skew larger than `65% / 35%`, it adjusts model parameters dynamically (e.g. setting `class_weight="balanced"` in scikit-learn estimators).
+
+---
+
+## 🛠 Developer Guide
+
+### Setting up a local workspace
+
+To contribute or run local enhancements:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/masuddarrahaman/KaizenStat-Library.git
+   cd KaizenStat-Library
+   ```
+2. Install the package in editable mode with all optional drivers:
+   ```bash
+   pip install -e ".[all]"
+   ```
+3. Run tests or validation:
+   ```bash
+   python3 -m unittest discover -s tests
+   ```
+
+---
+
+## 📄 License
+
+Distributed under the MIT License. See `LICENSE` for details.

kaizenstat-0.2.2/kaizenstat/__init__.py

@@ -0,0 +1,6 @@
+from .core import KaizenStat, DataEngine, detect_device
+
+__version__ = "0.2.2"
+
+__all__ = ["KaizenStat", "DataEngine", "detect_device", "__version__"]
+

{kaizenstat-0.2.0 → kaizenstat-0.2.2}/kaizenstat/core.py

@@ -650,6 +650,11 @@ class KaizenStat:
         """
         df = DataEngine.load(data)
         data_path = data if isinstance(data, str) else "data.csv"
+        if isinstance(data, pd.DataFrame):
+            try:
+                data.to_csv("data.csv", index=False)
+            except Exception:
+                pass
 
         # Run pipeline to determine best model
         df_clean = KaizenStat.heal(df, target)

kaizenstat-0.2.2/kaizenstat.egg-info/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: kaizenstat
+Version: 0.2.2
+Summary: Zero-friction AutoML + Data Cleaning Toolkit
+Author: Masuddar Rahman
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: scikit-learn
+Requires-Dist: rich
+Requires-Dist: joblib
+Provides-Extra: ui
+Requires-Dist: streamlit; extra == "ui"
+Provides-Extra: gpu
+Requires-Dist: xgboost; extra == "gpu"
+Provides-Extra: fast
+Requires-Dist: polars; extra == "fast"
+Provides-Extra: all
+Requires-Dist: streamlit; extra == "all"
+Requires-Dist: xgboost; extra == "all"
+Requires-Dist: polars; extra == "all"
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🚀 KaizenStat
+
+[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg?style=flat-square&color=blue)](https://pypi.org/project/kaizenstat/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg?style=flat-square)](https://www.python.org/downloads/)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
+
+**KaizenStat** is a zero-friction, production-grade AutoML, automated data cleaning, and model explanation engine. It allows you to audit datasets, repair data issues, benchmark models with hardware-aware optimization, export standalone pipeline code, and host web-based dashboards—all with a single command or Python import.
+
+---
+
+## 🎯 Core Philosophy
+
+* **Zero-Friction AutoML:** No complex configuration files. Pass your dataset, name your target, and KaizenStat does the rest.
+* **Production Crash-Proofing:** Automatically handles messy real-world data issues: high-cardinality ID columns, datetime parsing, missing inputs, class imbalance, and label encoding.
+* **Explainable AI:** Breaks open the "black box" by generating standalone, human-readable Python training code reproducing the best-found pipeline.
+* **Hybrid Interface:** 100% parity between CLI and Python API.
+
+---
+
+## 📦 Installation
+
+Install the core package with zero heavy external dependencies:
+
+```bash
+pip install kaizenstat
+```
+
+### Optional Drivers & Accelerators
+
+Tailor KaizenStat to your specific workload:
+
+```bash
+pip install kaizenstat[ui]     # Install Streamlit for web dashboards
+pip install kaizenstat[gpu]    # Install XGBoost with GPU/MPS support
+pip install kaizenstat[fast]   # Install Polars for ultra-fast CSV parsing
+pip install kaizenstat[all]    # Install all optional components
+```
+
+---
+
+## ⚔️ CLI & Python API Feature Matrix
+
+KaizenStat is designed around a single unified vocabulary. Every CLI command has a direct, equivalent function in the Python SDK.
+
+| Command | Python API | Purpose |
+| :--- | :--- | :--- |
+| `kz audit` | `KaizenStat.audit()` | 🔍 Runs a diagnostic sweep (missing values, duplicates, imbalance, dead features). |
+| `kz heal` | `KaizenStat.heal()` | 🩹 Clean, impute, parse datetimes, drop IDs, and encode string labels. |
+| `kz benchmark` | `KaizenStat.benchmark()` | 🚀 Automatically trains, optimizes, and ranks model pipelines. |
+| `kz auto` | `KaizenStat.auto()` | ⚡ Orchestrates the entire pipeline in sequence (Audit ➔ Heal ➔ Benchmark). |
+| `kz explain` | `KaizenStat.explain()` | 💬 Generates plain-English diagnostic summaries and model recommendations. |
+| `kz codegen` | `KaizenStat.codegen()` | 📝 Generates standalone, dependency-free Python code for the best model. |
+| `kz export-model` | `KaizenStat.save_model()` | 💾 Trains the top pipeline and saves it directly to a `.joblib` binary. |
+| `kz report` | `KaizenStat.report()` | 📊 Generates a beautiful, interactive HTML profiling report with Chart.js. |
+| `kz serve` | `KaizenStat.serve()` | 🌐 Launches a local web dashboard to explore the data and run predictions. |
+
+---
+
+## 💡 Quick Start Guide
+
+### 1. Python SDK Usage
+
+```python
+from kaizenstat import KaizenStat
+import pandas as pd
+
+# Load your dataset
+df = pd.read_csv("dataset.csv")
+
+# 1. Diagnose issues
+findings = KaizenStat.audit(df, target="target_column")
+
+# 2. Automatically heal dirty data
+clean_df = KaizenStat.heal(df, target="target_column")
+
+# 3. Benchmark models with cross-validation
+leaderboard = KaizenStat.benchmark(clean_df, target="target_column")
+
+# 4. Generate standalone code for reproduction
+KaizenStat.codegen("dataset.csv", target="target_column", output_path="reproduce.py")
+```
+
+### 2. Command Line Interface (CLI)
+
+```bash
+# Get quick help and list commands
+kz --help
+
+# Run the full pipeline in one command
+kz auto dataset.csv --target target_column
+
+# Repair a dataset and save the clean file
+kz heal dataset.csv --target target_column -o cleaned_dataset.csv
+
+# Launch a local Streamlit app to preview and test model performance
+kz serve dataset.csv --target target_column --port 8501
+```
+
+---
+
+## 🧠 Behind the Scenes: Core Engines
+
+### 1. Hardware-Aware Execution
+KaizenStat automatically checks your environment using `detect_device()`. It leverages CUDA on Nvidia GPUs and MPS on Apple Silicon (M1/M2/M3 Mac) to accelerate training when optional dependencies (like `xgboost`) are installed.
+
+### 2. Smart Model Selection
+The benchmarking engine adjusts its logic dynamically based on the dataset properties:
+* **Large Datasets (>100k rows):** Excludes slow estimators (like Gradient Boosting) on standard CPU hosts to prevent compute lockups.
+* **High-Cardinality Categoricals:** Optimizes feature preprocessors and prioritizes tree-based models (Random Forests, Gradient Boosting, XGBoost).
+* **Float Targets:** Detects values with a continuous numeric profile and switches the entire pipeline to regression mode automatically.
+
+### 3. Automatic Imbalance Correction
+During data healing, KaizenStat computes target ratios. If target class distribution has a skew larger than `65% / 35%`, it adjusts model parameters dynamically (e.g. setting `class_weight="balanced"` in scikit-learn estimators).
+
+---
+
+## 🛠 Developer Guide
+
+### Setting up a local workspace
+
+To contribute or run local enhancements:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/masuddarrahaman/KaizenStat-Library.git
+   cd KaizenStat-Library
+   ```
+2. Install the package in editable mode with all optional drivers:
+   ```bash
+   pip install -e ".[all]"
+   ```
+3. Run tests or validation:
+   ```bash
+   python3 -m unittest discover -s tests
+   ```
+
+---
+
+## 📄 License
+
+Distributed under the MIT License. See `LICENSE` for details.

{kaizenstat-0.2.0 → kaizenstat-0.2.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="kaizenstat",
-    version="0.2.0",
+    version="0.2.2",
     author="Masuddar Rahman",
     description="Zero-friction AutoML + Data Cleaning Toolkit",
     long_description=open("README.md").read() if open("README.md") else "",

kaizenstat-0.2.0/PKG-INFO

@@ -1,176 +0,0 @@
-Metadata-Version: 2.4
-Name: kaizenstat
-Version: 0.2.0
-Summary: Zero-friction AutoML + Data Cleaning Toolkit
-Author: Masuddar Rahman
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: pandas
-Requires-Dist: numpy
-Requires-Dist: scikit-learn
-Requires-Dist: rich
-Requires-Dist: joblib
-Provides-Extra: ui
-Requires-Dist: streamlit; extra == "ui"
-Provides-Extra: gpu
-Requires-Dist: xgboost; extra == "gpu"
-Provides-Extra: fast
-Requires-Dist: polars; extra == "fast"
-Provides-Extra: all
-Requires-Dist: streamlit; extra == "all"
-Requires-Dist: xgboost; extra == "all"
-Requires-Dist: polars; extra == "all"
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# 🚀 KaizenStat
-
-[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg)](https://pypi.org/project/kaizenstat/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
-
-**KaizenStat** is a zero-friction data validation, automatic cleaning, and AutoML benchmarking toolkit. Diagnose datasets instantly, auto-repair issues, train baseline models, generate standalone Python code, and launch interactive dashboards — all in one command.
-
----
-
-## ✨ Features
-
-| Command | What it does |
-|---|---|
-| `kz audit` | 🔍 Diagnostic sweep — duplicates, NaNs, infs, ID columns, imbalance |
-| `kz heal` | 🩹 Auto-clean — impute, deduplicate, drop dead columns |
-| `kz benchmark` | 🚀 Train & rank ML models with cross-validation |
-| `kz auto` | ⚡ Full pipeline in one command (audit → heal → benchmark) |
-| `kz explain` | 💬 Plain-English summary of findings and recommendations |
-| `kz codegen` | 📝 Generate a standalone Python training script |
-| `kz export-model` | 💾 Train best model and save to `.joblib` |
-| `kz report` | 📊 Generate interactive HTML report with charts |
-| `kz serve` | 🌐 Launch interactive Streamlit web dashboard |
-
----
-
-## 📦 Installation
-
-```bash
-pip install kaizenstat
-```
-
-**Optional extras:**
-
-```bash
-pip install kaizenstat[ui]     # + Streamlit dashboard
-pip install kaizenstat[gpu]    # + XGBoost GPU support
-pip install kaizenstat[fast]   # + Polars fast data loading
-pip install kaizenstat[all]    # everything
-```
-
----
-
-## 🚀 Quick Start
-
-### Python API
-
-```python
-from kaizenstat import KaizenStat
-
-# Full pipeline in one call
-KaizenStat.auto("data.csv", target="price")
-
-# Or step-by-step
-import pandas as pd
-df = pd.read_csv("data.csv")
-
-KaizenStat.audit(df, target="price")
-df_clean = KaizenStat.heal(df, target="price")
-results = KaizenStat.benchmark(df_clean, target="price")
-```
-
-### 💬 Get a Plain-English Explanation
-
-```python
-KaizenStat.explain("data.csv", target="price")
-```
-
-### 📝 Generate Standalone Code
-
-```python
-KaizenStat.codegen("data.csv", target="price", output_path="deploy.py")
-```
-
-### 💾 Export & Load Models
-
-```python
-# Train + save
-KaizenStat.auto("data.csv", target="price")
-KaizenStat.save_model(path="model.joblib")
-
-# Load later
-pipeline = KaizenStat.load_model("model.joblib")
-predictions = pipeline.predict(new_data)
-```
-
-### 📊 Generate HTML Report
-
-```python
-KaizenStat.report("data.csv", target="price", output_path="report.html")
-```
-
-### 🌐 Launch Web Dashboard
-
-```python
-KaizenStat.serve("data.csv", target="price")
-```
-
----
-
-## 💻 CLI Usage
-
-```bash
-# Diagnostic sweep
-kz audit data.csv --target price
-
-# Auto-clean dataset
-kz heal data.csv --target price -o clean.csv
-
-# Train & rank models
-kz benchmark clean.csv --target price
-
-# Full pipeline
-kz auto data.csv --target price
-
-# Plain-English summary
-kz explain data.csv --target price
-
-# Generate standalone Python script
-kz codegen data.csv --target price -o deploy.py
-
-# Train best model and export
-kz export-model data.csv --target price -o model.joblib
-
-# Generate interactive HTML report
-kz report data.csv --target price -o report.html
-
-# Launch web dashboard
-kz serve data.csv --target price
-```
-
----
-
-## 🛠 Development
-
-```bash
-git clone https://github.com/yourusername/kaizenstat.git
-cd kaizenstat
-pip install -e ".[all]"
-```
-
----
-
-## 📄 License
-
-Distributed under the MIT License.

kaizenstat-0.2.0/README.md

@@ -1,146 +0,0 @@
-# 🚀 KaizenStat
-
-[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg)](https://pypi.org/project/kaizenstat/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
-
-**KaizenStat** is a zero-friction data validation, automatic cleaning, and AutoML benchmarking toolkit. Diagnose datasets instantly, auto-repair issues, train baseline models, generate standalone Python code, and launch interactive dashboards — all in one command.
-
----
-
-## ✨ Features
-
-| Command | What it does |
-|---|---|
-| `kz audit` | 🔍 Diagnostic sweep — duplicates, NaNs, infs, ID columns, imbalance |
-| `kz heal` | 🩹 Auto-clean — impute, deduplicate, drop dead columns |
-| `kz benchmark` | 🚀 Train & rank ML models with cross-validation |
-| `kz auto` | ⚡ Full pipeline in one command (audit → heal → benchmark) |
-| `kz explain` | 💬 Plain-English summary of findings and recommendations |
-| `kz codegen` | 📝 Generate a standalone Python training script |
-| `kz export-model` | 💾 Train best model and save to `.joblib` |
-| `kz report` | 📊 Generate interactive HTML report with charts |
-| `kz serve` | 🌐 Launch interactive Streamlit web dashboard |
-
----
-
-## 📦 Installation
-
-```bash
-pip install kaizenstat
-```
-
-**Optional extras:**
-
-```bash
-pip install kaizenstat[ui]     # + Streamlit dashboard
-pip install kaizenstat[gpu]    # + XGBoost GPU support
-pip install kaizenstat[fast]   # + Polars fast data loading
-pip install kaizenstat[all]    # everything
-```
-
----
-
-## 🚀 Quick Start
-
-### Python API
-
-```python
-from kaizenstat import KaizenStat
-
-# Full pipeline in one call
-KaizenStat.auto("data.csv", target="price")
-
-# Or step-by-step
-import pandas as pd
-df = pd.read_csv("data.csv")
-
-KaizenStat.audit(df, target="price")
-df_clean = KaizenStat.heal(df, target="price")
-results = KaizenStat.benchmark(df_clean, target="price")
-```
-
-### 💬 Get a Plain-English Explanation
-
-```python
-KaizenStat.explain("data.csv", target="price")
-```
-
-### 📝 Generate Standalone Code
-
-```python
-KaizenStat.codegen("data.csv", target="price", output_path="deploy.py")
-```
-
-### 💾 Export & Load Models
-
-```python
-# Train + save
-KaizenStat.auto("data.csv", target="price")
-KaizenStat.save_model(path="model.joblib")
-
-# Load later
-pipeline = KaizenStat.load_model("model.joblib")
-predictions = pipeline.predict(new_data)
-```
-
-### 📊 Generate HTML Report
-
-```python
-KaizenStat.report("data.csv", target="price", output_path="report.html")
-```
-
-### 🌐 Launch Web Dashboard
-
-```python
-KaizenStat.serve("data.csv", target="price")
-```
-
----
-
-## 💻 CLI Usage
-
-```bash
-# Diagnostic sweep
-kz audit data.csv --target price
-
-# Auto-clean dataset
-kz heal data.csv --target price -o clean.csv
-
-# Train & rank models
-kz benchmark clean.csv --target price
-
-# Full pipeline
-kz auto data.csv --target price
-
-# Plain-English summary
-kz explain data.csv --target price
-
-# Generate standalone Python script
-kz codegen data.csv --target price -o deploy.py
-
-# Train best model and export
-kz export-model data.csv --target price -o model.joblib
-
-# Generate interactive HTML report
-kz report data.csv --target price -o report.html
-
-# Launch web dashboard
-kz serve data.csv --target price
-```
-
----
-
-## 🛠 Development
-
-```bash
-git clone https://github.com/yourusername/kaizenstat.git
-cd kaizenstat
-pip install -e ".[all]"
-```
-
----
-
-## 📄 License
-
-Distributed under the MIT License.

kaizenstat-0.2.0/kaizenstat/__init__.py

@@ -1,3 +0,0 @@
-from .core import KaizenStat, DataEngine, detect_device
-
-__all__ = ["KaizenStat", "DataEngine", "detect_device"]

kaizenstat-0.2.0/kaizenstat.egg-info/PKG-INFO

@@ -1,176 +0,0 @@
-Metadata-Version: 2.4
-Name: kaizenstat
-Version: 0.2.0
-Summary: Zero-friction AutoML + Data Cleaning Toolkit
-Author: Masuddar Rahman
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: pandas
-Requires-Dist: numpy
-Requires-Dist: scikit-learn
-Requires-Dist: rich
-Requires-Dist: joblib
-Provides-Extra: ui
-Requires-Dist: streamlit; extra == "ui"
-Provides-Extra: gpu
-Requires-Dist: xgboost; extra == "gpu"
-Provides-Extra: fast
-Requires-Dist: polars; extra == "fast"
-Provides-Extra: all
-Requires-Dist: streamlit; extra == "all"
-Requires-Dist: xgboost; extra == "all"
-Requires-Dist: polars; extra == "all"
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# 🚀 KaizenStat
-
-[![PyPI Version](https://img.shields.io/pypi/v/kaizenstat.svg)](https://pypi.org/project/kaizenstat/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
-
-**KaizenStat** is a zero-friction data validation, automatic cleaning, and AutoML benchmarking toolkit. Diagnose datasets instantly, auto-repair issues, train baseline models, generate standalone Python code, and launch interactive dashboards — all in one command.
-
----
-
-## ✨ Features
-
-| Command | What it does |
-|---|---|
-| `kz audit` | 🔍 Diagnostic sweep — duplicates, NaNs, infs, ID columns, imbalance |
-| `kz heal` | 🩹 Auto-clean — impute, deduplicate, drop dead columns |
-| `kz benchmark` | 🚀 Train & rank ML models with cross-validation |
-| `kz auto` | ⚡ Full pipeline in one command (audit → heal → benchmark) |
-| `kz explain` | 💬 Plain-English summary of findings and recommendations |
-| `kz codegen` | 📝 Generate a standalone Python training script |
-| `kz export-model` | 💾 Train best model and save to `.joblib` |
-| `kz report` | 📊 Generate interactive HTML report with charts |
-| `kz serve` | 🌐 Launch interactive Streamlit web dashboard |
-
----
-
-## 📦 Installation
-
-```bash
-pip install kaizenstat
-```
-
-**Optional extras:**
-
-```bash
-pip install kaizenstat[ui]     # + Streamlit dashboard
-pip install kaizenstat[gpu]    # + XGBoost GPU support
-pip install kaizenstat[fast]   # + Polars fast data loading
-pip install kaizenstat[all]    # everything
-```
-
----
-
-## 🚀 Quick Start
-
-### Python API
-
-```python
-from kaizenstat import KaizenStat
-
-# Full pipeline in one call
-KaizenStat.auto("data.csv", target="price")
-
-# Or step-by-step
-import pandas as pd
-df = pd.read_csv("data.csv")
-
-KaizenStat.audit(df, target="price")
-df_clean = KaizenStat.heal(df, target="price")
-results = KaizenStat.benchmark(df_clean, target="price")
-```
-
-### 💬 Get a Plain-English Explanation
-
-```python
-KaizenStat.explain("data.csv", target="price")
-```
-
-### 📝 Generate Standalone Code
-
-```python
-KaizenStat.codegen("data.csv", target="price", output_path="deploy.py")
-```
-
-### 💾 Export & Load Models
-
-```python
-# Train + save
-KaizenStat.auto("data.csv", target="price")
-KaizenStat.save_model(path="model.joblib")
-
-# Load later
-pipeline = KaizenStat.load_model("model.joblib")
-predictions = pipeline.predict(new_data)
-```
-
-### 📊 Generate HTML Report
-
-```python
-KaizenStat.report("data.csv", target="price", output_path="report.html")
-```
-
-### 🌐 Launch Web Dashboard
-
-```python
-KaizenStat.serve("data.csv", target="price")
-```
-
----
-
-## 💻 CLI Usage
-
-```bash
-# Diagnostic sweep
-kz audit data.csv --target price
-
-# Auto-clean dataset
-kz heal data.csv --target price -o clean.csv
-
-# Train & rank models
-kz benchmark clean.csv --target price
-
-# Full pipeline
-kz auto data.csv --target price
-
-# Plain-English summary
-kz explain data.csv --target price
-
-# Generate standalone Python script
-kz codegen data.csv --target price -o deploy.py
-
-# Train best model and export
-kz export-model data.csv --target price -o model.joblib
-
-# Generate interactive HTML report
-kz report data.csv --target price -o report.html
-
-# Launch web dashboard
-kz serve data.csv --target price
-```
-
----
-
-## 🛠 Development
-
-```bash
-git clone https://github.com/yourusername/kaizenstat.git
-cd kaizenstat
-pip install -e ".[all]"
-```
-
----
-
-## 📄 License
-
-Distributed under the MIT License.