🚀 MasterClean

Enterprise AI-powered Data Cleaning, Validation, Anomaly Detection & Analytics Toolkit for Python.

MasterClean automates:

• data cleaning
• preprocessing
• validation
• profiling
• anomaly detection
• AI insights
• visualization
• reporting
• analytics

using powerful CLI commands and Python APIs.

Designed for:

• Data Analysts
• Data Scientists
• ML Engineers
• Researchers
• Students
• Automation Workflows

---

✨ Features

🧹 Advanced Data Cleaning

• Missing value handling
• Duplicate row removal
• Empty string cleanup
• Whitespace cleanup
• Column standardization
• Datetime conversion
• Smart categorical filling
• Automatic preprocessing pipeline

---

⚡ Datatype Optimization

• Integer optimization
• Float optimization
• Boolean conversion
• Category optimization
• Datetime detection
• Memory usage reduction

---

🛡 Advanced Validation Engine

• Negative value detection
• Invalid boolean detection
• Email validation
• Phone validation
• Duplicate percentage warnings
• Missing value percentage analysis
• Mixed datatype detection

---

🚨 AI-Powered Anomaly Detection

• Z-score anomaly detection
• Salary anomaly detection
• Sales spike detection
• Demographic anomaly detection
• Interactive anomaly visualization
• Enterprise anomaly summaries

---

🧠 AI Insights Engine

• Dataset risk scoring
• Dataset quality grading
• Cardinality detection
• Identifier column detection
• Correlation intelligence
• ML readiness recommendations
• Automated contextual suggestions

---

📊 Advanced Profiling

• Dataset health score
• Missing value summaries
• Datatype analytics
• Memory usage analysis
• Numeric statistics
• Categorical summaries
• Dataset overview metrics

---

📈 Interactive Visualization Engine

• Plotly dashboards
• Histograms
• Boxplots
• Pie charts
• Correlation heatmaps
• Missing value charts
• Line charts
• Interactive anomaly scatter plots

---

📄 Reporting System

• Unified HTML analytics dashboard
• Validation summaries
• AI insight cards
• Risk overview cards
• Interactive visualizations
• Automated report generation

---

🖥 Professional CLI Toolkit

MasterClean supports multiple enterprise commands.

---

🚀 Full Automated Pipeline

masterclean clean data.csv

Runs:

• cleaning
• optimization
• anomaly detection
• validation
• profiling
• visualization
• AI analysis
• reporting
• exporting

---

🛡 Validation Only

masterclean validate data.csv

---

📊 Dataset Profiling

masterclean profile data.csv

---

📈 Dashboard Generation

masterclean dashboard data.csv

---

🚨 Anomaly Detection

masterclean anomaly data.csv

---

🔖 Show Version

masterclean version

---

📦 Installation

Install from PyPI

pip install masterclean

---

⬆ Upgrade to Latest Version

pip install --upgrade masterclean

---

🐍 Python Usage

from masterclean import *

df, file_extension = read_file("data.csv")

df = clean_data(df)

df = optimize_dtypes(df)

warnings = validate_data(df)

profile = generate_profile(df)

charts = generate_charts(df)

ai_insights = generate_ai_insights(df)

anomalies = detect_anomalies(df)

generate_report(
    df=df,
    warnings=warnings,
    profile=profile,
    charts=charts,
    ai_insights=ai_insights,
    anomalies=anomalies
)

export_data(
    df,
    "cleaned_data",
    file_extension
)

---

📂 Supported File Formats

Format	Supported
CSV	✅
XLSX	✅
XLS	✅

---

🔄 Same-Format Export System

MasterClean automatically preserves output format.

Input	Output
CSV	cleaned_data.csv
XLSX	cleaned_data.xlsx
XLS	cleaned_data.xlsx

---

📊 Example Validation Output

VALIDATION WARNINGS
========================================

⚠ Negative values found in 'salary' (3 rows)

⚠ Invalid email values found in 'email' (5 rows)

⚠ High duplicate rows detected (14.2%)

⚠ Mixed datatypes detected in 'age'

---

🚨 Example Anomaly Output

ANOMALY DETECTION
========================================

🧠 Anomaly Summary:
3 anomalies in 'salary',
2 anomalies in 'sales'.

🚨 'salary' contains 3 anomalies.
💡 Possible payroll anomaly detected.

🚨 'sales' contains 2 anomalies.
💡 Abnormal sales spike detected.

---

🏗 Enterprise Architecture

Read
   ↓
Clean
   ↓
Optimize
   ↓
Detect Anomalies
   ↓
Validate
   ↓
Profile
   ↓
Generate AI Insights
   ↓
Visualize
   ↓
Generate Dashboard
   ↓
Export

---

📸 Dashboard Screenshots

AI Dashboard

Add screenshot here:

screenshots/dashboard.png

---

Anomaly Detection

Add screenshot here:

screenshots/anomalies.png

---

Interactive Charts

Add screenshot here:

screenshots/charts.png

---

📁 Project Structure

masterclean/
│
├── preprocessing/
├── validation/
├── profiling/
├── visualization/
├── ml/
├── reports/
├── cli.py
├── __init__.py
│
tests/
│
README.md
pyproject.toml
requirements.txt
LICENSE

---

🧪 Testing

Run tests using:

python -m pytest

---

🔄 CI/CD

MasterClean uses GitHub Actions for:

• automated testing
• dependency validation
• continuous integration

---

🛣 Roadmap

Future improvements planned:

• Streamlit dashboard
• FastAPI integration
• AutoML recommendations
• Schema validation engine
• Large dataset optimization
• Cloud deployment support
• Plugin architecture
• Real-time analytics dashboards

---

🤝 Contributing

Contributions are welcome.

You can:

• report bugs
• suggest features
• improve documentation
• submit pull requests

---

📄 License

MIT License

---

👨‍💻 Author

Mohamed Faisal Maraicar N

GitHub:

https://github.com/MohamedFaisal-11/masterclean