💫 PriceGenie AI

🤖 The Smart Way to Master Product Pricing!

PriceGenie AI helps businesses make data-driven pricing decisions using machine learning. With a sleek Streamlit dashboard, a powerful Flask backend, and top-tier ML models (LightGBM, XGBoost, CatBoost) — it gives real-time pricing insights to boost profits and stay competitive. 💹

---

🎬 Demo

---

✨ Key Features

🚀 Multi-Model Powerhouse — Uses LightGBM, XGBoost, and CatBoost for accurate predictions. 📊 Interactive Dashboard — Explore trends, visualize metrics, and get instant insights. 🧠 AI-Powered API — Flask REST API for seamless integration with your systems. 📈 Performance Metrics — Compare models and track historical improvements. ⚡ Real-time Predictions — Get instant pricing suggestions for your products. 🛠️ Simple Setup — Easy to install, run, and extend.

---

🗂️ Project Structure

PriceGenie-AI/
├── models/                # Trained model files
├── python-backend/        # Flask API & backend logic
├── streamlit_app.py       # Streamlit dashboard UI
├── Amazon_ML_Multi_Algorithm_Training.ipynb  # Model training notebook
├── requirements.txt
├── start-backend.bat
├── start-streamlit.bat
└── README.md

📁 Folders may evolve as development continues.

---

🧩 Tech Stack

Layer	Technology
🎨 Frontend	Streamlit
⚙️ Backend	Flask (Python)
🤖 ML Models	LightGBM · XGBoost · CatBoost · scikit-learn
📊 Visualization	Plotly
📚 Data Handling	pandas · numpy

---

🪄 Quick Setup

1️⃣ Clone the Repository

git clone https://github.com/SQUADRON-LEADER/PriceGenie-AI.git
cd PriceGenie-AI

2️⃣ Create a Virtual Environment

Windows:

python -m venv .venv
.venv\Scripts\activate

macOS/Linux:

python3 -m venv .venv
source .venv/bin/activate

3️⃣ Install Dependencies

pip install -r python-backend/requirements.txt

4️⃣ Run the App

Windows:

start-streamlit.bat   # Starts Streamlit Dashboard
start-backend.bat     # Starts Flask API

macOS/Linux:

streamlit run streamlit_app.py --server.port 8502
cd python-backend && python app.py

🌐 Access Points

• 📊 Dashboard → http://localhost:8502
• 🧠 API → http://localhost:5000
• ❤️ Health Check → http://localhost:5000/health

---

🧠 How It Works

🎛️ Streamlit Dashboard

• Upload product data 📂
• Explore model results 🔍
• Get recommended prices 💰
• Export insights for business use 📤

🔌 Flask API Example

POST /predict
{
  "product_id": "SKU123",
  "features": { "cost": 10.5, "category": "electronics", "demand_score": 0.8 }
}

Response:

{
  "predicted_price": 14.99,
  "model": "ensemble",
  "confidence": 0.87
}

---

📘 Model Training

• All training experiments are in: Amazon_ML_Multi_Algorithm_Training.ipynb
• Models are saved in /models/ for serving 🧾

💡 Steps to Train:

1. Clean your data 🧹
2. Feature engineering 🔧
3. Train models 🧠
4. Evaluate performance 📈
5. Export models 📦

---

⚙️ Configuration

• Store secrets & keys in a .env file 🔒
• Use environment variables for deployment 🌍

---

🧪 Testing

Recommended with pytest ✅

• API route tests 🧩
• Model output validation 🧠
• Data preprocessing checks 🧾

---

☁️ Deployment

Options to deploy easily:

• 🐳 Docker containers
• ☁️ Streamlit Cloud / Render / AWS
• 🔄 CI/CD with GitHub Actions

---

🤝 Contributing

💡 Want to help improve PriceGenie?

1. Fork the repo 🍴
2. Create a feature branch 🌱
3. Submit a pull request ✨

📝 Please include clear commit messages and update docs as needed.

---

📜 License

MIT License

Copyright (c) 2025 Aayush Kumar

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

🌟 Acknowledgements

🙏 Thanks to these amazing tools:

• LightGBM · XGBoost · CatBoost · scikit-learn
• Streamlit · Flask · Plotly

---

💬 Let PriceGenie AI make your pricing smarter, faster, and fairer! ⚡