smarteda

Automate your Exploratory Data Analysis in one line of code.

smarteda is a Python package that eliminates repetitive EDA code. Instead of writing dozens of pandas lines every time you get a new dataset, smarteda analyzes it instantly, gives smart suggestions, and generates a full HTML report.

Installation

pip install smarteda

Quick Start

import pandas as pd
import smarteda

df = pd.read_csv("your_data.csv")

# Run everything at once
smarteda.analyze(df)

# Or generate a full HTML report
smarteda.report(df, output_file="report.html")

Functions

Examples

Basic EDA

smarteda.basic_eda(df)        # default 5 rows
smarteda.basic_eda(df, n=10)  # show 10 rows

Missing Values

smarteda.missing(df)
# Output:
#        Count  Percentage
# age       21       10.24
# salary    15        7.32
# Suggestion: age → Fill with mean | salary → Fill with median

Outlier Detection

smarteda.outliers(df)
# Output:
# salary → 8 outliers (3.9%) using IQR
# score  → 1 outliers (0.49%) using Z-score
# Multi-dimensional (Isolation Forest) → 39 outliers (19.02%)

Smart Suggestions + ML Score

smarteda.suggestions(df)
# Output:
# ⚠️  Column 'salary' is highly skewed → apply log transformation
# ⚠️  'height' and 'weight' are 94% correlated → drop one
# ✅  No duplicates found
# 💡 ML Readiness Score: 87 / 100

Auto Clean

# Safe — keeps original df intact
clean_df = smarteda.clean(df)

# Modifies df directly
smarteda.clean(df, inplace=True)

HTML Report

smarteda.report(df, output_file="my_report.html")
# Opens in browser — no extra tools needed

What smarteda Detects Automatically

• ✅ Missing values with fill strategy per column
• ✅ Duplicate rows
• ✅ Outliers using 3 methods (IQR, Z-score, Isolation Forest)
• ✅ Skewed distributions with transformation suggestions
• ✅ Multicollinearity between features
• ✅ High cardinality categorical columns
• ✅ Wrong data types (numbers stored as strings, dates as objects)
• ✅ Constant columns (useless for ML)
• ✅ Time series trends, seasonality, and gaps
• ✅ ML Readiness Score out of 100

Dependencies

• pandas
• numpy
• matplotlib
• seaborn
• scipy
• scikit-learn
• jinja2
• missingno

License

MIT License