Getting Started with DivinityAI – Islamic Grounded RAG: A Hands-on Tutorial
Key Takeaways: DivinityAI is a Retrieval-Augmented Generation (RAG) system that ensures zero hallucination by strictly grounding responses in authentic Quran and Hadith texts. Its deterministic citation verification and hybrid search capabilities make it a reliable tool for scholarly research and academic study.
The Challenge: Why DivinityAI – Islamic Grounded RAG Was Built
General-purpose large language models (LLMs) often hallucinate religious texts, leading to fabricated Quranic verses and incorrect Hadith attributions. DivinityAI addresses this critical issue by implementing a strict corpus-lock policy, ensuring every response is grounded in authenticated Quran and Hadith collections.
Core Architecture & Technical Stack Deep-Dive
Tech Stack Overview
- Backend: Django ASGI / DRF
- Frontend: React 19 / Vite
- Database: ChromaDB
- Embeddings: BGE-M3 Embeddings
- Search: BM25 Sparse Search, Reciprocal Rank Fusion
- LLM: OpenRouter (Gemini 2.5 Flash), Groq (Llama 3.3 70B)
- Styling: Tailwind CSS v4
Key Features Breakdown & Practical Benefits
Strict Corpus-Lock Policy
DivinityAI refuses to answer queries that cannot be verified from its locked corpus, ensuring zero hallucination.
Five-Path Intent Router
The system classifies queries into Quran verse, Hadith, Fiqh, Calculation, or Off-Domain categories, applying specialized retrieval strategies for each.
Hybrid Search Capabilities
Combining BM25 sparse matching with BGE-M3 dense embeddings, DivinityAI ensures comprehensive and accurate search results.
Real-World Use Cases & Applications
DivinityAI is ideal for scholarly research, authenticated Quran/Hadith reference discovery, and academic study of classical Arabic religious texts.
How It Works: Step-by-Step Workflow
- User Query Submission
- Intent Classification
- Query Rewriting (HyDE & Sub-Queries)
- Hybrid Retrieval (BM25 + Dense)
- Citation Verification
- Grounded Generation
- Post-Generation Safety Checks
Comparison: DivinityAI – Islamic Grounded RAG vs Traditional Approaches
| Feature | DivinityAI | Traditional LLMs |
|---|---|---|
| Hallucination Risk | Zero | High |
| Citation Accuracy | 95%+ | Variable |
Frequently Asked Questions (FAQ)
1. What is DivinityAI?
DivinityAI is a Retrieval-Augmented Generation system designed for accurate Quran and Hadith searches, ensuring zero hallucination.
2. How does DivinityAI ensure citation accuracy?
It uses a deterministic citation verification chain, including exact match, normalized match, Levenshtein distance, and semantic checks.
3. Can DivinityAI answer non-Islamic queries?
No, DivinityAI strictly rejects off-domain queries, focusing solely on Quran and Hadith-related questions.
Conclusion & Next Steps
DivinityAI offers a reliable, hallucination-free solution for Quran and Hadith searches. Explore the live project at https://muslim.nevatal.tech to experience its capabilities firsthand.
Leave a Reply