AI-For-Beginners/translations/hi/troubleshoot.md

AI-For-Beginners समस्या निवारण गाइड

यह गाइड आपको AI-For-Beginners रिपॉजिटरी का उपयोग करते समय या उसमें योगदान देते समय आने वाली सामान्य समस्याओं को हल करने में मदद करता है। प्रत्येक समस्या में पृष्ठभूमि, लक्षण, स्पष्टीकरण और चरण-दर-चरण समाधान शामिल हैं।

---

सामग्री तालिका

• सामान्य समस्याएं
• इंस्टॉलेशन समस्याएं
• कॉन्फ़िगरेशन समस्याएं
• नोटबुक चलाना
• प्रदर्शन समस्याएं
• पाठ्यपुस्तक वेबसाइट समस्याएं
• योगदान समस्याएं
• FAQ
• मदद प्राप्त करना

---

सामान्य समस्याएं

1. रिपॉजिटरी सही तरीके से क्लोन नहीं हो रही

पृष्ठभूमि: क्लोनिंग आपको रिपॉजिटरी को अपनी मशीन पर कॉपी करने की अनुमति देती है।

लक्षण:

• त्रुटि: fatal: repository not found
• त्रुटि: Permission denied (publickey)

संभावित कारण:

• गलत रिपॉजिटरी URL
• अपर्याप्त अनुमतियां
• SSH कुंजियां कॉन्फ़िगर नहीं की गईं

समाधान:

1. रिपॉजिटरी URL जांचें।
   HTTPS URL का उपयोग करें:

   git clone https://github.com/microsoft/AI-For-Beginners.git
   

2. SSH विफल होने पर HTTPS पर स्विच करें।
   यदि आपको Permission denied (publickey) दिखाई देता है, तो SSH के बजाय ऊपर दिए गए HTTPS लिंक का उपयोग करें।
3. SSH कुंजियां कॉन्फ़िगर करें (वैकल्पिक)।
   यदि आप SSH का उपयोग करना चाहते हैं, तो GitHub की SSH गाइड का पालन करें।

---

इंस्टॉलेशन समस्याएं

2. पायथन एनवायरनमेंट समस्याएं

पृष्ठभूमि: रिपॉजिटरी पायथन और विभिन्न लाइब्रेरी पर निर्भर करती है।

लक्षण:

• त्रुटि: ModuleNotFoundError: No module named '<package>'
• स्क्रिप्ट या नोटबुक चलाते समय इंपोर्ट त्रुटियां

संभावित कारण:

• डिपेंडेंसी इंस्टॉल नहीं की गई
• गलत पायथन संस्करण

समाधान:

1. वर्चुअल एनवायरनमेंट सेट करें।

   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   

2. डिपेंडेंसी इंस्टॉल करें।

   pip install -r requirements.txt
   

3. पायथन संस्करण जांचें।
   पायथन 3.7 या नया संस्करण उपयोग करें।

   python --version
   

3. जुपिटर इंस्टॉल नहीं है

पृष्ठभूमि: नोटबुक एक मुख्य शिक्षण संसाधन हैं।

लक्षण:

• त्रुटि: jupyter: command not found
• नोटबुक लॉन्च करने में विफल

संभावित कारण:

• जुपिटर इंस्टॉल नहीं है

समाधान:

1. जुपिटर नोटबुक इंस्टॉल करें।

   pip install notebook
   

   या, यदि आप Anaconda का उपयोग कर रहे हैं:

   conda install notebook
   

2. जुपिटर नोटबुक शुरू करें।

   jupyter notebook
   

4. डिपेंडेंसी संस्करण संघर्ष

पृष्ठभूमि: प्रोजेक्ट्स तब टूट सकते हैं जब पैकेज संस्करण मेल नहीं खाते।

लक्षण:

• असंगत संस्करणों के बारे में त्रुटियां या चेतावनियां

संभावित कारण:

• पुराने या विरोधी पायथन पैकेज

समाधान:

1. साफ एनवायरनमेंट में इंस्टॉल करें।
   पुराने venv/conda env को हटा दें और नया बनाएं।
2. सटीक संस्करण का उपयोग करें।
   हमेशा चलाएं:

   pip install -r requirements.txt
   

   यदि यह विफल होता है, तो README में वर्णित अनुसार मैन्युअल रूप से गायब पैकेज इंस्टॉल करें।

---

कॉन्फ़िगरेशन समस्याएं

5. एनवायरनमेंट वेरिएबल सेट नहीं हैं

पृष्ठभूमि: कुछ मॉड्यूल को कुंजियों, टोकन, या कॉन्फ़िग सेटिंग्स की आवश्यकता हो सकती है।

लक्षण:

• त्रुटि: KeyError या गायब कॉन्फ़िगरेशन के बारे में चेतावनियां

संभावित कारण:

• आवश्यक एनवायरनमेंट वेरिएबल सेट नहीं हैं

समाधान:

1. .env.example या समान फाइलों की जांच करें।
2. एक .env फाइल बनाएं और आवश्यक मान भरें।
3. एनवायरनमेंट वेरिएबल सेट करने के बाद अपना टर्मिनल या IDE पुनः लोड करें।

---

नोटबुक चलाना

6. नोटबुक खुल या चल नहीं रही

पृष्ठभूमि: जुपिटर नोटबुक को सही सेटअप की आवश्यकता होती है।

लक्षण:

• नोटबुक लॉन्च करने में विफल
• ब्राउज़र स्वचालित रूप से नहीं खुल रहा

संभावित कारण:

• जुपिटर इंस्टॉल नहीं है
• ब्राउज़र कॉन्फ़िगरेशन समस्याएं

समाधान:

1. जुपिटर इंस्टॉल करें (ऊपर इंस्टॉलेशन समस्याएं देखें)।
2. नोटबुक को मैन्युअल रूप से खोलें।
   • टर्मिनल से URL कॉपी करें (जैसे, http://localhost:8888/?token=...) और इसे अपने ब्राउज़र में पेस्ट करें।

7. कर्नेल क्रैश हो रहा है या फ्रीज कर रहा है

पृष्ठभूमि: नोटबुक कर्नेल संसाधन सीमाओं या कोड त्रुटियों के कारण क्रैश कर सकते हैं।

लक्षण:

• कर्नेल बार-बार मरता है या पुनः शुरू होता है
• मेमोरी की कमी की त्रुटियां

संभावित कारण:

• बड़े डेटा सेट
• असंगत कोड या पैकेज

समाधान:

1. कर्नेल पुनः शुरू करें।
   जुपिटर में "Restart Kernel" बटन का उपयोग करें।
2. मेमोरी उपयोग जांचें।
   अनावश्यक एप्लिकेशन बंद करें।
3. क्लाउड प्लेटफॉर्म पर नोटबुक चलाएं।
   Google Colab या Azure Notebooks का उपयोग करें।

---

प्रदर्शन समस्याएं

8. नोटबुक धीमी चल रही है

पृष्ठभूमि: कुछ AI कार्यों को महत्वपूर्ण मेमोरी और CPU की आवश्यकता होती है।

लक्षण:

• धीमा निष्पादन
• लैपटॉप का पंखा तेज़ चल रहा है

संभावित कारण:

• बड़े डेटा सेट या मॉडल
• सीमित सिस्टम संसाधन

समाधान:

1. क्लाउड प्लेटफॉर्म का उपयोग करें।
   • नोटबुक को Colab या Azure Notebooks पर अपलोड करें।
2. डेटा सेट का आकार कम करें।
   • अभ्यास के लिए नमूना डेटा का उपयोग करें।
3. अनावश्यक प्रोग्राम बंद करें।
   • सिस्टम RAM खाली करें।

---

पाठ्यपुस्तक वेबसाइट समस्याएं

9. अध्याय लोड नहीं हो रहा

पृष्ठभूमि: ऑनलाइन पाठ्यपुस्तक पाठ और अध्याय प्रदर्शित करती है।

लक्षण:

• कोई अध्याय (जैसे, Transformers/BERT) गायब है या खुल नहीं रहा

ज्ञात समस्या:

• Issue #303: “18 Transformers. BERT. पाठ्यपुस्तक वेबसाइट पर नहीं खुल रहा।” फ़ाइल नाम त्रुटि (READMEtransformers.md के बजाय README.md) के कारण।

समाधान:

1. फ़ाइल नामकरण त्रुटियों की जांच करें।
   यदि आप योगदानकर्ता हैं, तो सुनिश्चित करें कि अध्याय फाइलें README.md नामित हैं।
2. गायब फाइलों की रिपोर्ट करें।
   अध्याय नाम और त्रुटि विवरण के साथ एक GitHub समस्या खोलें।

---

योगदान समस्याएं

10. PR स्वीकार नहीं हो रहा या बिल्ड विफल हो रहे हैं

पृष्ठभूमि: योगदान को परीक्षण पास करना और दिशानिर्देशों का पालन करना चाहिए।

लक्षण:

• पुल अनुरोध अस्वीकार कर दिया गया
• CI/CD पाइपलाइन त्रुटियां

संभावित कारण:

• परीक्षण विफल हो रहे हैं
• कोडिंग मानकों का पालन नहीं किया गया

समाधान:

1. योगदान दिशानिर्देश पढ़ें।
   • रिपॉजिटरी के CONTRIBUTING.md का पालन करें।
2. पुश करने से पहले स्थानीय रूप से परीक्षण चलाएं।
3. लिंटिंग नियम या फॉर्मेटिंग आवश्यकताओं की जांच करें।

---

FAQ

मैं विशिष्ट मॉड्यूल के लिए मदद कहां पा सकता हूं?

• प्रत्येक मॉड्यूल में आमतौर पर अपना README होता है। सेटअप और उपयोग युक्तियों के लिए वहां से शुरू करें।

मैं बग रिपोर्ट या फीचर अनुरोध कैसे कर सकता हूं?

• GitHub Issue खोलें जिसमें स्पष्ट विवरण और पुन: उत्पन्न करने के चरण हों।

क्या मैं मदद मांग सकता हूं यदि मेरी समस्या सूचीबद्ध नहीं है?

• हां! पहले मौजूदा मुद्दों को खोजें, और यदि आपको अपनी समस्या नहीं मिलती है, तो एक नया मुद्दा बनाएं।

---

मदद प्राप्त करना

• मुद्दों की जांच करें: GitHub Issues
• प्रश्न पूछें: GitHub Discussions का उपयोग करें या एक मुद्दा खोलें।
• समुदाय: चैट/फोरम विकल्पों के लिए रिपॉजिटरी लिंक देखें।

---

अंतिम अपडेट: 2025-09-20

---

अस्वीकरण:
यह दस्तावेज़ AI अनुवाद सेवा Co-op Translator का उपयोग करके अनुवादित किया गया है। जबकि हम सटीकता सुनिश्चित करने का प्रयास करते हैं, कृपया ध्यान दें कि स्वचालित अनुवाद में त्रुटियां या अशुद्धियां हो सकती हैं। मूल भाषा में उपलब्ध मूल दस्तावेज़ को प्रामाणिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सिफारिश की जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम उत्तरदायी नहीं हैं।