Skip to content

README.md

Latest commit

 

History

History
83 lines (57 loc) · 2.69 KB

README.md

File metadata and controls

83 lines (57 loc) · 2.69 KB

AI-Rec — Intelligent Multi-Domain Recommendation System

START OF PROJECT - 24 AUG 2025

Made with React Made with FastAPI Python License: MIT

AI‑Rec is a full‑stack AI‑powered recommendation platform that delivers personalized suggestions for music, movies, books, games, food, and TV shows.
It combines a FastAPI backend with ML models and a React + Tailwind CSS frontend to create a fast, responsive, and visually engaging experience.

Table of Contents

  1. Features
  2. Tech Stack
  3. Project Structure
  4. Getting Started
  5. API Endpoints
  6. Screenshots
  7. Contributing
  8. License

Features

  • 🎵 Multi‑domain recommendations (music, movies, books, games, food, TV)
  • ⚡ FastAPI backend serving ML predictions
  • 🎨 Responsive UI with Tailwind CSS
  • 🎬 Smooth animations using GSAP
  • 📦 Clean, modular codebase for easy scaling
  • 🔄 Seamless frontend‑backend integration

🛠 Tech Stack

Frontend

  • React + Vite
  • Tailwind CSS
  • GSAP animations
  • Framer-Motion

Backend

  • FastAPI
  • Python 3.10+
  • joblib for ML model loading

Other

  • npm & pip for dependencies
  • Git for version control

📂 Project Structure

ai-rec/ │ ├── backend/ │ ├── main.py # FastAPI entry point │ ├── music_recommender.py # ML recommendation logic │ ├── requirements.txt # Python dependencies │ ├── src/ │ ├── assets/ # Images & static assets │ ├── components/ # React components │ ├── App.jsx # Main React app │ ├── public/ # Static public files ├── package.json # Frontend dependencies └── vite.config.js # Vite config

##SCREENSHOT image image

📜 License This project is licensed under the MIT License.

#CONTRIBUTORS ROHIT R BHAT