Spaces:
Runtime error
Runtime error
File size: 1,809 Bytes
783a754 e68d7ff | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 | ---
title: Rec Project
emoji: ⚡
colorFrom: gray
colorTo: gray
sdk: streamlit
sdk_version: 1.37.1
app_file: app.py
pinned: false
---
# Shows Recs: TV Series Recommendation System
  
## Overview
**Shows Recs** is a web application that provides TV series recommendations based on user input. It uses Sentence Transformers and FAISS to search and recommend series by embedding text queries and comparing them to a precomputed index of embeddings.
## Features
- **Metric Selection**: Choose from `L2`, `Dot Product`, or `Cosine Similarity`.
- **Customizable Recommendations**: Specify the number of recommendations to display.
- **Fast and Accurate**: Leverages FAISS for efficient similarity search.
## Installation & Usage
### 1. Clone the Repository
```bash
git clone https://huggingface.co/skudinov/shows_recs.git
cd shows_recs
```
### 2. Install Dependencies
Create a virtual environment and install the required packages:
```bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
### 3. Run the Application
Run the Streamlit app locally:
```bash
streamlit run app.py
```
The app will be accessible at http://localhost:8501.
### 4. Run with Docker
- Build the Docker image:
```bash
docker build -t your_docker_account/your_docker_repo .
```
- Run the Docker container:
```bash
docker run -p 8501:8501 your_docker_account/your_docker_repo
```
## How to Use
- Enter a query in the text input field.
- Select a similarity metric (L2, Dot Product, Cosine Similarity).
- Choose the number of recommendations.
- Click "Search" to get a list of TV series recommendations. |