KinaHub

KO | EN

gitlite — search

#hacktoberfest #go #golang #android #machine-learning #rust #docker #macos #cli #kubernetes #awesome-list #vue #openai #open-source

(★ 10)

AI-powered local e-commerce & CRM platform connecting sellers and customers with smart recommendations and delivery optimization.

KinaHub Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🛍️ KinaHub

**KinaHub** is a modern, scalable e-commerce and CRM platform designed to connect local sellers with customers through intelligent, location-aware shopping experiences. Originally developed as an On-the-Job Training (OJT) project, it has evolved into a fully deployed full-stack application with cloud-native infrastructure.

---

## 📽️ Project Demo

https://github.com/user-attachments/assets/ca7bd1c9-caa4-48f9-94cd-3f67d75cb37a

---

## 🎬 Full Walkthrough Video

https://github.com/user-attachments/assets/410296e2-23d3-401f-85bc-2aef7b2b1a85

---

## 👤 Creator

**Bikram Gole**
Project Developer & Maintainer

* GitHub: https://github.com/BikramGole

---

## 🚀 Core Features

### 🛒 Customer Experience

* **Location-Based Shopping:** Discover products from nearby sellers for faster delivery.
* **Advanced Filtering System:** Sort by category, price, and product ratings.
* **Smart Cart System:** Automatic delivery fee calculation and multi-item checkout.

---

### 🤖 Kina AI Assistant

* **LLM-Powered Chat Assistant:** Integrated via OpenRouter for intelligent shopping help.
* **AI Insight Panels:** Product summaries, recommendations, and buying signals.
* **Cart Optimization:** Suggests bundling items from the same store to minimize delivery costs.
* **Confidence Ranking:** Highlights high-value and reliable product choices.

---

### 💼 Seller & CRM Dashboard

* **Store Management:** Customize store branding, delivery zones, and rules.
* **Inventory Control:** Full CRUD functionality for product listings.
* **AI CRM Insights:** Alerts for trending products and low stock levels.
* **Analytics Dashboard:** Track revenue, sales performance, and order metrics.

---

## 🧱 Tech Stack

### Frontend

* React
* TypeScript
* Vite
* Tailwind CSS
* Framer Motion

### Backend

* Django
* Django REST Framework

### Database

* PostgreSQL (Neon Cloud)

### AI Integration

* OpenRouter API (client-side LLM orchestration)

### Cloud & Infrastructure

* Vercel (Frontend Hosting)
* Render (Backend Hosting)
* Neon (Database)
* Cloudinary (Media Storage)

---

## ⚙️ System Architecture

KinaHub follows a **decoupled client-server architecture**:

### 1. Backend (Django API)

* JWT-based authentication system
* Handles products, stores, orders, and cart logic
* RESTful API endpoints

### 2. Frontend (React SPA)

* Built with Vite for fast performance
* Communicates with backend via Axios / Fetch
* Fully responsive UI with smooth animations

### 3. AI Layer

* Rule-based optimization engine (cart + seller grouping)
* Optional conversational AI via OpenRouter

---

## 🏃 Local Development Setup

### Linux / macOS

```bash
chmod +x start.sh
./start.sh
```

### Windows

```cmd
start.bat
```

### What the scripts do:

* Start Django backend server
* Install frontend dependencies
* Launch Vite development server
* Open http://localhost:5173

---

## 🧠 Project Status

* Fully functional and deployed
* Independently built and maintained by a solo developer
* Actively evolving with new AI and scalability features

---

## 📌 Vision

KinaHub aims to become a **localized commerce ecosystem**, empowering small businesses with tools typically available only to large-scale platforms—enhanced by AI-driven decision support.

---

KinaHub

KinaHub Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

KinaHub

KinaHub Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README