Skip to main content

QuranKit

A modular, Python-first computational Qur'anic research library

QuranKit provides reusable Python tools for accessing and navigating Qur'anic text, searching surahs, ayahs, and words, exploring Arabic words, roots, lemmas, and morphology when sourced annotation is available, analyzing repeated expressions and relationships between ayahs, and performing reproducible computational and statistical research.

Status

This project is in early pre-alpha development. The API is not stable and may change significantly.

Features (Planned)

  • Qur'anic text access — Preserve original source text with explicit edition identification
  • Arabic text processing — Unicode-aware normalization profiles for search and analysis
  • Lexicon and morphology — Root, lemma, and morphological analysis from sourced annotations
  • Search infrastructure — Exact, phrase, token, and word occurrence search
  • Mutashabihat analysis — Repeated phrase detection and textual relationship exploration
  • Computational research — Reproducible frequency, distribution, and co-occurrence analysis
  • Dataset governance — Provenance, licensing, and version tracking for all external data

Installation

pip install qurankit

For development with optional dependencies:

pip install qurankit[dev,tanzil,cli]

Quick Start

from qurankit import Quran

# Load a Quran instance (requires a dataset to be installed)
quran = Quran.load()

# Access surahs and ayahs
surah = quran.surah(1)  # Al-Fatihah
ayah = quran.ayah(1, 1)  # 1:1

print(f"Surah: {surah.name_arabic}")
print(f"Ayah: {ayah.text_original}")

Documentation

Principles

  1. Preserve originals — Never overwrite source Arabic text with normalized text
  2. Source traceability — Every annotation retains source, version, license, and attribution
  3. Separate evidence from inference — Distinguish source text, deterministic results, computational suggestions, and scholarly interpretation
  4. Reproducibility — Record dataset versions, algorithm versions, and normalization profiles
  5. Offline-capable — Core workflows work without hosted services after data installation
  6. Provider-neutral — No dependency on a particular LLM, cloud provider, or external API

License

MIT License — see LICENSE for details.

Third-party datasets have their own licenses. See docs/datasets.md for details.

Metadata

Release files for qurankit-core 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qurankit-core 0.3.0
File Size Uploaded Provenance Actions
qurankit_core-0.3.0.tar.gz 2.2 MB Without provenance Details for qurankit_core-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for qurankit-core 0.3.0
File Interpreter ABI Platform Actions
qurankit_core-0.3.0-py3-none-any.whl Python 3 none any Details for qurankit_core-0.3.0-py3-none-any.whl

Total release size: 2.3 MB

Release files / qurankit_core-0.3.0.tar.gz

Download URL qurankit_core-0.3.0.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
50537a74bc6cc0cfb675c2ddd67c95c16e15c4c99810d5276a153d63b120d489
BLAKE2b-256 checksum
How to use checksums
24674ca0d4b21ac0622257e1bd24eb291dc99d4a5d23ac38592bc15f598099ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / qurankit_core-0.3.0-py3-none-any.whl

Download URL qurankit_core-0.3.0-py3-none-any.whl
Size 114.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0edd8ea1f9a8792379bfb2275db7ac2d049956b7e1767e7f9aecd31fa6a68947
BLAKE2b-256 checksum
How to use checksums
1fcf9afbdb2274386d3430db3552c480e4c1bf0655c30abc8715ff5b1e5c7f82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for qurankit-core 0.3.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page