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/pa/troubleshoot.md

15 KiB
Raw Blame History

AI-For-Beginners Troubleshooting Guide

ਇਹ ਗਾਈਡ ਤੁਹਾਨੂੰ AI-For-Beginners ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਵਰਤੋਂ ਜਾਂ ਯੋਗਦਾਨ ਦੇਣ ਦੌਰਾਨ ਆਮ ਸਮੱਸਿਆਵਾਂ ਨੂੰ ਹੱਲ ਕਰਨ ਵਿੱਚ ਮਦਦ ਕਰਦੀ ਹੈ। ਹਰ ਸਮੱਸਿਆ ਵਿੱਚ ਪਿਛੋਕੜ, ਲੱਛਣ, ਵਿਆਖਿਆਵਾਂ ਅਤੇ ਕਦਮ-ਦਰ-ਕਦਮ ਹੱਲ ਸ਼ਾਮਲ ਹਨ।

ਸੂਚੀ

ਆਮ ਸਮੱਸਿਆਵਾਂ

1. ਰਿਪੋਜ਼ਟਰੀ ਠੀਕ ਤਰੀਕੇ ਨਾਲ ਕਲੋਨ ਨਹੀਂ ਹੋ ਰਹੀ

ਪਿਛੋਕੜ: ਕਲੋਨਿੰਗ ਤੁਹਾਨੂੰ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਆਪਣੇ ਮਸ਼ੀਨ 'ਤੇ ਕਾਪੀ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦੀ ਹੈ।

ਲੱਛਣ:

  • Error: fatal: repository not found
  • Error: 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 ਅਤੇ ਵੱਖ-ਵੱਖ ਲਾਇਬ੍ਰੇਰੀਆਂ 'ਤੇ ਨਿਰਭਰ ਹੈ।

ਲੱਛਣ:

  • Error: ModuleNotFoundError: No module named '<package>'
  • ਸਕ੍ਰਿਪਟਾਂ ਜਾਂ ਨੋਟਬੁੱਕ ਚਲਾਉਣ ਦੌਰਾਨ ਇੰਪੋਰਟ ਸਮੱਸਿਆਵਾਂ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • Dependencies ਇੰਸਟਾਲ ਨਹੀਂ ਕੀਤੀਆਂ
  • ਗਲਤ Python ਵਰਜਨ

ਹੱਲ:

  1. ਵਰਚੁਅਲ ਐਨਵਾਇਰਨਮੈਂਟ ਸੈਟਅੱਪ ਕਰੋ। 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. Dependencies ਇੰਸਟਾਲ ਕਰੋ। 
    pip install -r requirements.txt
  3. Python ਵਰਜਨ ਦੀ ਜਾਂਚ ਕਰੋ।
    Python 3.7 ਜਾਂ ਨਵਾਂ ਵਰਜਨ ਵਰਤੋ। 
    python --version

3. Jupyter ਇੰਸਟਾਲ ਨਹੀਂ ਹੈ

ਪਿਛੋਕੜ: ਨੋਟਬੁੱਕ ਇੱਕ ਮੁੱਖ ਸਿਖਲਾਈ ਸਰੋਤ ਹਨ।

ਲੱਛਣ:

  • Error: jupyter: command not found
  • ਨੋਟਬੁੱਕ ਲਾਂਚ ਕਰਨ ਵਿੱਚ ਅਸਫਲ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • Jupyter ਇੰਸਟਾਲ ਨਹੀਂ ਹੈ

ਹੱਲ:

  1. Jupyter Notebook ਇੰਸਟਾਲ ਕਰੋ। 
    pip install notebook
    ਜਾਂ, ਜੇ Anaconda ਦੀ ਵਰਤੋਂ ਕਰ ਰਹੇ ਹੋ: 
    conda install notebook
  2. Jupyter Notebook ਸ਼ੁਰੂ ਕਰੋ। 
    jupyter notebook

4. Dependency ਵਰਜਨ ਸੰਘਰਸ਼

ਪਿਛੋਕੜ: ਜੇ ਪੈਕੇਜ ਵਰਜਨ ਅਣਮਿਲੇ ਹੋਣ, ਤਾਂ ਪ੍ਰੋਜੈਕਟ ਟੁੱਟ ਸਕਦੇ ਹਨ।

ਲੱਛਣ:

  • ਅਣਮਿਲੇ ਵਰਜਨ ਬਾਰੇ Errors ਜਾਂ ਚੇਤਾਵਨੀਆਂ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • ਪੁਰਾਣੇ ਜਾਂ ਸੰਘਰਸ਼ਤ Python ਪੈਕੇਜ

ਹੱਲ:

  1. ਸਾਫ ਐਨਵਾਇਰਨਮੈਂਟ ਵਿੱਚ ਇੰਸਟਾਲ ਕਰੋ।
    ਪੁਰਾਣੇ venv/conda env ਨੂੰ ਮਿਟਾਓ ਅਤੇ ਨਵਾਂ ਬਣਾਓ।
  2. ਸਹੀ ਵਰਜਨ ਦੀ ਵਰਤੋਂ ਕਰੋ।
    ਹਮੇਸ਼ਾ ਚਲਾਓ: 
    pip install -r requirements.txt
    ਜੇ ਇਹ ਫੇਲ ਹੋਵੇ, ਤਾਂ README ਵਿੱਚ ਦਿੱਤੇ ਹਦਾਇਤਾਂ ਅਨੁਸਾਰ ਗੁੰਮ ਪੈਕੇਜ ਨੂੰ ਹੱਥੋਂ ਇੰਸਟਾਲ ਕਰੋ।

ਕੰਫਿਗਰੇਸ਼ਨ ਸਮੱਸਿਆਵਾਂ

5. ਐਨਵਾਇਰਨਮੈਂਟ ਵੈਰੀਏਬਲ ਸੈਟ ਨਹੀਂ ਕੀਤੇ

ਪਿਛੋਕੜ: ਕੁਝ ਮੋਡੀਊਲ ਕੁੰਜੀਆਂ, ਟੋਕਨ ਜਾਂ ਕਨਫਿਗਰੇਸ਼ਨ ਸੈਟਿੰਗਾਂ ਦੀ ਲੋੜ ਕਰਦੇ ਹਨ।

ਲੱਛਣ:

  • Error: KeyError ਜਾਂ ਗੁੰਮ ਕਨਫਿਗਰੇਸ਼ਨ ਬਾਰੇ ਚੇਤਾਵਨੀਆਂ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • ਲੋੜੀਂਦੇ ਐਨਵਾਇਰਨਮੈਂਟ ਵੈਰੀਏਬਲ ਸੈਟ ਨਹੀਂ ਕੀਤੇ

ਹੱਲ:

  1. .env.example ਜਾਂ ਇਸ ਤਰ੍ਹਾਂ ਦੀਆਂ ਫਾਈਲਾਂ ਦੀ ਜਾਂਚ ਕਰੋ।
  2. .env ਫਾਈਲ ਬਣਾਓ ਅਤੇ ਲੋੜੀਂਦੇ ਮੁੱਲ ਭਰੋ।
  3. ਐਨਵਾਇਰਨਮੈਂਟ ਵੈਰੀਏਬਲ ਸੈਟ ਕਰਨ ਤੋਂ ਬਾਅਦ ਆਪਣਾ ਟਰਮੀਨਲ ਜਾਂ IDE ਰੀਲੋਡ ਕਰੋ।

ਨੋਟਬੁੱਕ ਚਲਾਉਣਾ

6. ਨੋਟਬੁੱਕ ਖੁਲ ਨਹੀਂ ਰਹੀ ਜਾਂ ਚਲ ਨਹੀਂ ਰਹੀ

ਪਿਛੋਕੜ: Jupyter ਨੋਟਬੁੱਕ ਨੂੰ ਠੀਕ ਸੈਟਅੱਪ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।

ਲੱਛਣ:

  • ਨੋਟਬੁੱਕ ਲਾਂਚ ਕਰਨ ਵਿੱਚ ਅਸਫਲ
  • ਬ੍ਰਾਊਜ਼ਰ ਆਪਣੇ ਆਪ ਨਹੀਂ ਖੁਲ ਰਿਹਾ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • Jupyter ਇੰਸਟਾਲ ਨਹੀਂ ਹੈ
  • ਬ੍ਰਾਊਜ਼ਰ ਕਨਫਿਗਰੇਸ਼ਨ ਸਮੱਸਿਆਵਾਂ

ਹੱਲ:

  1. Jupyter ਇੰਸਟਾਲ ਕਰੋ (ਉਪਰ ਦਿੱਤੀਆਂ ਇੰਸਟਾਲੇਸ਼ਨ ਸਮੱਸਿਆਵਾਂ ਵੇਖੋ)।
  2. ਨੋਟਬੁੱਕ ਮੈਨੁਅਲੀ ਖੋਲ੍ਹੋ।
    • ਟਰਮੀਨਲ ਤੋਂ URL ਕਾਪੀ ਕਰੋ (ਜਿਵੇਂ, http://localhost:8888/?token=...) ਅਤੇ ਇਸਨੂੰ ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਪੇਸਟ ਕਰੋ।

7. Kernel ਕਰੈਸ਼ ਹੋ ਰਿਹਾ ਜਾਂ ਫ੍ਰੀਜ਼ ਹੋ ਰਿਹਾ

ਪਿਛੋਕੜ: ਨੋਟਬੁੱਕ Kernel ਸਰੋਤ ਸੀਮਾਵਾਂ ਜਾਂ ਕੋਡ Errors ਦੇ ਕਾਰਨ ਕਰੈਸ਼ ਕਰ ਸਕਦੇ ਹਨ।

ਲੱਛਣ:

  • Kernel ਮੁੜ-ਮੁੜ ਮਰ ਜਾਂ ਰੀਸਟਾਰਟ ਹੋ ਰਿਹਾ
  • Out-of-memory Errors

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • ਵੱਡੇ ਡਾਟਾਸੈਟ
  • ਅਣਮਿਲੇ ਕੋਡ ਜਾਂ ਪੈਕੇਜ

ਹੱਲ:

  1. Kernel ਨੂੰ ਰੀਸਟਾਰਟ ਕਰੋ।
    Jupyter ਵਿੱਚ "Restart Kernel" ਬਟਨ ਦੀ ਵਰਤੋਂ ਕਰੋ।
  2. ਮੈਮੋਰੀ ਦੀ ਵਰਤੋਂ ਦੀ ਜਾਂਚ ਕਰੋ।
    ਬੇਕਾਰ ਐਪਲੀਕੇਸ਼ਨ ਬੰਦ ਕਰੋ।
  3. ਨੋਟਬੁੱਕ ਨੂੰ ਕਲਾਉਡ ਪਲੇਟਫਾਰਮ 'ਤੇ ਚਲਾਓ।
    Google Colab ਜਾਂ Azure Notebooks ਦੀ ਵਰਤੋਂ ਕਰੋ।

ਪ੍ਰਦਰਸ਼ਨ ਸਮੱਸਿਆਵਾਂ

8. ਨੋਟਬੁੱਕ ਹੌਲੀ ਚਲ ਰਹੀ ਹੈ

ਪਿਛੋਕੜ: ਕੁਝ AI ਕੰਮਾਂ ਨੂੰ ਮਹੱਤਵਪੂਰਨ ਮੈਮੋਰੀ ਅਤੇ CPU ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।

ਲੱਛਣ:

  • ਹੌਲੀ execution
  • ਲੈਪਟਾਪ ਫੈਨ ਜ਼ੋਰ ਨਾਲ ਚਲ ਰਿਹਾ

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • ਵੱਡੇ ਡਾਟਾਸੈਟ ਜਾਂ ਮਾਡਲ
  • ਸੀਮਿਤ ਸਿਸਟਮ ਸਰੋਤ

ਹੱਲ:

  1. ਕਲਾਉਡ ਪਲੇਟਫਾਰਮ ਦੀ ਵਰਤੋਂ ਕਰੋ।
    • ਨੋਟਬੁੱਕ ਨੂੰ Colab ਜਾਂ Azure Notebooks 'ਤੇ ਅਪਲੋਡ ਕਰੋ।
  2. ਡਾਟਾਸੈਟ ਦਾ ਆਕਾਰ ਘਟਾਓ।
    • ਅਭਿਆਸ ਲਈ ਨਮੂਨਾ ਡਾਟਾ ਦੀ ਵਰਤੋਂ ਕਰੋ।
  3. ਬੇਕਾਰ ਪ੍ਰੋਗਰਾਮ ਬੰਦ ਕਰੋ।
    • ਸਿਸਟਮ RAM ਖਾਲੀ ਕਰੋ।

ਪਾਠਪੁਸਤਕ ਵੈਬਸਾਈਟ ਸਮੱਸਿਆਵਾਂ

9. ਅਧਿਆਇ ਲੋਡ ਨਹੀਂ ਹੋ ਰਿਹਾ

ਪਿਛੋਕੜ: ਆਨਲਾਈਨ ਪਾਠਪੁਸਤਕ ਪਾਠ ਅਤੇ ਅਧਿਆਇ ਦਿਖਾਉਂਦੀ ਹੈ।

ਲੱਛਣ:

  • ਕੋਈ ਅਧਿਆਇ (ਜਿਵੇਂ, Transformers/BERT) ਗੁੰਮ ਹੈ ਜਾਂ ਖੁਲ ਨਹੀਂ ਰਿਹਾ

ਜਾਣੀ ਸਮੱਸਿਆ:

  • Issue #303: “18 Transformers. BERT. can't be opened on the textbook website.” Filename Error (READMEtransformers.md ਦੀ ਬਜਾਏ README.md) ਦੇ ਕਾਰਨ।

ਹੱਲ:

  1. ਫਾਈਲ ਰੀਨੇਮਿੰਗ Errors ਦੀ ਜਾਂਚ ਕਰੋ।
    ਜੇ ਤੁਸੀਂ ਯੋਗਦਾਨ ਦੇਣ ਵਾਲੇ ਹੋ, ਤਾਂ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਧਿਆਇ ਫਾਈਲਾਂ ਦਾ ਨਾਮ README.md ਹੈ।
  2. ਗੁੰਮ ਫਾਈਲਾਂ ਦੀ ਰਿਪੋਰਟ ਕਰੋ।
    GitHub 'ਤੇ ਅਧਿਆਇ ਦਾ ਨਾਮ ਅਤੇ Error ਵੇਰਵੇ ਨਾਲ ਇੱਕ Issue ਖੋਲ੍ਹੋ।

ਯੋਗਦਾਨ ਦੇਣ ਦੀਆਂ ਸਮੱਸਿਆਵਾਂ

10. PR ਸਵੀਕਾਰ ਨਹੀਂ ਹੋ ਰਿਹਾ ਜਾਂ Builds ਫੇਲ ਹੋ ਰਹੇ ਹਨ

ਪਿਛੋਕੜ: ਯੋਗਦਾਨਾਂ ਨੂੰ ਟੈਸਟ ਪਾਸ ਕਰਨੇ ਅਤੇ ਹਦਾਇਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨੀ ਪੈਂਦੀ ਹੈ।

ਲੱਛਣ:

  • Pull request ਰਿਜੈਕਟ ਹੋ ਰਿਹਾ
  • CI/CD pipeline Errors

ਸੰਭਾਵਿਤ ਕਾਰਨ:

  • ਫੇਲ ਹੋ ਰਹੇ ਟੈਸਟ
  • ਕੋਡਿੰਗ ਮਿਆਰਾਂ ਦੀ ਪਾਲਣਾ ਨਹੀਂ ਕੀਤੀ

ਹੱਲ:

  1. ਯੋਗਦਾਨ ਦੇਣ ਦੀਆਂ ਹਦਾਇਤਾਂ ਪੜ੍ਹੋ।
    • ਰਿਪੋਜ਼ਟਰੀ ਦੇ CONTRIBUTING.md ਦੀ ਪਾਲਣਾ ਕਰੋ।
  2. ਪੁਸ਼ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਟੈਸਟ ਨੂੰ ਲੋਕਲ ਰਨ ਕਰੋ।
  3. ਲਿੰਟਿੰਗ ਰੂਲ ਜਾਂ ਫਾਰਮੈਟਿੰਗ ਦੀਆਂ ਲੋੜਾਂ ਦੀ ਜਾਂਚ ਕਰੋ।

FAQ

ਮੈਂ ਖਾਸ ਮੋਡੀਊਲਾਂ ਲਈ ਮਦਦ ਕਿੱਥੇ ਲੱਭ ਸਕਦਾ/ਸਕਦੀ ਹਾਂ?

  • ਹਰ ਮੋਡੀਊਲ ਆਮ ਤੌਰ 'ਤੇ ਆਪਣਾ README ਰੱਖਦਾ ਹੈ। ਸੈਟਅੱਪ ਅਤੇ ਵਰਤੋਂ ਦੀਆਂ ਟਿੱਪਸ ਲਈ ਉੱਥੇ ਸ਼ੁਰੂ ਕਰੋ।

ਮੈਂ ਬੱਗ ਰਿਪੋਰਟ ਕਰਨ ਜਾਂ ਫੀਚਰ ਦੀ ਬੇਨਤੀ ਕਰਨ ਲਈ ਕੀ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ?

ਜੇ ਮੇਰੀ ਸਮੱਸਿਆ ਸੂਚੀਬੱਧ ਨਹੀਂ ਹੈ ਤਾਂ ਕੀ ਮੈਂ ਮਦਦ ਲਈ ਪੁੱਛ ਸਕਦਾ/ਸਕਦੀ ਹਾਂ?

  • ਜੀ! ਪਹਿਲਾਂ ਮੌਜੂਦਾ Issues ਨੂੰ ਖੋਜੋ, ਅਤੇ ਜੇ ਤੁਸੀਂ ਆਪਣੀ ਸਮੱਸਿਆ ਨਹੀਂ ਲੱਭਦੇ, ਤਾਂ ਇੱਕ ਨਵਾਂ Issue ਬਣਾਓ।

ਮਦਦ ਪ੍ਰਾਪਤ ਕਰਨਾ

  • Issues ਦੀ ਜਾਂਚ ਕਰੋ: GitHub Issues
  • ਸਵਾਲ ਪੁੱਛੋ: GitHub Discussions ਦੀ ਵਰਤੋਂ ਕਰੋ ਜਾਂ ਇੱਕ Issue ਖੋਲ੍ਹੋ।
  • ਕਮਿਊਨਿਟੀ: ਚੈਟ/ਫੋਰਮ ਵਿਕਲਪਾਂ ਲਈ ਰਿਪੋਜ਼ਟਰੀ ਲਿੰਕ ਵੇਖੋ।

ਆਖਰੀ ਅਪਡੇਟ: 2025-09-20

ਅਸਵੀਕਰਤਾ:
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ Co-op Translator ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਹਾਲਾਂਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਯਤਨਸ਼ੀਲ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਦਿਓ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੁੱਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਮੌਜੂਦ ਅਸਲ ਦਸਤਾਵੇਜ਼ ਨੂੰ ਅਧਿਕਾਰਤ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਪੈਦਾ ਹੋਣ ਵਾਲੇ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆ ਲਈ ਅਸੀਂ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।