# AI-For-Beginners समस्या निराकरण मार्गदर्शक

ही मार्गदर्शिका [AI-For-Beginners](https://github.com/microsoft/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 मार्गदर्शक](https://docs.github.com/en/authentication/connecting-to-github-with-ssh) अनुसरा.

---

## स्थापना समस्या

### 2. Python पर्यावरण समस्या

**पार्श्वभूमी:** रेपॉझिटरी Python आणि विविध लायब्ररींवर अवलंबून आहे.

**लक्षणे:**
- त्रुटी: `ModuleNotFoundError: No module named '<package>'`
- स्क्रिप्ट किंवा नोटबुक चालवताना आयात त्रुटी

**संभाव्य कारणे:**
- आवश्यक लायब्ररी स्थापित केलेल्या नाहीत
- चुकीचा Python आवृत्ती

**उपाय:**
1. **व्हर्च्युअल पर्यावरण सेट करा.**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   ```
2. **आवश्यक लायब्ररी स्थापित करा.**  
   ```bash
   pip install -r requirements.txt
   ```
3. **Python आवृत्ती तपासा.**  
   Python 3.7 किंवा नवीन आवृत्ती वापरा.  
   ```bash
   python --version
   ```

### 3. Jupyter स्थापित केलेले नाही

**पार्श्वभूमी:** नोटबुक्स हे मुख्य शिक्षण संसाधन आहेत.

**लक्षणे:**
- त्रुटी: `jupyter: command not found`
- नोटबुक्स सुरू होत नाहीत

**संभाव्य कारणे:**
- Jupyter स्थापित केलेले नाही

**उपाय:**
1. **Jupyter Notebook स्थापित करा.**  
   ```bash
   pip install notebook
   ```
   किंवा, Anaconda वापरत असल्यास:
   ```bash
   conda install notebook
   ```
2. **Jupyter Notebook सुरू करा.**  
   ```bash
   jupyter notebook
   ```

### 4. लायब्ररी आवृत्ती संघर्ष

**पार्श्वभूमी:** प्रकल्प लायब्ररी आवृत्ती जुळत नसल्यास बिघडू शकतो.

**लक्षणे:**
- असमर्थनीय आवृत्त्यांबद्दल त्रुटी किंवा चेतावणी

**संभाव्य कारणे:**
- जुने किंवा संघर्ष करणारे Python पॅकेजेस

**उपाय:**
1. **स्वच्छ पर्यावरणात स्थापित करा.**  
   जुने venv/conda पर्यावरण हटवा आणि नवीन तयार करा.
2. **अचूक आवृत्त्या वापरा.**  
   नेहमी चालवा:  
   ```bash
   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](https://colab.research.google.com/) किंवा [Azure Notebooks](https://notebooks.azure.com/) वापरा.

---

## कामगिरी समस्या

### 8. नोटबुक्स हळू चालत आहेत

**पार्श्वभूमी:** काही AI कार्यांसाठी महत्त्वपूर्ण मेमरी आणि CPU आवश्यक असते.

**लक्षणे:**
- हळू अंमलबजावणी
- लॅपटॉपचा फॅन जोरात चालतो

**संभाव्य कारणे:**
- मोठे डेटासेट्स किंवा मॉडेल्स
- मर्यादित सिस्टम संसाधने

**उपाय:**
1. **क्लाउड प्लॅटफॉर्म वापरा.**
   - नोटबुक Colab किंवा Azure Notebooks वर अपलोड करा.
2. **डेटासेट आकार कमी करा.**
   - सरावासाठी नमुना डेटा वापरा.
3. **अनावश्यक प्रोग्राम्स बंद करा.**
   - सिस्टम RAM मोकळा करा.

---

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

### 9. अध्याय लोड होत नाही

**पार्श्वभूमी:** ऑनलाइन पाठ्यपुस्तक धडे आणि अध्याय प्रदर्शित करते.

**लक्षणे:**
- एखादा अध्याय (उदा., Transformers/BERT) गहाळ आहे किंवा उघडत नाही

**ज्ञात समस्या:**  
- [Issue #303](https://github.com/microsoft/AI-For-Beginners/issues/303): “18 Transformers. BERT. पाठ्यपुस्तक वेबसाइटवर उघडता येत नाही.” फाइल नावाच्या त्रुटीमुळे (`READMEtransformers.md` ऐवजी `README.md`).

**उपाय:**
1. **फाइल पुनर्नामकरण त्रुटी तपासा.**  
   जर तुम्ही योगदानकर्ता असाल, तर अध्याय फाइल्सचे नाव `README.md` असल्याची खात्री करा.
2. **गहाळ फाइल्सची तक्रार करा.**  
   अध्यायाचे नाव आणि त्रुटी तपशीलांसह GitHub समस्या उघडा.

---

## योगदान समस्या

### 10. PR स्वीकारले जात नाही किंवा बिल्ड अयशस्वी होत आहे

**पार्श्वभूमी:** योगदान चाचण्या पास करणे आणि मार्गदर्शकांचे पालन करणे आवश्यक आहे.

**लक्षणे:**
- पुल विनंती नाकारली जाते
- CI/CD पाइपलाइन त्रुटी

**संभाव्य कारणे:**
- अयशस्वी चाचण्या
- कोडिंग मानकांचे पालन न करणे

**उपाय:**
1. **योगदान मार्गदर्शक वाचा.**
   - रेपॉझिटरीचे [CONTRIBUTING.md](https://github.com/microsoft/AI-For-Beginners/blob/main/CONTRIBUTING.md) अनुसरा.
2. **पुश करण्यापूर्वी स्थानिक चाचण्या चालवा.**
3. **लिंटिंग नियम किंवा फॉरमॅटिंग आवश्यकता तपासा.**

---

## वारंवार विचारले जाणारे प्रश्न (FAQ)

### विशिष्ट मॉड्यूल्ससाठी मला मदत कुठे मिळेल?
- प्रत्येक मॉड्यूलमध्ये सामान्यतः स्वतःचा README असतो. सेटअप आणि वापर टिप्ससाठी तिथे सुरुवात करा.

### मी बग कसा रिपोर्ट करू किंवा फीचरची विनंती कशी करू?
- [GitHub समस्या उघडा](https://github.com/microsoft/AI-For-Beginners/issues/new) स्पष्ट वर्णन आणि पुनरुत्पादन चरणांसह.

### माझी समस्या सूचीबद्ध नसल्यास मी मदत मागू शकतो का?
- होय! विद्यमान समस्यांचा शोध घ्या, आणि जर तुम्हाला तुमची समस्या सापडली नाही, तर नवीन समस्या तयार करा.

---

## मदत मिळवणे

- **समस्या तपासा:** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **प्रश्न विचारा:** GitHub Discussions वापरा किंवा समस्या उघडा.
- **समुदाय:** चॅट/फोरम पर्यायांसाठी रेपॉझिटरी लिंक पहा.

---

_शेवटचे अद्यतन: 2025-09-20_

---

**अस्वीकरण**:  
हा दस्तऐवज AI भाषांतर सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी कृपया लक्षात ठेवा की स्वयंचलित भाषांतरांमध्ये त्रुटी किंवा अचूकतेचा अभाव असू शकतो. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.