AI-For-Beginners/translations/ne/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. Python वातावरण समस्याहरू

पृष्ठभूमि: रिपोजिटरी Python र विभिन्न पुस्तकालयहरूमा निर्भर गर्दछ।

लक्षणहरू:

• त्रुटि: ModuleNotFoundError: No module named '<package>'
• स्क्रिप्ट वा नोटबुक चलाउँदा आयात त्रुटिहरू

सम्भावित कारणहरू:

• निर्भरता स्थापना गरिएको छैन
• गलत Python संस्करण

समाधानहरू:

1. भर्चुअल वातावरण सेटअप गर्नुहोस्।

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

2. निर्भरता स्थापना गर्नुहोस्।

   pip install -r requirements.txt
   

3. Python संस्करण जाँच गर्नुहोस्।
   Python 3.7 वा नयाँ संस्करण प्रयोग गर्नुहोस्।

   python --version
   

3. Jupyter स्थापना गरिएको छैन

पृष्ठभूमि: नोटबुकहरू मुख्य सिकाइ स्रोत हुन्।

लक्षणहरू:

• त्रुटि: jupyter: command not found
• नोटबुकहरू सुरु हुन सकेन

सम्भावित कारणहरू:

• Jupyter स्थापना गरिएको छैन

समाधानहरू:

1. Jupyter Notebook स्थापना गर्नुहोस्।

   pip install notebook
   

   वा, यदि Anaconda प्रयोग गर्दै हुनुहुन्छ भने:

   conda install notebook
   

2. Jupyter Notebook सुरु गर्नुहोस्।

   jupyter notebook
   

4. निर्भरता संस्करण द्वन्द्व

पृष्ठभूमि: यदि प्याकेज संस्करणहरू मेल खाँदैनन् भने परियोजनाहरू बिग्रन सक्छन्।

लक्षणहरू:

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

सम्भावित कारणहरू:

• पुरानो वा द्वन्द्वात्मक Python प्याकेजहरू

समाधानहरू:

1. सफा वातावरणमा स्थापना गर्नुहोस्।
   पुरानो venv/conda env मेटाउनुहोस् र नयाँ बनाउनुहोस्।
2. ठ्याक्कै संस्करणहरू प्रयोग गर्नुहोस्।
   सधैं चलाउनुहोस्:

   pip install -r requirements.txt
   

   यदि यो असफल भयो भने, README मा वर्णन गरिएको अनुसार हराइरहेका प्याकेजहरू म्यानुअली स्थापना गर्नुहोस्।

---

कन्फिगरेसन समस्याहरू

5. वातावरण चरहरू सेट गरिएको छैन

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

लक्षणहरू:

• त्रुटि: KeyError वा हराइरहेको कन्फिगरेसनको बारेमा चेतावनीहरू

सम्भावित कारणहरू:

• आवश्यक वातावरण चरहरू सेट गरिएको छैन

समाधानहरू:

1. .env.example वा यस्तै फाइलहरूको लागि जाँच गर्नुहोस्।
2. .env फाइल बनाउनुहोस् र आवश्यक मानहरू भर्नुहोस्।
3. वातावरण चरहरू सेट गरेपछि आफ्नो टर्मिनल वा IDE पुनः लोड गर्नुहोस्।

---

नोटबुक चलाउने

6. नोटबुक खोल्न वा चलाउन सकिएन

पृष्ठभूमि: Jupyter नोटबुकहरूलाई उचित सेटअप आवश्यक छ।

लक्षणहरू:

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

सम्भावित कारणहरू:

• Jupyter स्थापना गरिएको छैन
• ब्राउजर कन्फिगरेसन समस्याहरू

समाधानहरू:

1. Jupyter स्थापना गर्नुहोस् (माथिको स्थापना समस्याहरू हेर्नुहोस्)।
2. नोटबुकहरू म्यानुअली खोल्नुहोस्।
   • टर्मिनलबाट URL (जस्तै, http://localhost:8888/?token=...) प्रतिलिपि गर्नुहोस् र आफ्नो ब्राउजरमा टाँस्नुहोस्।

7. कर्नेल क्र्यास वा फ्रिज हुँदैछ

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

लक्षणहरू:

• कर्नेल बारम्बार मर्छ वा पुनः सुरु हुन्छ
• मेमोरी सकिएको त्रुटिहरू

सम्भावित कारणहरू:

• ठूला डेटासेटहरू
• असंगत कोड वा प्याकेजहरू

समाधानहरू:

1. कर्नेल पुनः सुरु गर्नुहोस्।
   Jupyter मा "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 प्रयोग गरेर अनुवाद गरिएको छ। हामी शुद्धताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादहरूमा त्रुटि वा अशुद्धता हुन सक्छ। यसको मूल भाषा मा रहेको मूल दस्तावेजलाई आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुने छैनौं।