Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

A Flask-based E-Commerce Targeting System that provides customer segmentation and personalized product recommendations. Users can upload structured interaction data for analysis, receive AI-driven recommendations, and gain insights into user behavior. The application is built with Flask, Pandas, Scikit-Learn, and integrates an interactive web inter

License

Notifications You must be signed in to change notification settings

MHKamel/ecommerce-targeting-system

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📌 E-Commerce Targeting System

Flask Python License

A Flask-based e-commerce targeting system for customer segmentation and personalized product recommendations. Upload structured interaction data, receive AI-driven suggestions, and analyze user behavior.


⚙️ Installation & Setup

🛠 Prerequisites

Ensure you have the following installed:

  • Python 3.8+
  • pip (Python package manager)
  • Git (for cloning the repository)

🔧 Setup Instructions

Create and Activate a Virtual Environment

On Windows:

python -m venv venv
venv\Scripts\activate

On macOS/Linux:

python3 -m venv venv
source venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Set Flask Environment Variables

On Windows:

set FLASK_APP=run.py
set FLASK_ENV=development

On macOS/Linux:

export FLASK_APP=run.py
export FLASK_ENV=development

Run the Application

flask run

🔗 Open http://127.0.0.1:5000 in your browser.

Interact with the Application

  • Upload your dataset.
  • Match required and additional columns.
  • Run the segmentation or recommendation.
  • View results.

Optional: Debug Mode

  • Open config.py.
  • Set DEBUG_MODE = True.

Deactivate the Virtual Environment

deactivate

📄 Required CSV Formats

Recommendation Data Format

visitorid,itemid,event
12345,6789,view
54321,1234,transaction

Segmentation Data Format

visitorid,total_views,total_addtocart,total_purchases
12345,10,2,1
54321,5,1,0

📦 Dependencies

Listed in requirements.txt:

flask
pandas
numpy
scikit-learn
matplotlib
seaborn
scipy

📚 Technologies Used

pip list | grep -E 'flask|pandas|numpy|scikit-learn|matplotlib|seaborn|scipy'

🛠 Troubleshooting

  • Dependencies Not Installing: Ensure correct versions of Python and pip.
  • Server Not Starting: Verify FLASK_APP is set to run.py.
  • File Upload Issues: Ensure the dataset is in CSV format.
# Check Python and pip versions
python --version
pip --version
pip install --upgrade pip

# Check Flask app variable
echo $FLASK_APP

# Check file type
file uploads/sample.csv

🤝 Contributing

  1. Fork the repository
  2. Create a new branch (git checkout -b feature-branch)
  3. Commit your changes (git commit -m "Added new feature")
  4. Push to the branch (git push origin feature-branch)
  5. Create a pull request

📜 License

This project is licensed under the MIT License.


🌟 If you found this project helpful, please ⭐ the repository!

About

A Flask-based E-Commerce Targeting System that provides customer segmentation and personalized product recommendations. Users can upload structured interaction data for analysis, receive AI-driven recommendations, and gain insights into user behavior. The application is built with Flask, Pandas, Scikit-Learn, and integrates an interactive web inter

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
Morty Proxy This is a proxified and sanitized view of the page, visit original site.