README.md

metadata

title: SmartSeg AI
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.9.1
python_version: 3.11
app_file: app.py

🤖 SmartSeg AI – Advanced Customer Segmentation Dashboard

SmartSeg AI is a professional machine learning application that uses K-Means clustering to segment customers based on their demographic and spending behavior. It provides real-time predictions and interactive visualizations to help businesses understand their customer base better.

🚀 Features

• K-Means Clustering: Robust segmentation using industry-standard algorithms.
• Real-time Prediction: Instant classification of new customer data.
• Interactive Dashboards: Visualized using Plotly and Gradio.
• PCA Analysis: 2D projection of high-dimensional data for better cluster visibility.
• Business Insights: Actionable advice based on customer segments.

📊 Dataset

The project uses the Mall Customer Segmentation dataset, which includes:

• Gender
• Age
• Annual Income (k$)
• Spending Score (1-100)

🛠️ Installation & Local Setup

1. Clone the repository:

   git clone https://huggingface.co/spaces/your-username/smartseg-ai
   cd smartseg-ai
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Train the model (Optional):

   python train.py
   

4. Run the App:

   python app.py
   

📂 Project Structure

smartseg-ai/
│
├── data/
│   ├── Mall_Customers.csv        # Raw dataset
│   └── clustered_customers.csv  # Data with cluster labels
├── model/
│   ├── kmeans.pkl               # Trained K-Means model
│   ├── scaler.pkl               # StandardScaler object
│   └── label_encoder.pkl        # LabelEncoder for Gender
├── outputs/
│   └── elbow_plot.png           # Elbow method visualization
├── train.py                     # Model training script
├── app.py                       # Gradio dashboard application
├── requirements.txt             # Python dependencies
└── README.md                    # Project documentation

🤖 Hugging Face Deployment

The live version of this app is hosted on Hugging Face Spaces.

View the Live Demo: https://huggingface.co/spaces/mallelamanoj75/SmartSeg-AI

How to Deploy Your Own

1. Create a new Space with the Gradio SDK.
2. Upload all files (including model/ and data/ directories).
3. The app will automatically build and run.

📸 Screenshots

(Add screenshots here after running the app)

---

Built with ❤️ by Manojkumar