How Semantic Search Works
Search by the meaning you remember, even when you do not recall the exact wording or book citation.
- 1
Choose what to search
Select Hadith (Six Canonical Collections) or The Holy Quran. For Hadith, you can search all six books or target specific collections like Sahih al-Bukhari or Sahih Muslim.
- 2
Choose your query language
Choose English or Arabic. This selects the appropriate multilingual text embeddings model for vector representation.
- 3
Write what you remember
Enter a topic, a concept (such as
charity in secret), a partial quote, or a specific Quranic reference like2:255. - 4
Vector similarity & dense ranking
The FastAPI vector service transforms your query into a 1024-dimensional embedding vector, and queries PostgreSQL
pgvectorwith HNSW cosine distance indexing to rank closest passages in milliseconds. - 5
Full text & context
Every result displays full Arabic text, English translation, narrator chains, and scholar verification grades (Sahih, Hasan, etc.).
Scholarly Advisory
This is an informational retrieval tool to assist students and researchers in locating passages. A search result is a reference point to read in context, not a legal ruling (fatwa). Always consult qualified scholars regarding religious practice.