📜 isnady  _إسناد

Hadith search built around the isnad, the chain of transmission
_{Search the collections, read every chain narrator by narrator, and see how the scholars read it}

Why • Install • Quick Start • Search • Chains • Educational • Appearance • Data • CLI • Screenshots • Roadmap

Pre-alpha (0.0.5). Search and chains of transmission work today, on data you import in one command. Narrators, scholars, gradings and the rest are being built, in the open.

🎯 Why isnady

A hadith is two things: the text (matn) and the chain of people who passed it on (isnad). Most hadith sites let you search the text and show a grade. isnady is built the other way round: the chain comes first, because that is where the scholars of hadith did their work.

• The chain is read, not typed in. isnady reads the chain from the Arabic text itself: who narrated to whom, with which words, and whether it reaches the Prophet.
• Nothing is guessed. Where the wording cannot be read with confidence, the chain is kept whole and marked, never split wrongly. A missing link is shown as missing.
• Every fact has a source. Every hadith, text and grade records where it came from, under which licence.
• Grades are shown as the scholars gave them. Each grade keeps its scholar's name and wording; isnady does not merge them or invent its own.
• Window and command line, same engine. Everything the window does, the command line does too, with the same results.

📦 Install

pip install isnady
isnady            # or the short name:  iy

The same program answers to several names: iy to type, isnady to read, and isnady-cli kept from the first releases. Without arguments it opens the window; with arguments it is the command line. On Windows, isnady-gui opens the window without a console.

# Isolated — recommended, no system packages touched
pipx install isnady

# Into your user site — needs the override flag
pip install isnady --break-system-packages --no-cache-dir -U

Upgrading

pip install -U isnady --no-cache-dir

Your data stays where it is; a newer isnady upgrades the database in place the first time it opens it.

🚀 Quick Start

isnady ships without hadith data: you choose the sources. One command brings in Sahih al-Bukhari and Sunan Abi Dawud in Arabic and Turkish from the open fawazahmed0/hadith-api collection (public domain):

iy import fawazahmed0 https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions.json \
   --book bukhari --book abudawud --language ara --language tur --license Unlicense

Then open the window with iy, or stay on the command line:

iy search النيات            # Arabic, with or without diacritics
iy search "niyetlere göre"   # Turkish, English, any imported language
iy chain bukhari 1           # one chain, narrator by narrator

Importing takes a minute or two; the search index and the chains are built as part of it.

🔎 Search

Results appear at once and fill in as you read; the window never waits for them.

🔗 Chains of transmission

Every Arabic text is read for its chain:

Sahih al Bukhari 1
   1. حدثنا (narrated to us)  الْحُمَيْدِيُّ عَبْدُ اللَّهِ بْنُ الزُّبَيْرِ
   2. حدثنا (narrated to us)  سُفْيَانُ
   3. حدثنا (narrated to us)  يَحْيَى بْنُ سَعِيدٍ الْأَنْصَارِيُّ
   4. أخبرني (informed me)    مُحَمَّدُ بْنُ إِبْرَاهِيمَ التَّيْمِيُّ
   5. سمع (heard)            عَلْقَمَةَ بْنَ وَقَّاصٍ اللَّيْثِيَّ
   6. سمعت (I heard)          عُمَرَ بْنَ الْخَطَّابِ
      -> the Prophet

In the window, each result shows its chain as a row of names ending at the Prophet, and View chain opens it as a timeline from the book to the Prophet, with the Arabic text below: the chain in lighter ink, the text of the hadith in full ink.

Names are kept exactly as written, with the clarifications the compilers added ("— yaʿnī Ibn Muḥammad —", "mawlā Ibn ʿAbbās"), because identifying each narrator is a separate step that comes next.

🎓 Educational by Design

isnady teaches the science it uses. Every transmission term in a chain explains itself:

The Learn section — hadith terminology, grading, jarḥ wa taʿdīl and the classical works, each shown on real hadith and real chains — is on the roadmap.

🎨 Appearance

Every script has its own reading font, size, colour and line spacing — Arabic, Latin, Cyrillic, Bengali and Tamil today, more as sources in other scripts arrive. The light and the dark theme each keep their own colours, and the interface font can be changed too. Edit → Preferences (Ctrl + ,) applies every change at once; each row has its own Default button.

The same settings from the command line:

iy config list --prefix text.arabic       # what is set, and what is changed
iy config set text.arabic.size 22
iy config set text.latin.family "Noto Serif"
iy config set colors.dark.gilt "#5A4A1E"  # matched words in the dark theme
iy config reset text.arabic               # back to the defaults

Settings live in settings.json in the isnady data folder, shared by the window and the command line.

📚 Data and licences

isnady reads open formats and keeps the source of everything:

• Supported now: the fawazahmed0/hadith-api JSON format, from a file or a URL, with or without authentication (username and password, bearer token, or API key; credentials are never stored).
• Coming: CSV, SQL/SQLite, OpenITI mARkdown, REST APIs and Shamela, so any collection you have can be brought in.

Every source records a licence tier: A may be redistributed, B may be redistributed under its conditions, C may not. Sources you add yourself stay on your computer. Help → Licences lists every source in your database with its licence.

⌨️ CLI

Everything the window does also works without it — on a server, over SSH, or in a script. The command line never loads Qt.

$ iy search niyet --book abudawud --limit 1
43 hadith found in 8 ms

Sunan Abu Dawud #472
  grades: Al-Albani: Hasan; Muhammad Muhyi Al-Din Abdul Hamid: Hasan; Shuaib Al Arnaut: Daif; Zubair Ali Zai: Daif
  [Turkish] Ebu Hureyre (r.a.); Resulullah (Sallallahu aleyhi ve Sellem)'in şöyle buyurduğunu rivayet etmiştir: "Bir kimse mescid'e hangi [niyet]le gelirse nasibi ondan ibarettir"

📸 Screenshots

🗺️ Roadmap

• Narrators — every name in a chain linked to its narrator: biography, teachers and students, generation (Companion, Successor …), every verdict on them, and whether each link could have met the next.
• Hadith scholars — lives, books, teachers and students, and what their collections contain.
• Shia rijal — narrator verdicts from the Shia rijal works, beside the Sunni view.
• Learn — the sciences of hadith, shown on real hadith and real chains.
• More sources and formats — and adding your own from inside the window.
• Glossary — every Arabic term of hadith and the Islamic sciences explained where it appears: hover or click a term, read its meaning in the interface language.
• isnady.net — the same engine on the web.

🏗️ Build from Source

git clone https://github.com/bayramkotan/isnady.git
cd isnady
pip install -e .
iy

Python 3.10 or newer and PySide6. The command line alone needs no PySide6.

📝 License

MIT for the application code. Hadith data comes from separate sources, each under its own licence, recorded with the data and listed under Help → Licences.

The Arabic and reading typeface is Amiri by Khaled Hosny, bundled under the SIL Open Font License 1.1 (src/isnady/assets/fonts/OFL.txt).