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)

Searching Database…

这是什么?Open Hikmah 是一个以 AI 为支撑的古兰经知识图谱:你搜索一节经文,把它放到无限画布上,再展开它,就能看到它与其他经文在主题、语言(共享阿拉伯语词根)和神学上的关联。
这是移动应用还是网站?它是一个用 Next.js(App Router)和 React 构建的 Web 应用,在浏览器里使用,不需要安装到设备上。
怎么开始在画布上探索经文?通过直接引用(如 2:255)、关键词或含义搜索一节经文,把它放到无限画布上,然后按主题、词根或对比展开,就能显示相关经文;访客模式无需注册账号即可完成这些操作。
自部署需要什么?需要一个带 pgvector 扩展的 PostgreSQL 数据库和用于迁移的 Drizzle ORM,一个 Anthropic Claude API 密钥(Gemini 作为备选并用于嵌入),以及 Quran Foundation 的 OAuth2 凭据。
AI 会编造并不存在的经文关联吗?不会——先用权威的共享阿拉伯语词根和基于嵌入的语义相似度确定候选经文,AI 的角色仅限于解释关联为何成立,绝不会凭空编造引用。
使用它需要注册账号吗?不需要,访客模式无需登录即可探索、收藏和使用画布;注册账号只是增加了书签和工作区的跨设备同步。
“99 尊名”功能是什么?一个完整的 Asma'ul Husna 板块,包含阿拉伯文原文、词根形态、分类体系、相关经文流,以及 99 个尊名各自对应的沉思感悟。
界面支持哪些语言?英语、土耳其语、俄语和阿塞拜疆语——涵盖界面本身、AI 生成的关联解释,以及 99 尊名内容。
我能把搭建好的画布分享给朋友吗?可以,每个画布状态都会序列化成一个 URL,复制分享后,别人看到的就是与你搭建的完全相同的图谱。
它有哪些社交功能?每日学习连续记录、好友排行榜、一对一读经挑战(24 小时/48 小时/7 天),以及在经文笔记里 @ 好友时通知对方的 @ 提及功能。
Creator
OpenHikmah
Size
7.5 MB
Stars
181
Updated
CommitOct 07
Age
4mo
Commits · 90 Days