🧠 AI Model Hub — ऑपरेटर गाइड

AI Model Hub & Engines वह जगह है जहाँ से ChitraCut के सारे न्यूरल मॉडल (background removal, face detect, upscale, object remove, OCR आदि) डाउनलोड और मैनेज होते हैं। मॉडल ऐप के साथ बंडल नहीं आते — जो टूल चाहिए, सिर्फ़ उसी का मॉडल डाउनलोड करें। डाउनलोड के बाद सारा काम 100% ऑफ़लाइन चलता है।

💡 मुख्य क्षमताएं (Key Capabilities):

• ONNX Runtime Engine कार्ड: इंजन इंस्टॉल न हो तो Download Engine से एक बार में इंस्टॉल — बाद में हर मॉडल उसी पर चलता है।
• मॉडल कैटलॉग: Background & Cutout (RMBG-1.4, U-2-Net, MODNet), Face & Portrait (UltraFace, GFPGAN, Face Mesh, Face Landmarker), Resolution & Clarity (Real-ESRGAN x4, DRUNet), Object Removal (LaMa), OCR और Document मॉडल।
• Download नियंत्रण: progress bar के साथ Pause / Resume / Cancel — बीच में रुका डाउनलोड बाद में आगे बढ़ता है।
• Import Offline Models: पेनड्राइव या दूसरे फोल्डर में रखे .onnx फाइलों को बिना कॉपी किए सीधे जोड़ (link) सकते हैं।
• Storage फोल्डर बदलें: डिफ़ॉल्ट AppData की जगह D:\ जैसी बड़ी ड्राइव चुन सकते हैं।

1. पेज खोलें: Settings → AI Models (या सीधे Model Manager पेज)। ऊपर बैज में X of Y Installed से पता चलता है कितने मॉडल तैयार हैं।
2. पहले इंजन जाँचें: ONNX Runtime Engine कार्ड पर हरा Ready (Installed) हो तो आगे बढ़ें। Engine Missing लिखा हो तो Download Engine दबाएं — progress % चलता रहेगा। फेल होने पर लाल संदेश के साथ Retry बटन आता है।
3. स्टोरेज फोल्डर तय करें: Model Download & Storage Directory में डिफ़ॉल्ट AppData / models/ दिखता है। Change Folder से D:\ChitraCutModels जैसा फोल्डर चुनें; वापस डिफ़ॉल्ट पर आना हो तो Reset दबाएं।
4. मॉडल डाउनलोड करें: जिस टूल का मॉडल चाहिए उस कार्ड पर Download Model दबाएं (कार्ड पर साइज़ पहले से लिखा है, जैसे ~176 MB)। नीचे की पट्टी में प्रतिशत और downloaded / total बाइट दिखते हैं।
5. रोकना/आगे बढ़ाना: डाउनलोड के दौरान Pause, रुकने पर Resume, पूरी तरह हटाने के लिए Cancel।
6. पूरा होने पर: कार्ड का बैज हरे रंग में 176.0 MB • Ready हो जाता है और नीचे Ready for Offline Use लिखा आता है। साथ में फाइल का लोकल पाथ और (Spec: ~176 MB) साइज़ तुलना दिखती है।
7. मॉडल चालू/बंद करें: कार्ड के कोने में छोटा टॉगल — बंद करने पर वह मॉडल टूल्स में इस्तेमाल नहीं होगा (फाइल डिलीट नहीं होती)।
8. हटाना: डस्टबिन आइकन दबाएं, पुष्टि का संदेश आएगा — Are you sure you want to delete <model name> (<size> MB)? — OK करने पर फाइल डिलीट हो जाती है।
9. ऑफ़लाइन इंपोर्ट (वैकल्पिक): Import Offline Models → Source Folder Path में फोल्डर लिखें या Browse... से चुनें → Scan & Import Now। नतीजे में Files Discovered और Models Imported गिनती दिखती है। फाइलें कॉपी नहीं होतीं, उसी जगह से लिंक होती हैं — पेनड्राइव निकालने पर मॉडल फिर नहीं मिलेगा।
10. रिफ्रेश: बाहर से फाइलें जोड़ने/हटाने के बाद Refresh दबाएं ताकि स्टेटस दोबारा पढ़ा जाए।

🔐 इंटीग्रिटी: हब का संदेश है कि डाउनलोड SHA-256 integrity verification के साथ होते हैं और फाइल साइज़ कैटलॉग की Spec (~MB) से मिलाई जाती है। अधूरी या खराब फाइल चलाने पर टूल साफ़ error देता है — incomplete or corrupted (actual size ... expected ~...), यानी गलत फाइल चुपचाप नहीं चलती।

• Disk space: RMBG-1.4 ~176 MB, LaMa ~208 MB, GFPGAN ~340 MB, DRUNet ~124.5 MB — सब मिलाकर लगभग 900 MB तक। C: ड्राइव भरी हो तो storage फोल्डर D: पर रखें।
• एक बार में एक डाउनलोड: पेज एक ही डाउनलोड सक्रिय रखता है; दूसरा मॉडल दबाने से पहले चालू वाला पूरा/रोकें।
• Model toggle: जो मॉडल रोज़ नहीं चाहिए उसे बंद रखें — टूल गलती से उसका इस्तेमाल नहीं करेगा; जगह घेरना बंद नहीं होगा, उसके लिए Delete करें।
• फाइल नाम न बदलें: इंपोर्ट सिर्फ़ तय नाम पहचानता है — rmbg.onnx, u2net.onnx, realesrgan.onnx, ultraface.onnx, lama.onnx, ddcolor-tiny-fp16.onnx, bisenet_resnet18.onnx, face_landmarker.onnx, face_mesh.onnx, gfpgan.onnx, modnet.onnx, ocr_det / ocr_rec आदि।
• इंजन एक ही बार: ONNX Runtime Engine हर मॉडल के लिए अलग डाउनलोड नहीं होता; एक इंस्टॉल सब जगह काम आता है।

1. दुकान बंद करते समय डाउनलोड शुरू करें — 340 MB का GFPGAN या 208 MB का LaMa दिन में नेट स्लो कर देगा; रात में छोड़ दें और सुबह Refresh से जाँचें।
2. दूसरे PC से मॉडल लाना सबसे तेज़ तरीका है: उस PC के models फोल्डर को पेनड्राइव में कॉपी करें, यहाँ Import Offline Models से जोड़ें — इंटरनेट की ज़रूरत नहीं।
3. सिर्फ़ काम के मॉडल रखें: पासपोर्ट स्टूडियो को UltraFace + RMBG + Real-ESRGAN से ही ज़्यादातर काम चल जाता है; OCR और Face Mesh जैसे भारी मॉडल बाद में जोड़ें।
4. मॉडल फोल्डर का बैकअप समय-समय पर लें — Windows सफाई या ऐप रीइंस्टॉल में मॉडल हट सकते हैं और दोबारा डाउनलोड में समय लगेगा।
5. मॉडल टेस्ट करने का तरीका: इस पेज पर अलग "Test" बटन नहीं है — संबंधित टूल खोलकर एक छोटी फोटो पर चलाएं; सही नतीजा आया तो मॉडल ठीक है।

• "Engine Missing" दिख रहा है: Download Engine दबाएं। डाउनलोड फेल हो तो लाल संदेश के साथ Retry करें; बार-बार फेल हो तो इंटरनेट/फायरवॉल जाँचें (सिर्फ़ डाउनलोड के लिए नेट चाहिए)।
• डाउनलोड बीच में अटक गया: Pause करके कुछ सेकंड बाद Resume दबाएं। बहुत देर तक 0% रहे तो Cancel करके दोबारा Download Model।
• "incomplete or corrupted ... expected ~X MB": फाइल आधी डाउनलोड हुई है। डस्टबिन से हटाएं और नए सिरे से डाउनलोड करें — अधूरी फाइल से टूल नहीं चलेगा।
• मॉडल "Ready" है पर टूल में "Not Downloaded" आ रहा है: Refresh दबाएं; फिर भी न हो तो storage फोल्डर बदला गया है — सही फोल्डर दोबारा चुनें या Import Offline Models से उसी जगह से लिंक करें।
• Import में "none matched supported model signatures": फोल्डर में फाइलों के नाम अलग हैं। फाइल का नाम बदलकर सपोर्टेड नाम (जैसे rmbg.onnx) रखें और फिर स्कैन करें।
• डिलीट के बाद टूल काम नहीं करेगा: मॉडल हटाने पर उस पर निर्भर टूल तब तक नहीं चलेंगे जब तक मॉडल दोबारा डाउनलोड न हो — पहले डाउनलोड, फिर टूल खोलें।