DivinityAI – Islamic Grounded RAG: The Hallucination-Free Quran and Hadith Search System
- DivinityAI ensures zero hallucination by grounding every answer in authenticated Quran and Hadith texts.
- Features include intent routing, HyDE expansion, hybrid search, and deterministic citation verification.
- Built with Django ASGI, React 19, ChromaDB, and advanced AI models like BGE-M3 and Llama 3.3 70B.
- Real-world applications include scholarly research, academic study, and high-stakes domain-specific RAG architectures.
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, attributing narrations to the wrong companions, and synthesizing inaccurate Islamic jurisprudence (Fiqh) fatwas. In a domain where textual accuracy is critical, these hallucinations are unreliable and potentially misleading. DivinityAI addresses this challenge by implementing a strict “corpus-lock” policy, ensuring every answer is grounded in authenticated Quran and Hadith texts.
Core Architecture & Technical Stack Deep-Dive
DivinityAI is built as a modular application with a Django backend serving a React SPA, deploying local embeddings and remote LLM orchestrators. The tech stack includes:
- Frontend: React 19 single-page application styled using Tailwind CSS v4, optimized for Right-to-Left Arabic typography.
- Backend: Django web service with Django REST Framework (DRF) for REST endpoints.
- Vector Database: ChromaDB server for storing Quran and Hadith embeddings.
- Sparse Index: BM25 sparse search for exact-token matches.
- Embedding Model: BGE-M3 embeddings for semantic search.
- LLM Engine: OpenRouter for text generation and Groq for high-speed validation tasks.
Key Features Breakdown & Practical Benefits
Strict Corpus-Lock Policy
DivinityAI refuses to answer queries that cannot be verified from authenticated Quran and Hadith texts, ensuring zero hallucination.
Five-Path Intent Router
Every user query is classified into one of five intents: Quran verse, Hadith, Fiqh, Calculation, or Off-Domain, with specialized retrieval strategies for each.
Hybrid Search
Combines BM25 sparse matching with BGE-M3 dense embeddings for comprehensive retrieval.
Deterministic Citation Verification
Validates citations through a 4-tier verification chain, ensuring every reference is accurate.
Pre- and Post-Generation Checks
Pre-generation evidence sufficiency checks and post-generation fatwa boundary/hallucination detectors ensure the integrity of responses.
Real-World Use Cases & Applications
DivinityAI is designed for:
- Scholarly research and authenticated Quran/Hadith reference discovery.
- Academic study of classical Arabic religious texts and cross-source comparative analysis.
- Reference design pattern for high-stakes zero-hallucination domain-specific RAG architectures.
How It Works: Step-by-Step Workflow
The query execution pipeline includes:
- Intent Classification: Routes the query to the appropriate intent.
- Scope Enforcement: Rejects off-domain queries.
- Query Rewriting: Expands and decomposes complex queries.
- Hybrid Retrieval: Combines BM25 and BGE-M3 searches.
- Citation Verification: Validates references through a 4-tier chain.
- Grounded Generation: Synthesizes answers strictly from verified sources.
- Safety Layer: Detects hallucinations and ensures compliance with fatwa boundaries.
Comparison: DivinityAI – Islamic Grounded RAG vs Traditional Approaches
| Feature | DivinityAI | Traditional Approaches |
|---|---|---|
| Hallucination Risk | Zero | High |
| Citation Accuracy | 95%+ | Variable |
| Intent Routing | Five-path classification | None |
| Hybrid Search | BM25 + BGE-M3 | Single method |
Frequently Asked Questions (FAQ)
What is DivinityAI?
DivinityAI is a Retrieval-Augmented Generation system designed to provide hallucination-free Quran and Hadith search results with deterministic citation verification.
How does DivinityAI ensure accuracy?
DivinityAI implements a strict corpus-lock policy, hybrid search, and a 4-tier citation verification chain.
What languages does DivinityAI support?
DivinityAI supports Arabic, English, and Malay inputs.
Can DivinityAI issue fatwas?
No, DivinityAI displays source materials and scholarly positions without generating new religious rulings.
Is DivinityAI free to use?
Yes, DivinityAI operates on a 100% free-tier model.
Conclusion & Next Steps
DivinityAI – Islamic Grounded RAG sets a new standard for hallucination-free Quran and Hadith search systems. Its strict corpus-lock policy, advanced intent routing, and deterministic citation verification ensure unparalleled accuracy. Explore the live project at https://muslim.nevatal.tech to experience its capabilities firsthand.
Leave a Reply