An AI-grounded Quran knowledge graph — search a verse, drop it on an infinite canvas, and let AI surface the real connections between verses.
Open Hikmah is an AI-grounded Quran knowledge graph. Rather than reading the Qur'an linearly, page by page, it lets you explore verses as a connected graph: search for a verse, place it on an infinite canvas, and expand it to surface related verses — by shared root word, by theme, or by meaningful contrast.
Connections are grounded, not hallucinated: canonical data — shared Arabic roots and embedding-based semantic similarity — identifies the candidate verses first. The AI's role is limited to explaining why a connection holds; it never invents a reference. Every edge on the canvas links to that explanation.
Verses can be found by direct reference (2:255), by keyword, or by meaning — describing a
concept in your own words and retrieving verses about it even when no words are shared with the
query.
- Canvas — Infinite graph of verse nodes connected by AI-generated edges. Expand any verse by Theme, Root Word, or Contrast. Connections are grounded in real Arabic roots and embedding similarity — the AI only explains the reasoning, never the reference.
- Search — Direct reference lookup (
2:255), full-text keyword search, or semantic search by meaning. - Find similar verses — From any verse, surface the closest verses by meaning.
- Shareable canvases — Every canvas state serializes to a single URL you can copy and share.
- Audio — Play all canvas verses in Qur'an order with a single button.
- 99 Divine Names — Full Asma'ul Husna with Arabic script, root morphology, taxonomy, verse feed, and contemplative reflections.
- Bookmarks — Save verses to your account; syncs across devices via the Quran Foundation API.
- Social — Daily engagement streaks, a friends leaderboard, and head-to-head challenges (24h / 48h / 7d).
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router), React 19, TypeScript |
| Canvas | @xyflow/react |
| State | Zustand |
| Styling | Tailwind CSS v4 |
| AI | Anthropic Claude (adaptive thinking) with Gemini fallback; Gemini embeddings for semantic search |
| Quran data | alquran.cloud + Quran Foundation API; canonical morphology for root grounding |
| Auth | Quran Foundation OAuth2 PKCE |
| Database | PostgreSQL + pgvector + Drizzle ORM |
| Testing | Vitest, Playwright |
| CI | GitHub Actions |
Want to run this locally or contribute? See CONTRIBUTING.md — it covers local setup, running tests, and commit conventions. Read it fully before opening a PR: the project touches sacred content, and theological changes (AI prompts, divine name data, verse framing) have extra requirements detailed in Theological Standards.
Report vulnerabilities privately to security@openhikmah.com. See SECURITY.md.