README.md

---
title: HF Spaces Test
emoji: 🎬
colorFrom: purple
colorTo: gray
sdk: streamlit
sdk_version: 1.45.0
app_file: app.py
tags:
- streamlit
pinned: false
short_description: A hf spaces test repo.
license: agpl-3.0
---

# 🎬 Intelliflix – Semantic Movie Recommender

Intelliflix is a semantic movie recommendation system powered by TMDb metadata and sentence-transformer embeddings.

💡 Simply enter a movie name or plot description, and Intelliflix will return semantically similar movies — not just based on genre, but meaning.


## 🔍 How It Works

- Uses TMDb metadata (title, overview, genres)
- Generates sentence embeddings using `all-MiniLM-L6-v2`
- Runs semantic search via FAISS over precomputed vectors
- Recommends movies with similar plot meanings

## 📁 Dataset

This Space uses the [Intelliflix Store Dataset](https://huggingface.co/datasets/uiuxarghya/intelliflix-store), which includes:

- Movie metadata (`data/`)
- Sentence embeddings (`embeddings/`)
- FAISS vector indexes (`indexes/`)

## 🚀 Run Locally

```bash
  git clone https://huggingface.co/spaces/uiuxarghya/intelliflix
  cd intelliflix
  pip install -r requirements.txt
  streamlit run app.py
```

## 🛡 License

This project is licensed under the **AGPL-3.0**.

## 📫 Author

Built by [Arghya Ghosh](https://arghya.dev) · [GitHub](https://github.com/uiuxarghya)