feat(app/docs): update README.md with enhanced formatting and additional sections

README.md

@@ -6,11 +6,47 @@ colorTo: blue
 sdk: streamlit
 sdk_version: 1.45.0
 app_file: app.py
-pinned: false
+tags:
+  - streamlit
+pinned: true
 license: agpl-3.0
 short_description: A semantic movie recommendation system.
 ---
 
-# Intelliflix – Semantic Movie Recommender
+# 🎬 Intelliflix – Semantic Movie Recommender
 
-Intelliflix is a semantic movie recommendation system powered by TMDb metadata and sentence-transformer embeddings.
+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)