--- a
+++ b/README.md
@@ -0,0 +1,32 @@
+# 🏥 Kidney Medical Imaging Dataset – Medullary Sponge Kidney & Related Conditions
+
+## 📌 Overview  
+This dataset contains **CT scan images** categorized into different kidney-related conditions, primarily **Medullary Sponge Kidney (MSK)** and its associated complications. It includes structured metadata linking cases to **Radiopaedia**, ensuring authenticity and detailed case descriptions.
+
+## 📂 Dataset Structure  
+The dataset is divided into three sets:  
+- **📁 train/** – Training images  
+- **📁 val/** – Validation images  
+- **📁 test/** – Testing images  
+
+Additionally, we provide:  
+- **📄 case_documentation.csv** – A structured file containing metadata about each case, including links to Radiopaedia.  
+
+## 🏷️ Labels & Categories  
+- **Medullary Sponge Kidney (MSK)**  
+- **Medullary Nephrocalcinosis**  
+- **Caroli’s Disease**  
+- **Renal Tubular Ectasia**  
+- **Nephrolithiasis & Ureterolithiasis**  
+
+## 🔍 What's New in This Version?  
+✅ Added **case_documentation.csv** with links to original cases on **Radiopaedia** 📌  
+✅ Improved dataset organization in `train/val/test` directories 📂  
+✅ Verified all images and removed duplicates ❌  
+
+## 📊 Usage  
+This dataset can be used for:  
+✔ **Machine Learning Models** – AI-based diagnostic tools for kidney conditions.  
+✔ **Medical Research** – Study of MSK, nephrocalcinosis, and other kidney disorders.  
+✔ **Educational Purposes** – Training radiologists and medical students.  
+