Nevatal

Tag: Hadith Research

  • DivinityAI – Islamic Grounded RAG: A Hallucination-Free Quran & Hadith Search System

    Key Takeaways

    • Strict corpus-lock ensures answers are only sourced from authenticated Quran and Hadith collections
    • Five-path intent routing with confidence gating prevents off-topic responses
    • Hybrid search combining BM25 sparse and BGE-M3 dense embeddings for precise results
    • Deterministic citation verification with 4-tier validation chain
    • Pre-generation evidence checks and post-generation hallucination detectors

    The Challenge: Why DivinityAI – Islamic Grounded RAG Was Built

    General-purpose large language models (LLMs) frequently hallucinate religious texts, fabricating Quranic surah and ayah numbers, misattributing Hadith narrations, and synthesizing inaccurate Fiqh positions. In a domain where textual accuracy is paramount, these hallucinations pose serious risks to users seeking authentic Islamic knowledge.

    Core Architecture & Technical Stack Deep-Dive

    System Components

    The system is built as a modular application with:

    • Frontend: React 19 SPA with Tailwind CSS v4 and specialized RTL Arabic typography
    • Backend: Django ASGI with Django REST Framework
    • Vector Database: ChromaDB with separate collections for Quran and Hadith
    • Embeddings: BGE-M3 for dense vector search
    • Sparse Search: BM25 on normalized Arabic text
    • LLM Orchestration: OpenRouter (Gemini 2.5 Flash) and Groq (Llama 3.3 70B)

    Arabic NLP Pipeline

    The system implements a rigorous preprocessing normalization stage:

    • NFKD Unicode normalization
    • Diacritic stripping (tashkeel removal)
    • Alef form normalization
    • Tatweel (kashida) removal

    Key Features Breakdown & Practical Benefits

    Strict Corpus-Lock Policy

    The system refuses to answer any query that cannot be verified from its locked database of authenticated sources, ensuring zero hallucination of religious texts.

    Five-Path Intent Router

    Automatically classifies queries into one of five categories with confidence gating:

    • Quran verse search
    • Hadith research
    • Fiqh analysis
    • Islamic calculations
    • Off-domain queries

    Deterministic Citation Verification

    Implements a 4-tier validation chain:

    1. Exact string matching
    2. Normalized text comparison
    3. Levenshtein distance fuzzy matching
    4. Semantic LLM fallback verification

    Real-World Use Cases & Applications

    • Scholarly research with guaranteed authentic references
    • Comparative analysis across canonical Hadith collections
    • Reference architecture for high-stakes domain-specific RAG systems
    • Academic study of classical Arabic religious texts

    How It Works: Step-by-Step Workflow

    1. User query enters the intent classification system
    2. Scope guard checks for domain appropriateness
    3. Query undergoes HyDE expansion and sub-query decomposition
    4. Hybrid retrieval with BM25 and BGE-M3 embeddings
    5. Reciprocal Rank Fusion blends results
    6. Deterministic citation verification
    7. Evidence sufficiency check
    8. Grounded generation with safety layers

    Comparison: DivinityAI vs Traditional Approaches

    Feature DivinityAI Traditional LLMs
    Hallucination Rate 0% (corpus-locked) High (5-20% for religious texts)
    Citation Accuracy >95% verified Unverified
    Domain Control Strict Islamic corpus only General knowledge
    Technical Approach RAG with verification layers Pure generative

    Frequently Asked Questions (FAQ)

    Does DivinityAI issue fatwas?

    No. The system displays authenticated source materials and existing scholarly positions without generating new religious rulings. Users are always advised to consult qualified scholars for definitive rulings.

    What languages does it support?

    The system fully supports Arabic (with optimized RTL rendering), English, and Malay inputs and outputs.

    How does it prevent hallucinations?

    Through multiple safeguards: strict corpus-locking, pre-generation evidence checks, post-generation hallucination detectors, and deterministic citation verification.

    Conclusion & Next Steps

    DivinityAI represents a significant advancement in domain-specific RAG systems, particularly for high-stakes applications where accuracy is non-negotiable. Its architectural patterns serve as a valuable reference for implementing similar systems in other specialized domains.

    Experience DivinityAI today at https://muslim.nevatal.tech

  • DivinityAI – Islamic Grounded RAG: Hallucination-Free Quran & Hadith Search

    DivinityAI – Islamic Grounded RAG: Hallucination-Free Quran & Hadith Search

    Key Takeaways:

    • Zero hallucination guarantee for Quran and Hadith references
    • Strict corpus-lock policy enforcing answers grounded in authenticated sources
    • Hybrid search combining BM25 sparse matching with BGE-M3 dense embeddings
    • Deterministic 4-tier citation verification ensuring textual accuracy
    • Specialized intent routing for Quran verses, Hadith, Fiqh, and calculations

    The Challenge: Why DivinityAI – Islamic Grounded RAG Was Built

    General-purpose large language models (LLMs) often hallucinate religious texts, fabricating Quranic surah and ayah numbers or misattributing Hadith narrations. This poses significant risks for scholars, students, and anyone seeking accurate Islamic references. DivinityAI addresses this critical gap with a Retrieval-Augmented Generation (RAG) system built around a locked, authenticated corpus of Al-Quran and canonical Hadith compilations.

    Core Architecture & Technical Stack Deep-Dive

    DivinityAI’s architecture combines modern AI techniques with specialized Islamic text processing:

    Frontend & Backend Infrastructure

    • Frontend: React 19 SPA with Tailwind CSS v4, optimized for Right-to-Left (RTL) Arabic typography and Uthmani script rendering
    • Backend: Django ASGI with Django REST Framework (DRF) for API endpoints

    Retrieval & Search Components

    • Vector Database: ChromaDB for storing Quran and Hadith embeddings
    • Embeddings: BGE-M3 for dense semantic search
    • Sparse Search: BM25 for exact token matching on normalized Arabic text
    • Rank Fusion: Reciprocal Rank Fusion (RRF) to combine sparse and dense results

    LLM Orchestration

    • Generation: OpenRouter (Gemini 2.5 Flash) for response synthesis
    • Validation: Groq (Llama 3.3 70B) for high-speed verification tasks

    Key Features Breakdown & Practical Benefits

    Strict Corpus-Lock Policy

    DivinityAI implements an uncompromising policy: if a fact or claim cannot be verified from retrieved sources, the system refuses to answer. This ensures zero hallucination of religious texts.

    Five-Path Intent Router

    Queries are intelligently classified into:

    • Quran verse search
    • Hadith research
    • Fiqh (jurisprudence) analysis
    • Islamic calculations (Zakat, inheritance)
    • Off-domain queries (automatically rejected)

    Deterministic Citation Verification

    A 4-tier validation chain ensures reference accuracy:

    1. Exact string matching against canonical sources
    2. Normalized matching (stripped diacritics)
    3. Fuzzy Levenshtein distance for near-identical texts
    4. Semantic LLM fallback for paraphrased content

    Real-World Use Cases & Applications

    • Scholarly Research: Authenticated Quran/Hadith reference discovery without hallucination risks
    • Academic Study: Comparative analysis of classical Arabic religious texts
    • Technical Reference: Design pattern for high-stakes zero-hallucination RAG architectures

    How It Works: Step-by-Step Workflow

    1. User submits query through React interface
    2. Intent classification via Gemini 2.5 Flash
    3. Scope enforcement (rejects off-domain queries)
    4. Query rewriting using HyDE and sub-query decomposition
    5. Hybrid retrieval (BM25 + BGE-M3 embeddings)
    6. Reciprocal Rank Fusion to combine results
    7. 4-tier citation verification
    8. Evidence sufficiency check
    9. Grounded generation with safety layers
    10. Final output with verified citations

    Comparison: DivinityAI vs Traditional Approaches

    Feature DivinityAI Traditional LLMs
    Hallucination Prevention Strict corpus-lock with verification High risk of fabrication
    Citation Accuracy 95%+ verified Unverified, often incorrect
    Query Understanding Specialized intent routing Generic interpretation
    Arabic Text Handling Advanced normalization pipeline Basic tokenization

    Frequently Asked Questions (FAQ)

    How does DivinityAI prevent hallucinations?

    Through a strict corpus-lock policy that refuses answers not grounded in authenticated sources, combined with pre-generation evidence checks and post-generation verification layers.

    What Islamic texts are included in the corpus?

    The King Fahd Uthmani Quran and the six main Hadith books (Sahih Bukhari, Sahih Muslim, etc.).

    Can DivinityAI issue fatwas?

    No, it displays source materials and scholarly positions without generating new religious rulings. For definitive rulings, consultation with qualified scholars is recommended.

    What languages are supported?

    Full support for Arabic (including RTL formatting) and English queries.

    Conclusion & Next Steps

    DivinityAI represents a significant advancement in reliable Islamic text retrieval, combining modern AI techniques with rigorous verification processes. For scholars, students, and developers alike, it offers a trustworthy solution for Quran and Hadith research free from hallucination risks.

    Explore the live system at https://muslim.nevatal.tech to experience corpus-locked Islamic RAG in action.