Hugging Face's logo

Spaces:
schibsted-presplit
/
ai-academy-2024-gr8-recommender-api
Runtime error

App Files Community
ai-academy-2024-gr8-recommender-api / README.md
jrno's picture
jrno
Test change
8769897
preview code
|
raw
history blame
No virus
1.35 kB
metadata
title: Ai Academy 2024 Gr8 Recommender Api
emoji: 📉
colorFrom: green
colorTo: pink
sdk: docker
pinned: false
license: mit

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

ai-academy-2024-group8

A lightweight backend API for song recommender

Dataset used in this project is public and available from online

What's in here

  • data/: Contains the trained model.pkl and related model.csv that has the training set in csv format
  • notebooks/: Contains any jupyter notebooks used in the project
  • recommendation-api/: A FastAPI app to serve user recommendations

Running service locally

  1. (Optional) Create an activate python venv
  2. Install the requirements pip install -r requirements.txt
  3. Start the service python recommendation-api/server.py

Then

  • curl http://localhost:7860/users to fetch list of supported users
  • curl http://localhost:7860/users/<id> to fetch track history for individual user
  • curl http://localhost:7860/recommend/<id> to recommend tracks for the specific user

Running in Huggingface

Application is built and started on push to master.

Application is available from here