Upload README.md with huggingface_hub

README.md

@@ -12,11 +12,11 @@ tags:
 
 # Qalam-Net (قلم-نت): Advanced Arabic OCR (v2 Portable)
 
-Qalam-Net is a high-performance, cross-backend Optical Character Recognition (OCR) model for Arabic. This version (**v2**) has been patched for maximum portability across Keras versions and optimized for inference.
+Qalam-Net is a high-performance, cross-backend Optical Character Recognition (OCR) model for Arabic. Built on **Keras 3**, it supports **JAX**, **PyTorch**, and **TensorFlow** backends.
 
-## 🚀 Quick Start (Clean Inference)
+## 🚀 Quick Start (Robust Usage)
 
-Qalam-Net v2 no longer requires custom layers or complex setup during inference.
+For maximum reliability across all environments, use the `huggingface_hub` downloader.
 
 ### 1. Installation
 ```bash
@@ -31,12 +31,17 @@ os.environ["KERAS_BACKEND"] = "jax" # Options: "jax", "tensorflow", "torch"
 import keras
 import numpy as np
 import cv2
+from huggingface_hub import hf_hub_download
 
 class QalamNet:
     def __init__(self, repo_id="Ali0044/Qalam-Net"):
-        # Load the portable model directly from Hugging Face
-        # No 'custom_objects' or 'CTCLayer' required!
-        self.model = keras.saving.load_model(f"hf://{repo_id}")
+        # 1. Download the portable model file from the Hub
+        print(f"Downloading model from {repo_id}...")
+        model_path = hf_hub_download(repo_id=repo_id, filename="model.keras")
+        
+        # 2. Load the model (Self-contained v2 requires no custom_objects)
+        self.model = keras.saving.load_model(model_path)
+        print("Model loaded successfully!")
         
         # Standard Arabic Vocabulary
         self.vocab = [' ', '!', '"', '#', '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '=', '?', '[', ']', 'ء', 'آ', 'أ', 'ؤ', 'إ', 'ئ', 'ا', 'ب', 'ة', 'ت', 'ث', 'ج', 'ح', 'خ', 'د', 'ذ', 'ر', 'ز', 'س', 'ش', 'ص', 'ض', 'ط', 'ظ', 'ع', 'غ', 'ـ', 'ف', 'ق', 'ك', 'ل', 'م', 'ن', 'ه', 'و', 'ى', 'ي', 'ً', 'ٌ', 'ٍ', 'َ', 'ُ', 'ِ', 'ّ', 'ْ', '٠', '١', '٢', '٣', '٤', '٥', '٦', '٧', '٨', '٩']