Upload folder using huggingface_hub

Kurdish-HLR-Model/README.md

@@ -0,0 +1,68 @@
+---
+language:
+  - ckb
+license: cc-by-nc-4.0
+tags:
+  - handwritten-text-recognition
+  - kurdish
+  - densenet
+  - transformer
+  - pytorch
+  - safetensors
+datasets:
+  - DASTNUS
+metrics:
+  - cer
+  - wer
+pipeline_tag: image-to-text
+---
+
+# Kurdish Handwritten Text Recognition: DenseNet121-Transformer
+
+## Model Description
+A lightweight DenseNet121-Transformer architecture for Kurdish handwritten line recognition, 
+trained on the DASTNUS Kurdish handwritten dataset.
+
+## Architecture
+- **CNN Backbone:** DenseNet-121 (pretrained on ImageNet)
+- **Encoder:** 3 Transformer encoder layers
+- **Decoder:** 3 Transformer decoder layers
+- **Attention Heads:** 8
+- **Hidden Size:** 256
+- **Parameters:** ~12.8M
+
+## Performance
+| Metric | Value |
+|--------|-------|
+| CER | 0.0593 |
+| WER | 0.3083 |
+| CRR | 94.07% |
+
+## Training Data
+Trained on the DASTNUS Kurdish handwritten dataset with:
+- Unique handwritten lines
+- Synthetic handwritten lines (recipe-based generation)
+- Fixed-content handwritten lines from 50 writers
+
+## Usage
+```python
+from safetensors.torch import load_file
+import json
+
+# Load model weights
+state_dict = load_file("model.safetensors")
+
+# Load config
+with open("config.json", "r") as f:
+    config = json.load(f)
+
+# Load vocabulary
+with open("vocab.json", "r") as f:
+    vocab = json.load(f)
+```
+
+## Citation
+[ ]
+
+## License
+This model is released for non-commercial scientific research purposes only.

Kurdish-HLR-Model/config.json

@@ -0,0 +1,29 @@
+{
+  "architecture": "DenseNet121-Transformer",
+  "model_type": "custom",
+  "task": "handwritten-text-recognition",
+  "language": "Kurdish (Central / Sorani)",
+  "script": "Arabic",
+  "hidden_size": 256,
+  "num_encoder_layers": 3,
+  "num_decoder_layers": 3,
+  "num_attention_heads": 8,
+  "feed_forward_dim": 1024,
+  "dropout": 0.4,
+  "vocab_size": 115,
+  "max_sequence_length": 150,
+  "image_height": 96,
+  "image_width": 1235,
+  "cnn_backbone": "densenet121",
+  "parameters": 14169644,
+  "training": {
+    "best_val_cer": 0.05899565512960719,
+    "best_val_loss": 0.2740,
+    "best_epoch": 52,
+    "optimizer": "AdamW",
+    "learning_rate": 0.0005,
+    "batch_size": 64,
+    "data_mode": "mixed",
+    "writer_mixing": true
+  }
+}

Kurdish-HLR-Model/idx_to_char.json

@@ -0,0 +1,117 @@
+{
+  "0": "<PAD>",
+  "1": "< SOS >",
+  "2": "<EOS>",
+  "3": " ",
+  "4": "!",
+  "5": "\"",
+  "6": "#",
+  "7": "%",
+  "8": "&",
+  "9": "'",
+  "10": "(",
+  "11": ")",
+  "12": "*",
+  "13": "+",
+  "14": "-",
+  "15": ".",
+  "16": "/",
+  "17": "0",
+  "18": "1",
+  "19": "2",
+  "20": "4",
+  "21": ":",
+  "22": ";",
+  "23": "=",
+  "24": "@",
+  "25": "C",
+  "26": "D",
+  "27": "F",
+  "28": "H",
+  "29": "P",
+  "30": "[",
+  "31": "]",
+  "32": "_",
+  "33": "a",
+  "34": "c",
+  "35": "d",
+  "36": "e",
+  "37": "h",
+  "38": "m",
+  "39": "o",
+  "40": "p",
+  "41": "s",
+  "42": "t",
+  "43": "x",
+  "44": "{",
+  "45": "|",
+  "46": "}",
+  "47": "×",
+  "48": "÷",
+  "49": "،",
+  "50": "؛",
+  "51": "؟",
+  "52": "ء",
+  "53": "أ",
+  "54": "ؤ",
+  "55": "ئ",
+  "56": "ا",
+  "57": "ب",
+  "58": "ة",
+  "59": "ت",
+  "60": "ث",
+  "61": "ج",
+  "62": "ح",
+  "63": "خ",
+  "64": "د",
+  "65": "ذ",
+  "66": "ر",
+  "67": "ز",
+  "68": "س",
+  "69": "ش",
+  "70": "ص",
+  "71": "ط",
+  "72": "ع",
+  "73": "غ",
+  "74": "ـ",
+  "75": "ف",
+  "76": "ق",
+  "77": "ك",
+  "78": "ل",
+  "79": "م",
+  "80": "ن",
+  "81": "ه",
+  "82": "و",
+  "83": "وو",
+  "84": "ى",
+  "85": "ي",
+  "86": "٠",
+  "87": "١",
+  "88": "٢",
+  "89": "٣",
+  "90": "٤",
+  "91": "٥",
+  "92": "٦",
+  "93": "٧",
+  "94": "٨",
+  "95": "٩",
+  "96": "٪",
+  "97": "پ",
+  "98": "چ",
+  "99": "ڕ",
+  "100": "ژ",
+  "101": "ڤ",
+  "102": "ک",
+  "103": "گ",
+  "104": "ڵ",
+  "105": "ھ",
+  "106": "ۆ",
+  "107": "ی",
+  "108": "ێ",
+  "109": "۔",
+  "110": "ە",
+  "111": "‌",
+  "112": "‎",
+  "113": "‏",
+  "114": "–"
+}

Kurdish-HLR-Model/model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09718563ddb733afdcb8abc909eece0f2f0a46ac3e8794406a153b66dd00aa95
+size 56794644

Kurdish-HLR-Model/vocab.json

@@ -0,0 +1,117 @@
+{
+  "<PAD>": 0,
+  "< SOS >": 1,
+  "<EOS>": 2,
+  " ": 3,
+  "!": 4,
+  "\"": 5,
+  "#": 6,
+  "%": 7,
+  "&": 8,
+  "'": 9,
+  "(": 10,
+  ")": 11,
+  "*": 12,
+  "+": 13,
+  "-": 14,
+  ".": 15,
+  "/": 16,
+  "0": 17,
+  "1": 18,
+  "2": 19,
+  "4": 20,
+  ":": 21,
+  ";": 22,
+  "=": 23,
+  "@": 24,
+  "C": 25,
+  "D": 26,
+  "F": 27,
+  "H": 28,
+  "P": 29,
+  "[": 30,
+  "]": 31,
+  "_": 32,
+  "a": 33,
+  "c": 34,
+  "d": 35,
+  "e": 36,
+  "h": 37,
+  "m": 38,
+  "o": 39,
+  "p": 40,
+  "s": 41,
+  "t": 42,
+  "x": 43,
+  "{": 44,
+  "|": 45,
+  "}": 46,
+  "×": 47,
+  "÷": 48,
+  "،": 49,
+  "؛": 50,
+  "؟": 51,
+  "ء": 52,
+  "أ": 53,
+  "ؤ": 54,
+  "ئ": 55,
+  "ا": 56,
+  "ب": 57,
+  "ة": 58,
+  "ت": 59,
+  "ث": 60,
+  "ج": 61,
+  "ح": 62,
+  "خ": 63,
+  "د": 64,
+  "ذ": 65,
+  "ر": 66,
+  "ز": 67,
+  "س": 68,
+  "ش": 69,
+  "ص": 70,
+  "ط": 71,
+  "ع": 72,
+  "غ": 73,
+  "ـ": 74,
+  "ف": 75,
+  "ق": 76,
+  "ك": 77,
+  "ل": 78,
+  "م": 79,
+  "ن": 80,
+  "ه": 81,
+  "و": 82,
+  "وو": 83,
+  "ى": 84,
+  "ي": 85,
+  "٠": 86,
+  "١": 87,
+  "٢": 88,
+  "٣": 89,
+  "٤": 90,
+  "٥": 91,
+  "٦": 92,
+  "٧": 93,
+  "٨": 94,
+  "٩": 95,
+  "٪": 96,
+  "پ": 97,
+  "چ": 98,
+  "ڕ": 99,
+  "ژ": 100,
+  "ڤ": 101,
+  "ک": 102,
+  "گ": 103,
+  "ڵ": 104,
+  "ھ": 105,
+  "ۆ": 106,
+  "ی": 107,
+  "ێ": 108,
+  "۔": 109,
+  "ە": 110,
+  "‌": 111,
+  "‎": 112,
+  "‏": 113,
+  "–": 114
+}