isnady
Hadith search built around the isnad — the chain of transmission.
isnady is a desktop application (PySide6, Windows and Linux) for searching hadith across the major collections and seeing why each report has the grade it has: every narrator in the chain, what the scholars of jarh wa ta'dil said about them, and how the chain holds together.
Status: pre-alpha (0.0.4). Search and chains of transmission work today on data you import; narrators, scholars and the rest are being built.
Works now
- Search across every imported edition. Arabic ignores diacritics and letter forms and finds words with attached prefixes; Turkish and other Latin-script text ignores case and accents. All words, any word or exact phrase; book and language filters.
- Chains of transmission read from the Arabic text: each narrator, the words that link them (haddathana, akhbarana, 'an ...) with what each means, and whether the chain reaches the Prophet. Where the wording cannot be read with confidence the chain is kept whole, never guessed.
- Desktop app and command line with the same engine:
isnadyandisnady-cli.
isnady-cli import fawazahmed0 https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions.json \
--book bukhari --language ara --language tur --license Unlicense
isnady-cli search النيات
isnady-cli chain bukhari 1
isnady
Planned
- Search — by text, book, chapter, narrator and grade: mutawatir, sahih, hasan, da'if, mawdu' and the intermediate grades.
- Narrators — biography, dates, teachers and students, number of narrations, and every recorded verdict with its source.
- Narrators identified — every name in a chain linked to its narrator, with each narrator's standing and whether each link could have met the next.
- Reliability scores — derived transparently from classical rankings (for example Ibn Hajar's twelve grades in Taqrib al-Tahdhib), always shown with the verdicts they come from. A score is a conversion of the scholars' judgement, never a new one.
- Shia rijal — the primary grading follows the Sunni tradition; narrator verdicts from Shia rijal works (al-Najashi, al-Tusi, al-Kashshi, al-Hilli, al-Khoei) are listed per narrator beside the Sunni view.
- Statistics — narrators, books and grades counted and compared.
- Learn — the hadith sciences explained: terminology, grading, jarh wa ta'dil, and the classical works.
Install
pip install isnady
isnady
License
MIT for the application code. Hadith and narrator data will come from separate sources, each under its own license, listed here as they are added.
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).
1 maintainer
Metadata
1 maintainer
Release files for isnady 0.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| isnady-0.0.4.tar.gz | 460.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| isnady-0.0.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 932.3 kB
Release files / isnady-0.0.4.tar.gz
| Download URL | isnady-0.0.4.tar.gz |
|---|---|
| Size | 460.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2adc0cc73a8a044e226c248fd1f8a867300c322acc8556aa0ad483cb345b3d2e
|
|
BLAKE2b-256 checksum How to use checksums |
1d10bbc791b4c3569b2f8a3246b0e311f485be33bc6f8e9260ade15a4f8eaf2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency logRelease files / isnady-0.0.4-py3-none-any.whl
| Download URL | isnady-0.0.4-py3-none-any.whl |
|---|---|
| Size | 471.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
97aaa8fb6600f782fd3fbe5fa641d2633d4dff14bc57f1bb60df1397456707ab
|
|
BLAKE2b-256 checksum How to use checksums |
bd7cf2bb4e98f0260272a6d974e9f1bf1e67cebcca4deced9ec6192116cb65ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency log
