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 — граф знаний о Коране с опорой на ИИ: вы ищете аят, помещаете его на бесконечный холст и разворачиваете его, чтобы увидеть тематические, языковые (общий арабский корень) и богословские связи с другими аятами.
Это мобильное приложение или сайт?Это веб-приложение на Next.js (App Router) и React, поэтому вы пользуетесь им в браузере, а не устанавливаете на устройство.
Как начать исследовать аяты на холсте?Найдите аят по прямой ссылке (например, 2:255), ключевому слову или смыслу, поместите его на бесконечный холст, а затем разворачивайте по теме (Theme), корневому слову (Root Word) или контрасту (Contrast), чтобы открыть связанные аяты; гостевой доступ позволяет делать это без создания аккаунта.
Что нужно, чтобы разместить это у себя?База данных PostgreSQL с расширением pgvector и ORM Drizzle для миграций, API-ключ Anthropic Claude (с Gemini в качестве резервного и для эмбеддингов) и учётные данные OAuth2 Quran Foundation.
Может ли ИИ выдумывать несуществующие связи между аятами?Нет — канонические общие арабские корни и семантическая близость на основе эмбеддингов сначала определяют аяты-кандидаты, а роль ИИ ограничена объяснением, почему связь существует, но никак не придумыванием ссылки.
Нужен ли аккаунт, чтобы пользоваться им?Нет, гостевой доступ позволяет исследовать, добавлять в закладки и пользоваться холстом без входа; создание аккаунта лишь добавляет синхронизацию закладок и рабочих пространств между устройствами.
Что такое раздел 99 Божественных имён?Полный раздел Асма аль-Хусна с арабской вязью, морфологией корней, таксономией, лентой связанных аятов и созерцательными размышлениями для каждого из 99 имён.
На каких языках доступен интерфейс?Английский, турецкий, русский и азербайджанский — это охватывает сам интерфейс, объяснения связей от ИИ и содержимое раздела 99 имён.
Могу ли я поделиться построенным холстом с друзьями?Да, каждое состояние холста сериализуется в один URL, который можно скопировать и отправить, — другие увидят ровно тот же граф, что построили вы.
Какие в нём есть социальные функции?Ежедневные серии активности, таблица лидеров друзей, дуэльные челленджи по чтению (24h/48h/7d) и @упоминания, уведомляющие друзей, когда вы отмечаете их в заметках к аятам.
Creator
OpenHikmah
Size
7.5 MB
Stars
181
Updated
CommitOct 07
Age
5mo
Commits · 90 Days