280 lines
20 KiB
Markdown
280 lines
20 KiB
Markdown
# 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 --> |