# AI-For-Beginners പ്രശ്നപരിഹാര ഗൈഡ്

[AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners) റിപോസിറ്ററി ഉപയോഗിക്കുമ്പോഴോ സംഭാവന നൽകുമ്പോഴോ നേരിടുന്ന സാധാരണ പ്രശ്നങ്ങൾ പരിഹരിക്കാൻ ഈ ഗൈഡ് സഹായിക്കും. ഓരോ പ്രശ്നത്തിനും പശ്ചാത്തലം, ലക്ഷണങ്ങൾ, വിശദീകരണങ്ങൾ, ഘട്ടം ഘട്ടമായ പരിഹാരങ്ങൾ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്.

---

## ഉള്ളടക്ക പട്ടിക

- [പൊതുവായ പ്രശ്നങ്ങൾ](../..)
- [ഇൻസ്റ്റലേഷൻ പ്രശ്നങ്ങൾ](../..)
- [കോൺഫിഗറേഷൻ പ്രശ്നങ്ങൾ](../..)
- [നോട്ട്ബുക്കുകൾ പ്രവർത്തിപ്പിക്കൽ](../..)
- [പ്രകടന പ്രശ്നങ്ങൾ](../..)
- [ടെക്സ്റ്റ്ബുക്ക് വെബ്സൈറ്റ് പ്രശ്നങ്ങൾ](../..)
- [സംഭാവന സംബന്ധമായ പ്രശ്നങ്ങൾ](../..)
- [അടിക്കുറിപ്പുകൾ](../..)
- [സഹായം ലഭ്യമാക്കൽ](../..)

---

## പൊതുവായ പ്രശ്നങ്ങൾ

### 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   # 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. can't be opened on the textbook website.” ഫയൽനെയിം പിശക് കാരണം (`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. **ലിന്റിംഗ് നിയമങ്ങൾ അല്ലെങ്കിൽ ഫോർമാറ്റിംഗ് ആവശ്യകതകൾ പരിശോധിക്കുക.**

---

## അടിക്കുറിപ്പുകൾ

### പ്രത്യേക മോഡ്യൂളുകൾക്കായി എവിടെ സഹായം ലഭിക്കും?
- ഓരോ മോഡ്യൂളിനും സാധാരണയായി സ്വന്തം README ഉണ്ട്. അവിടെ നിന്ന് സജ്ജീകരണവും ഉപയോഗവും സംബന്ധിച്ച ടിപ്പുകൾ തുടങ്ങുക.

### പിശക് റിപ്പോർട്ട് ചെയ്യാനോ ഫീച്ചർ അഭ്യർത്ഥിക്കാനോ എങ്ങനെ?
- [GitHub Issue തുറക്കുക](https://github.com/microsoft/AI-For-Beginners/issues/new) വ്യക്തമായ വിവരണവും പുനരാവർത്തന ഘട്ടങ്ങളും ഉൾപ്പെടുത്തി.

### എന്റെ പ്രശ്നം പട്ടികയിൽ ഇല്ലെങ്കിൽ സഹായം ചോദിക്കാമോ?
- തീർച്ചയായും! നിലവിലുള്ള ഇഷ്യൂകൾ ആദ്യം തിരയുക, നിങ്ങളുടെ പ്രശ്നം കണ്ടെത്താനാകുന്നില്ലെങ്കിൽ പുതിയ ഇഷ്യൂ സൃഷ്ടിക്കുക.

---

## സഹായം ലഭ്യമാക്കൽ

- **ഇഷ്യൂകൾ പരിശോധിക്കുക:** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **ചോദ്യങ്ങൾ ചോദിക്കുക:** GitHub Discussions ഉപയോഗിക്കുക അല്ലെങ്കിൽ ഇഷ്യൂ തുറക്കുക.
- **സമൂഹം:** ചാറ്റ്/ഫോറം ഓപ്ഷനുകൾക്കായി റിപോസിറ്ററി ലിങ്കുകൾ കാണുക.

---

_അവസാനമായി അപ്ഡേറ്റ് ചെയ്തത്: 2025-09-20_

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**അസൂയാ**:  
ഈ രേഖ AI വിവർത്തന സേവനം [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. നാം കൃത്യതയ്ക്ക് ശ്രമിച്ചിട്ടുണ്ടെങ്കിലും, സ്വയം പ്രവർത്തിക്കുന്ന വിവർത്തനങ്ങളിൽ പിശകുകൾ അല്ലെങ്കിൽ തെറ്റുകൾ ഉണ്ടാകാമെന്ന് ദയവായി ശ്രദ്ധിക്കുക. അതിന്റെ മാതൃഭാഷയിലുള്ള യഥാർത്ഥ രേഖ അധികാരപരമായ ഉറവിടമായി കണക്കാക്കപ്പെടണം. നിർണായക വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശുപാർശ ചെയ്യപ്പെടുന്നു. ഈ വിവർത്തനം ഉപയോഗിക്കുന്നതിൽ നിന്നുണ്ടാകുന്ന ഏതെങ്കിലും തെറ്റിദ്ധാരണകൾക്കോ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കോ ഞങ്ങൾ ഉത്തരവാദികളല്ല.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->