RomanNum3ral
/
AI-For-Beginners
mirror of https://github.com/microsoft/AI-For-Beginners.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AI-For-Beginners/translations/ml/troubleshoot.md

20 KiB
Raw Blame History

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

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 ഗൈഡ് പിന്തുടരുക.

ഇൻസ്റ്റലേഷൻ പ്രശ്നങ്ങൾ

2. Python പരിസ്ഥിതി പ്രശ്നങ്ങൾ

പശ്ചാത്തലം: റിപോസിറ്ററി Python-നും വിവിധ ലൈബ്രറികളുടെയും ആശ്രിതമാണ്.

ലക്ഷണങ്ങൾ:

  • പിശക്: ModuleNotFoundError: No module named '<package>'
  • സ്ക്രിപ്റ്റുകൾ അല്ലെങ്കിൽ നോട്ട്ബുക്കുകൾ പ്രവർത്തിപ്പിക്കുമ്പോൾ ഇറക്കുമതി പിശകുകൾ

സാധ്യമായ കാരണങ്ങൾ:

  • ആശ്രിതങ്ങൾ ഇൻസ്റ്റാൾ ചെയ്തിട്ടില്ല
  • തെറ്റായ Python പതിപ്പ്

പരിഹാരങ്ങൾ:

  1. വിർച്വൽ എൻവയോൺമെന്റ് സജ്ജമാക്കുക. 
    python -m venv venv
source venv/bin/activate   # 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 പരിസ്ഥിതി നീക്കം ചെയ്ത് പുതിയത് സൃഷ്ടിക്കുക.
  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. can't be opened on the textbook website.” ഫയൽനെയിം പിശക് കാരണം (READMEtransformers.md എന്നത് README.md ആയിരിക്കേണ്ടത്).

പരിഹാരങ്ങൾ:

  1. ഫയൽ നാമം പിശകുകൾ പരിശോധിക്കുക.
    സംഭാവന നൽകുന്നവർക്ക് അധ്യായ ഫയലുകൾ README.md എന്ന പേരിൽ നാമകരണം ചെയ്തിട്ടുണ്ടെന്ന് ഉറപ്പാക്കുക.
  2. നഷ്ടപ്പെട്ട ഫയലുകൾ റിപ്പോർട്ട് ചെയ്യുക.
    GitHub-ൽ അധ്യായത്തിന്റെ പേര്, പിശക് വിശദാംശങ്ങൾ ഉൾപ്പെടുത്തി ഒരു ഇഷ്യൂ തുറക്കുക.

സംഭാവന സംബന്ധമായ പ്രശ്നങ്ങൾ

10. PR അംഗീകരിക്കപ്പെടുന്നില്ല അല്ലെങ്കിൽ ബിൽഡുകൾ പരാജയപ്പെടുന്നു

പശ്ചാത്തലം: സംഭാവനകൾ ടെസ്റ്റുകൾ കടന്നുപോകണം, മാർഗനിർദ്ദേശങ്ങൾ പാലിക്കണം.

ലക്ഷണങ്ങൾ:

  • പുൾ റിക്വസ്റ്റ് നിരസിച്ചു
  • CI/CD പൈപ്പ്‌ലൈൻ പിശകുകൾ

സാധ്യമായ കാരണങ്ങൾ:

  • ടെസ്റ്റുകൾ പരാജയപ്പെട്ടു
  • കോഡിംഗ് സ്റ്റാൻഡേർഡുകൾ പാലിച്ചില്ല

പരിഹാരങ്ങൾ:

  1. സംഭാവന മാർഗനിർദ്ദേശങ്ങൾ വായിക്കുക.
    റിപോസിറ്ററിയുടെ CONTRIBUTING.md പിന്തുടരുക.
  2. പുഷ് ചെയ്യുന്നതിന് മുമ്പ് ടെസ്റ്റുകൾ ലോക്കലായി പ്രവർത്തിപ്പിക്കുക.
  3. ലിന്റിംഗ് നിയമങ്ങൾ അല്ലെങ്കിൽ ഫോർമാറ്റിംഗ് ആവശ്യകതകൾ പരിശോധിക്കുക.

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

പ്രത്യേക മോഡ്യൂളുകൾക്കായി എവിടെ സഹായം ലഭിക്കും?

  • ഓരോ മോഡ്യൂളിനും സാധാരണയായി സ്വന്തം README ഉണ്ട്. അവിടെ നിന്ന് സജ്ജീകരണവും ഉപയോഗവും സംബന്ധിച്ച ടിപ്പുകൾ തുടങ്ങുക.

പിശക് റിപ്പോർട്ട് ചെയ്യാനോ ഫീച്ചർ അഭ്യർത്ഥിക്കാനോ എങ്ങനെ?

  • GitHub Issue തുറക്കുക വ്യക്തമായ വിവരണവും പുനരാവർത്തന ഘട്ടങ്ങളും ഉൾപ്പെടുത്തി.

എന്റെ പ്രശ്നം പട്ടികയിൽ ഇല്ലെങ്കിൽ സഹായം ചോദിക്കാമോ?

  • തീർച്ചയായും! നിലവിലുള്ള ഇഷ്യൂകൾ ആദ്യം തിരയുക, നിങ്ങളുടെ പ്രശ്നം കണ്ടെത്താനാകുന്നില്ലെങ്കിൽ പുതിയ ഇഷ്യൂ സൃഷ്ടിക്കുക.

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

  • ഇഷ്യൂകൾ പരിശോധിക്കുക: GitHub Issues
  • ചോദ്യങ്ങൾ ചോദിക്കുക: GitHub Discussions ഉപയോഗിക്കുക അല്ലെങ്കിൽ ഇഷ്യൂ തുറക്കുക.
  • സമൂഹം: ചാറ്റ്/ഫോറം ഓപ്ഷനുകൾക്കായി റിപോസിറ്ററി ലിങ്കുകൾ കാണുക.

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

അസൂയാ:
ഈ രേഖ AI വിവർത്തന സേവനം Co-op Translator ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. നാം കൃത്യതയ്ക്ക് ശ്രമിച്ചിട്ടുണ്ടെങ്കിലും, സ്വയം പ്രവർത്തിക്കുന്ന വിവർത്തനങ്ങളിൽ പിശകുകൾ അല്ലെങ്കിൽ തെറ്റുകൾ ഉണ്ടാകാമെന്ന് ദയവായി ശ്രദ്ധിക്കുക. അതിന്റെ മാതൃഭാഷയിലുള്ള യഥാർത്ഥ രേഖ അധികാരപരമായ ഉറവിടമായി കണക്കാക്കപ്പെടണം. നിർണായക വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശുപാർശ ചെയ്യപ്പെടുന്നു. ഈ വിവർത്തനം ഉപയോഗിക്കുന്നതിൽ നിന്നുണ്ടാകുന്ന ഏതെങ്കിലും തെറ്റിദ്ധാരണകൾക്കോ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കോ ഞങ്ങൾ ഉത്തരവാദികളല്ല.