Open Hikmah

An AI-grounded Quran knowledge graph — search a verse, drop it on an infinite canvas, and let AI surface the real connections between verses.

Try it live →

Overview

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.

Features

• 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).

Getting Started

git clone https://github.com/OpenHikmah/openhikmah-web
cd openhikmah-web
bun install
cp .env.example .env.local
# fill in .env.local — see the comments in .env.example for what each value needs
bun run dev

Open http://localhost:3000.

At minimum you'll need ANTHROPIC_API_KEY to test AI connections; the Quran Foundation OAuth variables are only required to test sign-in, bookmarks, and social features.

For the full contributor setup (running tests, Docker requirement for pushing, commit conventions), see CONTRIBUTING.md.

Tech Stack

Contributing

Read CONTRIBUTING.md before opening a PR. The project touches sacred content — theological changes (AI prompts, divine name data, verse framing) have extra requirements detailed in Theological Standards.

Security

Report vulnerabilities privately to security@openhikmah.com. See SECURITY.md.

License

GPL-3.0

Star History