AI-For-Beginners/translations/kn/troubleshoot.md

17 KiB

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   # ವಿಂಡೋಸ್‌ನಲ್ಲಿ: 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. ಪರಿಸರ ಚರಗಳು (Environment Variables) ಸೆಟ್ ಆಗಿಲ್ಲ

ಹಿನ್ನೆಲೆ: ಕೆಲವು ಮೋಡ್ಯೂಲ್‌ಗಳಿಗೆ ಕೀಗಳು, ಟೋಕನ್‌ಗಳು ಅಥವಾ ಕಾನ್ಫಿಗ್ ಸೆಟ್ಟಿಂಗ್‌ಗಳು ಬೇಕಾಗಬಹುದು.

ಲಕ್ಷಣಗಳು:

  • ದೋಷ: KeyError ಅಥವಾ ಕಾನ್ಫಿಗರೇಶನ್ ಇಲ್ಲದಿರುವ ಬಗ್ಗೆ ಎಚ್ಚರಿಕೆಗಳು

ಸಾಧ್ಯ ಕಾರಣಗಳು:

  • ಅಗತ್ಯವಿರುವ ಪರಿಸರ ಚರಗಳು ಸೆಟ್ ಆಗಿಲ್ಲ

ಪರಿಹಾರಗಳು:

  1. .env.example ಅಥವಾ ಹೋಲುವ ಫೈಲ್‌ಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ.
  2. .env ಫೈಲ್ ರಚಿಸಿ ಮತ್ತು ಅಗತ್ಯ ಮೌಲ್ಯಗಳನ್ನು ತುಂಬಿ.
  3. ಪರಿಸರ ಚರಗಳನ್ನು ಸೆಟ್ ಮಾಡಿದ ನಂತರ ಟರ್ಮಿನಲ್ ಅಥವಾ IDE ಅನ್ನು ಮರುಲೋಡ್ ಮಾಡಿ.

ನೋಟ್‌ಬುಕ್‌ಗಳನ್ನು ಚಾಲನೆ ಮಾಡುವುದು

6. ನೋಟ್‌ಬುಕ್ ತೆರೆಯಲಾಗುತ್ತಿಲ್ಲ ಅಥವಾ ಚಾಲನೆ ಆಗುತ್ತಿಲ್ಲ

ಹಿನ್ನೆಲೆ: Jupyter ನೋಟ್‌ಬುಕ್‌ಗಳಿಗೆ ಸರಿಯಾದ ಸಿದ್ಧತೆ ಅಗತ್ಯ.

ಲಕ್ಷಣಗಳು:

  • ನೋಟ್‌ಬುಕ್ ಪ್ರಾರಂಭವಾಗುತ್ತಿಲ್ಲ
  • ಬ್ರೌಸರ್ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ತೆರೆಯುತ್ತಿಲ್ಲ

ಸಾಧ್ಯ ಕಾರಣಗಳು:

  • Jupyter ಸ್ಥಾಪಿಸಲಾಗಿಲ್ಲ
  • ಬ್ರೌಸರ್ ಕಾನ್ಫಿಗರೇಶನ್ ಸಮಸ್ಯೆಗಳು

ಪರಿಹಾರಗಳು:

  1. Jupyter ಸ್ಥಾಪಿಸಿ (ಮೇಲಿನ ಸ್ಥಾಪನೆ ಸಮಸ್ಯೆಗಳನ್ನು ನೋಡಿ).
  2. ನೋಟ್‌ಬುಕ್‌ಗಳನ್ನು ಕೈಯಿಂದ ತೆರೆಯಿರಿ.
    • ಟರ್ಮಿನಲ್‌ನಿಂದ URL ನಕಲಿಸಿ (ಉದಾ: http://localhost:8888/?token=...) ಮತ್ತು ನಿಮ್ಮ ಬ್ರೌಸರ್‌ನಲ್ಲಿ ಪೇಸ್ಟ್ ಮಾಡಿ.

7. ಕರ್ಣಲ್ ಕ್ರ್ಯಾಶ್ ಆಗುವುದು ಅಥವಾ ಫ್ರೀಜ್ ಆಗುವುದು

ಹಿನ್ನೆಲೆ: ನೋಟ್‌ಬುಕ್ ಕರ್ಣಲ್‌ಗಳು ಸಂಪನ್ಮೂಲ ಮಿತಿಗಳು ಅಥವಾ ಕೋಡ್ ದೋಷಗಳಿಂದ ಕ್ರ್ಯಾಶ್ ಆಗಬಹುದು.

ಲಕ್ಷಣಗಳು:

  • ಕರ್ಣಲ್ ಮರುಪ್ರಾರಂಭವಾಗುತ್ತದೆ ಅಥವಾ ಸತತವಾಗಿ ಸಾಯುತ್ತದೆ
  • Out-of-memory ದೋಷಗಳು

ಸಾಧ್ಯ ಕಾರಣಗಳು:

  • ದೊಡ್ಡ ಡೇಟಾಸೆಟ್‌ಗಳು
  • ಅಸಂಗತ ಕೋಡ್ ಅಥವಾ ಪ್ಯಾಕೇಜ್‌ಗಳು

ಪರಿಹಾರಗಳು:

  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 Issue ತೆರೆಯಿರಿ.

ಕೊಡುಗೆ ನೀಡುವ ಸಮಸ್ಯೆಗಳು

10. PR ಸ್ವೀಕರಿಸಲಾಗುತ್ತಿಲ್ಲ ಅಥವಾ ಬಿಲ್ಡ್ ವಿಫಲವಾಗುತ್ತಿದೆ

ಹಿನ್ನೆಲೆ: ಕೊಡುಗೆಗಳು ಪರೀಕ್ಷೆಗಳನ್ನು ಪಾಸಾಗಬೇಕು ಮತ್ತು ಮಾರ್ಗಸೂಚಿಗಳನ್ನು ಅನುಸರಿಸಬೇಕು.

ಲಕ್ಷಣಗಳು:

  • ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ನಿರಾಕರಿಸಲಾಗಿದೆ
  • CI/CD ಪೈಪ್‌ಲೈನ್ ದೋಷಗಳು

ಸಾಧ್ಯ ಕಾರಣಗಳು:

  • ಪರೀಕ್ಷೆಗಳು ವಿಫಲವಾಗಿವೆ
  • ಕೋಡಿಂಗ್ ಮಾನದಂಡಗಳನ್ನು ಅನುಸರಿಸಲಾಗಿಲ್ಲ

ಪರಿಹಾರಗಳು:

  1. ಕೊಡುಗೆ ಮಾರ್ಗಸೂಚಿಗಳನ್ನು ಓದಿ.
    ರೆಪೊಸಿಟರಿಯ CONTRIBUTING.md ಅನುಸರಿಸಿ.
  2. ಪುಶ್ ಮಾಡುವ ಮೊದಲು ಸ್ಥಳೀಯವಾಗಿ ಪರೀಕ್ಷೆಗಳನ್ನು ನಡೆಸಿ.
  3. ಲಿಂಟಿಂಗ್ ನಿಯಮಗಳು ಅಥವಾ ಫಾರ್ಮ್ಯಾಟಿಂಗ್ ಅಗತ್ಯಗಳನ್ನು ಪರಿಶೀಲಿಸಿ.

ಸಾಮಾನ್ಯ ಪ್ರಶ್ನೆಗಳು

ನಿರ್ದಿಷ್ಟ ಮೋಡ್ಯೂಲ್‌ಗಳಿಗೆ ಸಹಾಯವನ್ನು ಎಲ್ಲಿಂದ ಪಡೆಯಬಹುದು?

  • ಪ್ರತಿ ಮೋಡ್ಯೂಲ್‌ಗೆ ಸಾಮಾನ್ಯವಾಗಿ ತನ್ನದೇ ಆದ README ಇರುತ್ತದೆ. ಅಲ್ಲಿ ಸೆಟ್‌ಅಪ್ ಮತ್ತು ಬಳಕೆ ಸಲಹೆಗಳು ಇರುತ್ತವೆ.

ದೋಷವನ್ನು ಹೇಗೆ ವರದಿ ಮಾಡಬಹುದು ಅಥವಾ ವೈಶಿಷ್ಟ್ಯವನ್ನು ಹೇಗೆ ವಿನಂತಿಸಬಹುದು?

ನನ್ನ ಸಮಸ್ಯೆ ಪಟ್ಟಿಯಲ್ಲಿ ಇಲ್ಲದಿದ್ದರೆ ಸಹಾಯ ಕೇಳಬಹುದೇ?

  • ಹೌದು! ಮೊದಲು ಇತ್ತೀಚಿನ Issues ಹುಡುಕಿ, ನಿಮ್ಮ ಸಮಸ್ಯೆ ಇಲ್ಲದಿದ್ದರೆ ಹೊಸ Issue ರಚಿಸಿ.

ಸಹಾಯ ಪಡೆಯುವುದು

  • Issues ಪರಿಶೀಲಿಸಿ: GitHub Issues
  • ಪ್ರಶ್ನೆ ಕೇಳಿ: GitHub Discussions ಬಳಸಿ ಅಥವಾ Issue ತೆರೆಯಿರಿ.
  • ಸಮುದಾಯ: ಚಾಟ್/ಫೋರಂ ಆಯ್ಕೆಗಳು ರೆಪೊಸಿಟರಿ ಲಿಂಕ್‌ಗಳಲ್ಲಿ ಲಭ್ಯ.

ಕೊನೆಯದಾಗಿ ನವೀಕರಿಸಲಾಗಿದೆ: 2025-09-20


ಅಸ್ವೀಕರಣ:
ಈ ದಸ್ತಾವೇಜು AI ಅನುವಾದ ಸೇವೆ Co-op Translator ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯಿಗಾಗಿ ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳು ಇರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಭಾಷೆಯಲ್ಲಿರುವ ಮೂಲ ದಸ್ತಾವೇಜನ್ನು ಅಧಿಕೃತ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವಿಕೆ ಅಥವಾ ತಪ್ಪು ವಿವರಣೆಗಳಿಗೆ ನಾವು ಹೊಣೆಗಾರರಾಗುವುದಿಲ್ಲ.