openhikmah-web README

The project's README from github.com/OpenHikmah/openhikmah-web. As one markdown file: README.md.

Open Hikmah logo  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.

CI License: GPL-3.0 Contributor Covenant PRs Welcome
TypeScript GitHub stars Open issues

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


Tech Stack

Layer Choice
Framework Next.js 16 (App Router), React 19, TypeScript
i18n next-intl (English, Turkish, Russian, Azerbaijani)
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

Contributing

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.

Security

Report vulnerabilities privately to [email protected]. See SECURITY.md.

License

GPL-3.0


Star History

Star History Chart

openhikmah-web (OpenHikmah/openhikmah-web)

pgvector
Searching Database…

What is this?Open Hikmah is an AI-grounded Quran knowledge graph: you search for a verse, drop it on an infinite canvas, and expand it to surface thematic, linguistic (shared Arabic root), and theological connections to other verses.
Is this a mobile app or a website?It's a web app built with Next.js (App Router) and React, so you use it in a browser rather than installing it on a device.
How do I start exploring verses on the canvas?Search for a verse by direct reference (e.g. 2:255), keyword, or meaning, place it on the infinite canvas, then expand it by Theme, Root Word, or Contrast to reveal related verses; guest access lets you do this without creating an account.
What do I need to self-host this?A PostgreSQL database with the pgvector extension and Drizzle ORM for migrations, an Anthropic Claude API key (with Gemini as fallback and for embeddings), and Quran Foundation OAuth2 credentials.
Can the AI make up connections between verses that aren't real?No — canonical shared Arabic roots and embedding-based semantic similarity identify candidate verses first, and the AI's role is limited to explaining why a connection holds, never to inventing a reference.
Do I need to create an account to use it?No, guest access lets you explore, bookmark, and use the canvas without signing in; creating an account just adds cross-device syncing of bookmarks and workspaces.
What's the 99 Divine Names feature?A full Asma'ul Husna section with Arabic script, root morphology, taxonomy, a related verse feed, and contemplative reflections for each of the 99 names.
What languages is the interface available in?English, Turkish, Russian, and Azerbaijani — covering the UI itself, AI-generated connection explanations, and the 99 Names content.
Can I share a canvas I've built with friends?Yes, every canvas state serializes into a single URL you can copy and share, so others see exactly the same graph you built.
What social features does it have?Daily engagement streaks, a friends leaderboard, head-to-head reading challenges (24h/48h/7d), and @mentions that notify friends when you tag them in verse notes.
Creator
OpenHikmah
Size
7.5 MB
Stars
181
Updated
CommitOct 07
Age
5mo
Commits · 90 Days