Khurram123/kulliyat-e-iqbal-shaheen

---
license: apache-2.0
task_categories:
- text-generation
- question-answering
language:
- ur
- fa
pretty_name: Kulliyat-e-Iqbal (Complete Poetic Works with Explanations)
size_categories:
- 10K<n<100K
tags:
- iqbaliat
- urdu-poetry
- persian-poetry
- philosophy
- sufism
- instruct
- rlx
---

<p align="center">
<br>
<b style="font-size: 26px;">"ستاروں سے آگے جہاں اور بھی ہیں"</b> <br>
<b style="font-size: 18px;">— کلیاتِ اقبال: اردو اور فارسی کلام کا جامع ڈیجیٹل ذخیرہ</b>
</p>

<p align="center">
<img src="https://huggingface.co/datasets/Khurram123/kulliyat-e-iqbal-shaheen/resolve/main/image.png" width="400" alt="Kulliyat-e-Iqbal Logo">
</p>

<h1 align="center">📚 Kulliyat-e-Iqbal Shaheen Dataset (v1.0) 🦅</h1>

**Kulliyat-e-Iqbal Shaheen Dataset** is a high-quality, structured collection of **11,659 couplets** covering the entire poetic journey of **Allama Muhammad Iqbal**. This dataset bridges classical Islamic philosophy with modern AI, providing each couplet with a simplified Urdu explanation (Tashreeh).

This corpus is specifically designed for fine-tuning Large Language Models (LLMs) to achieve deep understanding of **Iqbaliyat**, **Sufism**, and **Khudi**.

---

## 🌟 Key Features
- **Total Coverage:** Includes all 11 major Urdu and Persian (Farsi) books.
- **Bilingual Excellence:** Seamlessly integrates Persian couplets with their Urdu meanings.
- **Instruction-Ready:** Formatted in `Instruction-Response` pairs, ideal for SFT (Supervised Fine-Tuning).
- **Verified Context:** Each explanation is curated to maintain the philosophical essence of the original work.
- **Cleaned & Structured:** Filtered to remove metadata, speaker labels (e.g., Iblees, Mushir), and non-poetic headers.

---

## 📊 Dataset Statistics & Sources
The dataset is a culmination of Iqbal’s lifelong literary contribution:

| Book Name (Urdu) | Language | Records | Focus Area |
| :--- | :--- | :--- | :--- |
| **Bang-e-Dara** | Urdu/Mixed | 2,468 | Early lyrics & Nationalistic poems |
| **Bal-e-Jibreel** | Urdu | 1,165 | Peak of philosophical ghazals |
| **Zarb-e-Kaleem** | Urdu | 827 | Political and social critique |
| **Armaghan-e-Hijaz** | Urdu/Persian | 1,043 | Spiritual yearning & the final message |
| **Javid Nama** | Persian | 1,851 | Celestial journey & divine dialogues |
| **Zabur-e-Ajam** | Persian | 1,266 | Mystical Persian ghazals |
| **Asrar-e-Khudi** | Persian | 875 | The Secrets of the Self |
| **Rumuz-e-Bekhudi** | Persian | 1,027 | Secrets of Selflessness (Society) |
| **Other Persian Works** | Persian | 1,937 | Pas Cha Bayad Kard, Payam-e-Mashriq |

---

## 🛠️ Data Format
The dataset is provided in `.parquet` (optimized for Hugging Face `datasets`) and `.jsonl` formats.

**Example Entry:**
```json
{
"instruction": "اس شعر کا سادہ مطلب بیان کریں:\nنہیں ہے ناامید اقبال اپنی کشتِ ویراں سے\nذرا نم ہو تو یہ مٹی بڑی زرخیز ہے ساقی",
"response": "اقبال اپنی بنجر زمین (حالات) سے مایوس نہیں ہے؛ اگر تھوڑی سی محنت یا حوصلہ ملے تو یہ مٹی (قوم) بہت باصلاحیت ثابت ہو سکتی ہے۔",
"book": "بانگِ درا",
"poem": "شکوہ/جوابِ شکوہ/متفرق"
}