Skip to content

Latest commit

ย 

History

25 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– DataMind AI

An intelligent and interactive workspace for automated Exploratory Data Analysis, AI-powered data-quality recommendations, interactive data cleaning, and cleaned dataset generation.

DataMind AI


๐Ÿ“Œ Overview

DataMind AI is an intelligent data-analysis and data-cleaning platform designed to simplify the process of understanding, diagnosing, and improving datasets.

Instead of manually performing every stage of the data-analysis workflow, users can upload a CSV dataset and let the platform automatically perform Exploratory Data Analysis (EDA), identify potential data-quality issues, generate AI-powered recommendations, and provide interactive cleaning options.

The platform combines:

  • ๐Ÿ“Š Automated Exploratory Data Analysis
  • ๐Ÿ” Data-quality detection
  • ๐Ÿค– AI-powered recommendations
  • ๐Ÿงน Interactive data cleaning
  • ๐Ÿ“ˆ Statistical analysis
  • ๐Ÿ“‰ Correlation and distribution analysis
  • ๐Ÿ“ฅ Cleaned dataset export

The user remains in control throughout the cleaning process. AI recommendations are presented as suggestions rather than forced transformations.


โœจ Key Features

๐Ÿ“‚ 1. Dataset Upload

Users can upload a CSV dataset directly through the web interface.

The platform provides an initial overview containing:

  • Number of rows
  • Number of columns
  • Column names
  • Dataset preview
  • Basic structural information

๐Ÿ“Š 2. Automated Exploratory Data Analysis

After uploading a dataset, DataMind AI automatically analyzes its structure and characteristics.

Dataset Information

The system identifies:

  • Dataset dimensions
  • Number of records
  • Number of features
  • Data types
  • Numerical columns
  • Categorical columns
  • Unique values

๐Ÿ“‹ 3. Dataset Preview

Users can inspect the uploaded dataset through an interactive preview.

The preview allows users to quickly understand:

  • Column names
  • Data values
  • Dataset structure
  • Sample records

This gives users an immediate understanding of the uploaded data before performing further analysis.


๐Ÿ” 4. Column Summary

The platform analyzes individual columns and provides information such as:

  • Column name
  • Data type
  • Unique values
  • Missing values
  • Column characteristics

This helps users understand the role and quality of each feature.


โš ๏ธ 5. Missing Value Analysis

DataMind AI automatically detects missing values.

For each affected column, the system provides:

  • Missing-value count
  • Missing-value percentage
  • Severity level
  • Visual representation

Example:

Age
177 missing values
19.87%

Cabin
687 missing values
77.10%

This allows users to quickly identify columns that require attention.


๐Ÿ“Œ 6. Duplicate Analysis

The system detects duplicate records within the dataset.

The analysis provides information about:

  • Number of duplicate rows
  • Duplicate percentage

Users can later decide whether duplicate records should be removed during the cleaning process.


โš ๏ธ 7. Invalid Value Analysis

The platform attempts to identify invalid or problematic values.

This provides an additional data-quality check beyond missing-value detection.


๐Ÿ“ˆ 8. Outlier Analysis

Numerical columns are analyzed for potential outliers.

The system identifies columns containing unusual observations and provides cleaning options such as:

  • Remove outliers
  • Cap outliers

This helps reduce the effect of extreme observations on later analysis or machine-learning models.


๐Ÿ“Š 9. Numerical Statistics

DataMind AI provides statistical information for numerical columns, including:

  • Mean
  • Median
  • Standard deviation
  • Minimum
  • Maximum
  • Variance

Example:

Column       Mean    Median    Std Dev    Min    Max
Age          29.7    28        14.53      0.42   80
Fare         32.2    14.45     49.69      0      512.33

๐Ÿ“‰ 10. Correlation Analysis

The platform calculates correlations between numerical variables.

The correlation matrix helps users understand relationships between different features.

It can be used to identify:

  • Positive relationships
  • Negative relationships
  • Weak relationships
  • Strong relationships

๐Ÿ“Š 11. Distribution Analysis

DataMind AI analyzes the distribution of numerical variables.

Distribution analysis can help users identify:

  • Skewed variables
  • Unusual distributions
  • Potentially problematic values
  • Patterns that may require preprocessing

๐Ÿ“ 12. Kurtosis Analysis

The platform also performs kurtosis analysis on numerical variables.

Kurtosis provides additional information about the shape and tail behavior of distributions and complements the outlier and distribution analysis.


๐Ÿค– AI-Powered Data Quality Recommendations

One of the core features of DataMind AI is its AI-powered recommendation system.

After EDA identifies data-quality issues, the system sends relevant analysis information to the AI service.

The AI then generates recommendations for appropriate cleaning strategies.

Possible recommendations include:

  • Mean imputation
  • Median imputation
  • Mode imputation
  • Dropping rows
  • Dropping columns
  • Removing outliers
  • Capping outliers
  • Replacing invalid values
  • Removing duplicate records

Each recommendation can contain:

  • Problem
  • Recommended solution
  • Reason
  • Alternative approach
  • Recommended cleaning method

๐Ÿง  AI Recommendation + Human Decision

DataMind AI follows a human-in-the-loop approach.

The AI does not automatically modify the dataset.

Instead:

EDA Analysis
      โ†“
Detected Issue
      โ†“
AI Recommendation
      โ†“
User Reviews Recommendation
      โ†“
User Selects Cleaning Method
      โ†“
Cleaning Applied

This gives users control over how their dataset is transformed.


๐Ÿงน Interactive Data Cleaning

Users can select cleaning operations for detected issues.

Supported operations include:

Missing Values

  • Fill with mean
  • Fill with median
  • Fill with mode
  • Drop rows
  • Drop columns

Outliers

  • Remove outliers
  • Cap outliers

Invalid Values

  • Replace invalid values with mode
  • Replace invalid values with missing values

Duplicate Records

  • Remove duplicate rows

Multiple operations can be selected before applying the cleaning process.


๐Ÿ“Š Cleaning Results

After cleaning is applied, the platform compares the dataset before and after transformation.

The result includes:

Metric Description
Original Rows Number of rows before cleaning
Cleaned Rows Number of rows after cleaning
Original Columns Number of columns before cleaning
Cleaned Columns Number of columns after cleaning

Example:

Original Rows       : 891
Cleaned Rows        : 889

Original Columns    : 12
Cleaned Columns     : 12

This makes the effect of the selected cleaning operations easy to understand.


๐Ÿ“ฅ Download Cleaned Dataset

After cleaning is completed, users can download the resulting dataset as a CSV file.

The workflow is:

Original Dataset
       โ†“
EDA
       โ†“
Data Quality Analysis
       โ†“
AI Recommendations
       โ†“
User Selected Operations
       โ†“
Cleaning
       โ†“
Cleaned Dataset
       โ†“
Download CSV

The original uploaded dataset remains unchanged.


๐Ÿ–ฅ๏ธ Application Screenshots

๐Ÿ  Dataset Preview

The home page provides an introduction to DataMind AI and allows users to upload their datasets.

Home


๐Ÿงน Data Cleaning

Users can review detected issues and choose appropriate cleaning methods.

Data Cleaning Data Cleaning


๐Ÿค– AI Recommendations

The AI analyzes detected data-quality problems and provides recommendations with explanations and alternatives.

AI Recommendations


๐Ÿ’ก Dataset Health & AI Insights

The AI Insights section provides an overall view of dataset quality, detected issues, severity levels, and recommendations.

Dataset Health


๐Ÿ”ฅ Correlation Analysis

The correlation analysis section provides a correlation matrix and interpretation guide.

Correlation Analysis


๐Ÿ“Š Numerical Statistics

Users can inspect statistical properties of numerical columns.

Numerical Statistics


โš ๏ธ Missing Value Analysis

Missing values are displayed visually with counts and percentages for each column.

Missing Values


๐Ÿ“‘ Dataset Preview

Users can inspect sample records from the uploaded dataset.

Dataset Preview


๐Ÿ—๏ธ System Architecture

DataMind AI follows a frontend-backend architecture.

                         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                         โ”‚      User       โ”‚
                         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                  โ”‚
                                  โ–ผ
                     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                     โ”‚     Next.js Frontend   โ”‚
                     โ”‚                        โ”‚
                     โ”‚ โ€ข Dataset Upload       โ”‚
                     โ”‚ โ€ข Dataset Preview      โ”‚
                     โ”‚ โ€ข EDA Dashboard        โ”‚
                     โ”‚ โ€ข Charts & Statistics  โ”‚
                     โ”‚ โ€ข AI Insights          โ”‚
                     โ”‚ โ€ข Data Cleaning        โ”‚
                     โ”‚ โ€ข Download             โ”‚
                     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚
                           REST API / HTTP
                                 โ”‚
                                 โ–ผ
                     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                     โ”‚     FastAPI Backend    โ”‚
                     โ”‚                        โ”‚
                     โ”‚ โ€ข Upload Processing    โ”‚
                     โ”‚ โ€ข EDA                  โ”‚
                     โ”‚ โ€ข Data Quality         โ”‚
                     โ”‚ โ€ข AI Recommendations  โ”‚
                     โ”‚ โ€ข Data Cleaning        โ”‚
                     โ”‚ โ€ข CSV Generation       โ”‚
                     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚
                 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                 โ”‚                                โ”‚
                 โ–ผ                                โ–ผ
       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
       โ”‚ Data Processing   โ”‚            โ”‚   AI Service     โ”‚
       โ”‚                   โ”‚            โ”‚                  โ”‚
       โ”‚ Pandas            โ”‚            โ”‚ LLM Provider     โ”‚
       โ”‚ Statistics        โ”‚            โ”‚ AI Analysis      โ”‚
       โ”‚ EDA               โ”‚            โ”‚ Recommendations  โ”‚
       โ”‚ Outliers          โ”‚            โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
       โ”‚ Correlation       โ”‚
       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                 โ”‚
                 โ–ผ
       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
       โ”‚ Cleaning Service  โ”‚
       โ”‚                   โ”‚
       โ”‚ Transformations   โ”‚
       โ”‚ Validation        โ”‚
       โ”‚ CSV Generation    โ”‚
       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                 โ”‚
                 โ–ผ
       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
       โ”‚ Cleaned CSV File  โ”‚
       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“ Project Structure

AI-ML-Workspace/
โ”‚
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ main.py
โ”‚   โ”œโ”€โ”€ modules.py
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ”œโ”€โ”€ ai_service.py
โ”‚   โ”‚   โ”œโ”€โ”€ grok_service.py
โ”‚   โ”‚   โ””โ”€โ”€ cleaning_service.py
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ tests/
โ”‚   โ”‚   โ””โ”€โ”€ ...
โ”‚   โ”‚
โ”‚   โ””โ”€โ”€ requirements.txt
โ”‚
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ context/
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ ...
โ”‚
โ”œโ”€โ”€ docs/
โ”‚   โ””โ”€โ”€ screenshots/
โ”‚       โ”œโ”€โ”€ home.png
โ”‚       โ”œโ”€โ”€ data-cleaning.png
โ”‚       โ”œโ”€โ”€ ai-insights.png
โ”‚       โ”œโ”€โ”€ dataset-health.png
โ”‚       โ”œโ”€โ”€ correlation.png
โ”‚       โ”œโ”€โ”€ numerical-statistics.png
โ”‚       โ”œโ”€โ”€ missing-values.png
โ”‚       โ””โ”€โ”€ dataset-preview.png
โ”‚
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ ...

๐Ÿ”ง Technology Stack

Frontend

  • Next.js
  • React
  • Tailwind CSS
  • Framer Motion
  • Recharts
  • Axios

Backend

  • Python
  • FastAPI
  • Pandas
  • NumPy
  • Statistical/data-analysis libraries

AI

  • LLM-based recommendation service
  • AI service abstraction for provider flexibility

Development

  • Git
  • GitHub
  • REST API
  • Environment variables

๐Ÿ”Œ API Endpoints

The backend exposes REST endpoints for the main application workflow.

Endpoint Method Purpose
/ GET Backend health/status
/upload POST Upload and process CSV dataset
/eda POST Generate EDA report
/ai-insights POST Generate AI-powered recommendations
/clean POST Apply selected cleaning operations

The exact endpoint implementation may evolve as the project develops.


โš™๏ธ Installation

Prerequisites

Make sure the following are installed:

  • Python 3.x
  • Node.js
  • npm
  • Git

๐Ÿ Backend Setup

Navigate to the backend directory:

cd backend

Create a virtual environment:

python -m venv venv

Activate it on Windows:

venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Create a .env file inside the backend directory.

Example:

GROQ_API_KEY=your_groq_api_key

Never commit your .env file or API keys to GitHub.


โ–ถ๏ธ Run Backend

From the backend directory:

python -m uvicorn main:app --reload

The backend will normally run at:

http://127.0.0.1:8000

๐ŸŒ Frontend Setup

Navigate to the frontend directory:

cd frontend

Install dependencies:

npm install

Start the development server:

npm run dev

The frontend will normally be available at:

http://localhost:3000

๐Ÿ” Environment Variables

AI services require API credentials.

Example:

GROQ_API_KEY=your_api_key_here

Never commit:

.env

or API keys directly into the source code.

Add environment files to .gitignore.


๐Ÿงช Testing

The project contains a dedicated testing area under the backend.

Potential test categories include:

tests/
โ”‚
โ”œโ”€โ”€ EDA Tests
โ”œโ”€โ”€ Cleaning Tests
โ”œโ”€โ”€ AI Service Tests
โ”œโ”€โ”€ API Tests
โ””โ”€โ”€ Data Validation Tests

Important areas to test include:

  • CSV upload
  • Dataset validation
  • Missing-value detection
  • Duplicate detection
  • Outlier detection
  • Statistical analysis
  • Correlation analysis
  • Cleaning operations
  • AI recommendation generation
  • Invalid operation handling
  • Cleaned CSV generation

๐Ÿ”„ Complete User Workflow

1. Upload Dataset
        โ†“
2. Preview Dataset
        โ†“
3. Run EDA
        โ†“
4. Analyze Dataset Quality
        โ†“
5. Detect Data Issues
        โ†“
6. Generate AI Insights
        โ†“
7. Review AI Recommendations
        โ†“
8. Review Alternative Cleaning Methods
        โ†“
9. Select Cleaning Operations
        โ†“
10. Apply Cleaning
        โ†“
11. Review Cleaning Statistics
        โ†“
12. Download Cleaned Dataset

๐ŸŽฏ Project Goals

DataMind AI aims to make data preprocessing more accessible by combining automated analysis with intelligent recommendations.

The main goals are:

  • Reduce repetitive data-analysis work
  • Help users understand dataset quality
  • Detect common data-quality problems
  • Provide explainable AI recommendations
  • Keep the user involved in cleaning decisions
  • Simplify dataset preprocessing
  • Produce a ready-to-use cleaned dataset

๐Ÿš€ Future Scope

Potential future improvements include:

  • ๐Ÿ”ฎ Automatic machine-learning model selection
  • ๐Ÿค– Natural-language data querying
  • ๐Ÿ“Š More advanced visualizations
  • ๐Ÿง  More intelligent preprocessing recommendations
  • ๐Ÿ“ˆ Automated feature engineering
  • ๐Ÿ† Model performance comparison
  • ๐Ÿ’พ Dataset history and versioning
  • ๐Ÿ‘ฅ User authentication
  • โ˜๏ธ Cloud deployment
  • ๐Ÿ“ฆ Support for additional file formats
  • ๐Ÿ”„ Automated ML pipelines

๐Ÿ”’ Security Considerations

The project should follow secure development practices.

Important considerations include:

  • Keep API keys in environment variables.
  • Never commit .env files.
  • Validate uploaded files.
  • Restrict accepted file types.
  • Validate dataset size.
  • Sanitize user-provided inputs.
  • Validate cleaning operations on the backend.
  • Avoid exposing API credentials to the frontend.

๐Ÿ‘จโ€๐Ÿ’ป Development Workflow

The project is developed using Git and GitHub.

Recommended workflow:

main
 โ”‚
 โ”œโ”€โ”€ feature/frontend
 โ”‚
 โ”œโ”€โ”€ feature/backend
 โ”‚
 โ””โ”€โ”€ feature/ai

Each feature can be developed independently and merged after testing.


๐Ÿ“œ License

This project is developed as an academic/project initiative.

If you plan to distribute the project publicly, add an appropriate open-source license such as MIT License.


โญ Project Summary

DataMind AI brings together automated EDA, data-quality analysis, AI-powered recommendations, and interactive data cleaning into a single workspace.

Instead of simply cleaning data automatically, the platform explains detected problems, recommends possible solutions, and allows the user to decide which transformations should be applied.

Understand Data
      +
Detect Problems
      +
AI Recommendations
      +
User Decisions
      +
Interactive Cleaning
      =
DataMind AI

Analyze โ€ข Understand โ€ข Clean โ€ข Improve

About

DataMind AI is an AI-powered data preparation platform that analyzes datasets, identifies quality issues, recommends cleaning techniques and ML algorithms, and helps users create clean, ML-ready datasets.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages