Loading repository data…
Loading repository data…
immanas / repository
GrowEasy-- AI-powered retail optimization system that uses real-time Shopify data to generate demand forecasts, automate inventory decisions, and provide actionable insights through a scalable serverless architecture.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
🌟 GrowEasy – AI‑Powered Inventory & Pricing Optimization for Shopify Unlock smart retail management with real-time demand forecasting, automated insights, and a full serverless architecture—built entirely on AWS with SageMaker, Lambda, DynamoDB, and React.
Shopify 🛍️ is a popular e-commerce platform, Shopify is selected as the primary integration platform for this project.
| 💢 Problem Without GrowEasy | ✅ How GrowEasy Solves It | 🏆 Advantage for Store Owners |
|---|---|---|
| ❌ Manual inventory planning | 🧠 Uses LSTM-based forecasting to predict product demand | 📦 Avoids overstock/understock losses |
| ❌ No real-time data-driven insights | 📊 Dashboard shows live trends, demand forecasts, and low-stock alerts | ⚡ Fast, informed decision-making |
| ❌ Missed opportunities during peak demand | 🔔 SNS alerts store owners about high-demand products in advance | 💰 Maximizes sales by staying stocked |
| ❌ Static pricing that ignores demand | 🔄 Integrates demand forecasting into pricing logic (future upgrade) | 📈 Enables smart, dynamic pricing |
| ❌ Shopify analytics not optimized for future planning | 📂 Stores product + order history in DynamoDB, makes it ML-ready | 🔍 Better long-term strategy with historical + forecasted data |
| ❌ High infrastructure cost for ML pipelines | ☁️ Fully serverless using AWS Lambda + SageMaker + EventBridge | 💸 Zero server maintenance, pay-as-you-go |
| ❌ No automation for restocking strategy | ⏰ Hourly ML pipeline auto-updates forecasts and recommendations | 🔄 Hands-free inventory management |
| ❌ Difficult for non-tech founders to understand backend logic | 🧱 Modular dashboard + visual insights + alerting system | 👩💼 Accessible to non-technical business users |
This repository contains backend webhook ingestion, ML forecasting pipeline, and a React dashboard — built during rapid development, so structure reflects functional grouping rather than strict layering.
GrowEasy/
│
├── Backend/ # Core backend logic (Shopify → AWS pipeline)
│ │
│ ├── Register_Webhook/
│ │ ├── register_webhook.py # Registers Shopify webhooks via Admin API
│ │ └── GrowEasy.txt # Notes / webhook payload reference
│ │
│ ├── Webhook_Handler/
│ │ ├── webhookhandler.py # Processes incoming webhook POST requests
│ │ └── what it does.txt # Explanation of handler logic
│ │
│ ├── forecast_result_writter/
│ │ ├── forecastResult.py # Writes ML forecast output
│ │ └── what it does.txt # Description of forecasting output logic
│ │
│ ├── forecast_trigger/
│ │ ├── index.js # Triggers forecasting pipeline (EventBridge/Lambda)
│ │ └── what it does.txt # Notes on trigger behavior
│
├── data/ # Dataset used for ML pipeline
│ ├── befor-forcast.csv # Raw historical product/order data
│ └── after forecast.txt # Forecast output results
│
├── Sagemaker/ # ML experimentation & training
│ └── forecasting-notebook.ipynb # LSTM model training notebook
│
├── codex 2.0/groweasy/ # Frontend (hackathon dashboard build)
│ │
│ ├── public/ # Static assets
│ ├── src/ # React components & UI logic
│ ├── package.json
│ └── tailwind.config.js
│
├── assets/ # Supporting files (images, references)
│
├── README.md # Project documentation
├── LICENSE # License file
├── Dashboard.png # UI preview
├── api_gateway_event.png # API flow proof
├── cloudwatch_logs.png # Monitoring proof
└── dynamodb_tables.png # Data storage proof
| ✅ What This Project IS | ❌ What This Project is NOT |
|---|---|
| Real-Time Data Ingestion System — Captures Shopify product and order events via webhooks and processes them through a serverless pipeline | Not a manual data entry or batch-processing system |
| AI-Driven Demand Forecasting — Uses historical product data with LSTM/ML models to predict future demand | Not a rule-based or static analytics dashboard |
| Serverless Processing Architecture — Built using AWS Lambda, EventBridge, and DynamoDB for scalable, event-driven execution | Not a server-based backend requiring infrastructure management |
| Inventory Optimization Engine — Provides actionable insights on stock levels, demand trends, and restocking needs | Not a passive reporting tool with no decision support |
| Automated Workflow Pipeline — Scheduled ML jobs update forecasts and insights without manual intervention | Not a one-time analysis or offline ML experiment |
| Cost-Efficient Cloud Design — Fully serverless architecture minimizing idle infrastructure cost | Not a heavy ML pipeline with high operational overhead |
GrowEasy integrates directly with Shopify using webhooks and a serverless backend pipeline to enable real-time data processing.
App Setup & Installation
The GrowEasy app is created via the Shopify Partner Dashboard and installed on a merchant’s store using OAuth, granting secure access to product and inventory data.
Webhook Registration
Once installed, the system registers webhook events (e.g., product create/update) using the Shopify Admin API to receive real-time store activity.
Event Ingestion (API Layer)
Shopify sends webhook POST requests to an API Gateway endpoint, which acts as a secure entry point for all incoming data.
Processing (Lambda Backend)
AWS Lambda processes the incoming payload, extracts relevant fields (product, inventory, pricing), and prepares it for downstream usage.
Data Storage
Processed data is stored in DynamoDB for further analysis, forecasting, and historical tracking.
📷 Diagram: Webhook Flow
GrowEasy runs an automated, serverless ML pipeline to generate demand forecasts:
products.csv)⚡ Outcome: Automated, repeatable forecasting pipeline with no manual intervention
The system is monitored end-to-end for reliability, visibility, and debugging:
⚡ Outcome: Full visibility into data flow, system health, and model execution
Why this design?
📷 Diagram: Monitoring & Logging via CloudWatch
📷 Screenshot: GrowEasy Dashboard UI This dashboard is built specifically for retail business owners and inventory managers to monitor forecasted demand, stock levels, and price recommendations in real-time. But, Now here , Dashboard fully developed and owned by me as part of the GrowEasy AI-powered retail platform. Responsible for architecture, design, data integration, and deployment. 🔗 Live Dashboard Demo — You can explore the working example here.
☁️ Cloud & Backend
🔗 Integration
🧠 Machine Learning
⚙️ Orchestration & Automation
📊 Monitoring & Alerts
💻 Frontend
🔐 Security
1️⃣ Clone the repository
git clone https://github.com/your-username/groweasy.git
2️⃣ Setup Backend
3️⃣ Configure Shopify Webhooks
products/create
products/update
orders/create
4️⃣ Run Forecasting Pipeline
5️⃣ Run Frontend Dashboard
cd "codex 2.0/groweasy"
npm install
npm start
I built GrowEasy during the Codex 2.0 Hackathon in just 36 hours, working under extreme pressure with my team.
Here are some snapshots from my Codex 2.0 journey while building GrowEasy:
Also, you can check from here: LinkedIn
✨ This experience made GrowEasy not just a project, but a real proof of my skills in cloud, AI, and problem-solving under pressure.
Failure Handling