--- a
+++ b/README.md
@@ -0,0 +1,34 @@
+# 🦵 Knee Osteoarthritis X-ray Dataset
+
+## 📚 Context
+
+Knee osteoarthritis is a degenerative condition involving the **breakdown of articular cartilage**, the flexible, slippery material that protects bones in the knee joint. It also affects the underlying bone and nearby soft tissues. 
+
+While **knee osteoarthritis** is the most common form of arthritis causing knee pain, other forms like **rheumatoid arthritis**, **pseudogout**, and **reactive arthritis** can also affect the knee.
+
+---
+
+## 🩻 Content
+
+This dataset contains **knee X-ray images** and is designed for tasks such as:
+
+- **Knee joint detection**
+- **KL (Kellgren and Lawrence) grading of osteoarthritis severity**
+
+### 🔢 KL Grade Descriptions
+
+| Grade | Description |
+|-------|-------------|
+| 0     | Healthy knee image |
+| 1     | *Doubtful*: Possible osteophytic lipping, slight joint narrowing |
+| 2     | *Minimal*: Definite osteophytes and possible joint space narrowing |
+| 3     | *Moderate*: Multiple osteophytes, definite joint narrowing, mild sclerosis |
+| 4     | *Severe*: Large osteophytes, significant joint narrowing, severe sclerosis |
+
+---
+
+## 🙏 Acknowledgements
+
+> Chen, Pingjun (2018), “Knee Osteoarthritis Severity Grading Dataset”, Mendeley Data, V1  
+> DOI: [10.17632/56rmx5bjcr.1](https://doi.org/10.17632/56rmx5bjcr.1)  
+> Dataset organized using data from the **Osteoarthritis Initiative (OAI)**.