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