AI-powered E-commerce Platform

A modern e-commerce platform with an AI-driven shopping assistant.

Project Structure

• backend/: FastAPI application with PostgreSQL and Pinecone integration.
• frontend/: React application built with Vite and Tailwind CSS.
• docker-compose.yml: Docker configuration for local development.

Tech Stack

Backend

• Framework: FastAPI
• Database: PostgreSQL with SQLAlchemy & Alembic
• Vector Search: Pinecone
• AI Integration: OpenAI SDK
• Package Manager: uv

Frontend

• Framework: React 19
• Build Tool: Vite
• Styling: Tailwind CSS 4
• Language: TypeScript

Getting Started

Prerequisites

• Python 3.12+
• Node.js 20+
• Docker & Docker Compose

Setup

1. Backend:

   cd backend
   uv sync
   # Set up .env file
   
   # Terminal 1: API server
   uv run uvicorn app.main:app --reload
   # Terminal 2: Arq worker
   uv run arq app.worker.WorkerSettings

2. Frontend:

   cd frontend
   npm install
   # Set up .env file
   npm run dev

3. Docker:

   docker-compose up -d

License

MIT