Recosa

📖 Overview

ReCoSa is a scalable SaaS platform built to provide intelligent, content-based item recommendations via API. It enables businesses such as e-commerce platforms, food delivery apps, and online marketplaces to integrate AI-powered recommendations into their platforms effortlessly — without building ML infrastructure from scratch.

This system allows users to upload item data (with features like tags, categories, etc.), and in return, they get an API that returns smart recommendations for similar items — improving engagement, conversions, and user retention.

🧠 Why I Built It

Recommendation systems drive modern digital experiences — whether it's Netflix, Amazon, or Zomato. I wanted to build a system where businesses can plug into personalized intelligence using a single API.

This project challenged me to combine Machine Learning, API security, usage tracking, and SaaS pricing — wrapped in a developer-friendly interface.

🧩 Key Features

🧬 AI-Powered Content-Based Recommendations​

• Accepts user-uploaded item data with rich metadata (name, tags, category, etc.)

• Automatically vectorizes and indexes content using cosine similarity

• Exposes REST API to retrieve N most similar items based on a given item

🔐 Secure API Access​

• Each user gets a unique API key upon signup

• JWT-based authentication and protected endpoints

• API key usage tracking with limits (based on pricing tier)

📊 Usage Analytics & Pricing​

• Tracks number of API calls and data uploaded

• Users can view current usage and plan limits

• Pricing tiers define data caps and usage volume

📁 File Upload and Data Parsing​

• Users can upload a CSV or JSON of their items

• Server parses, validates, and stores it securely

• Items can be updated/replaced anytime

🌐 Ready-to-Use API​

• Simple REST API for:

  • Uploading item data

  • Getting recommended items by ID

  • Monitoring API usage

💻 Frontend Highlights​

• Built with React + Tailwind + ShadCN UI

• Dashboard shows:

  • Uploaded items

  • API usage stats

  • Sample API code to integrate recommendations

• Clean, mobile-first interface

• Theme switcher (light/dark)

• Auth flow with Sign Up, Login, and API key management
  
  

🛠 Tech Stack