README.md

SBERT + FAISS Semantic Search

This Hugging Face Space hosts a semantic search system built with:

• Sentence-BERT (SBERT) for embeddings
• FAISS for fast vector search
• MS MARCO v1.1 dataset (10,000 passages subset)
• Gradio for the interactive interface

---

🔹 Features

• Enter a query to retrieve the Top-10 most similar passages.
• Optionally provide ground truth relevant passages (one per line) to compute IR metrics:
  • Precision@10
  • Recall@10
  • F1-score
  • Mean Reciprocal Rank (MRR)
  • Normalized Discounted Cumulative Gain (nDCG@10)

---

🔹 How to Use

1. Type a query into the input box.
2. (Optional) Paste one or more relevant passages into the second box, each on a new line.
3. Press Submit.
4. View:
   • Top-10 retrieved passages with FAISS similarity scores
   • Evaluation metrics if ground truth passages were provided

---

🔹 Tech Stack

• Embeddings: sentence-transformers/all-mpnet-base-v2
• Indexing: FAISS (L2 similarity)
• Dataset: MS MARCO v1.1 (first 10,000 passages)
• Interface: Gradio

---

🔹 Citation

If you use this system in research, please cite:

• Sentence-BERT
• MS MARCO

---

🔹 Author

Built for a research project on user-centered evaluation of semantic search systems.