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

12 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. Пребаците се на HTTPS ако SSH не успе.
    Ако видите Permission denied (publickey), користите горњи HTTPS линк уместо SSH.
  3. Конфигуришите SSH кључеве (опционо).
    Ако желите да користите SSH, пратите GitHub-ов водич за SSH.

Проблеми са инсталацијом

2. Проблеми са Python окружењем

Позадина: Репозиторијум се ослања на Python и различите библиотеке.

Симптоми:

  • Грешка: ModuleNotFoundError: No module named '<package>'
  • Грешке приликом увоза када покрећете скрипте или нотебоок-е

Могући узроци:

  • Зависности нису инсталиране
  • Погрешна верзија Python-а

Решења:

  1. Подесите виртуелно окружење. 
    python -m venv venv
source venv/bin/activate   # On 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. Рестартујте језгро.
    Користите дугме "Restart Kernel" у Jupyter-у.
  2. Проверите употребу меморије.
    Затворите непотребне апликације.
  3. Покрените нотебоок-е на облачним платформама.
    Користите Google Colab или Azure Notebooks.

Проблеми са перформансама

8. Нотебоок-и раде споро

Позадина: Неке AI задатке захтевају значајну меморију и CPU.

Симптоми:

  • Споро извршавање
  • Вентилатор лаптопа ради гласно

Могући узроци:

  • Велики скупови података или модели
  • Ограничени системски ресурси

Решења:

  1. Користите облачну платформу.
    • Отпремите нотебоок на Colab или Azure Notebooks.
  2. Смањите величину скупа података.
    • Користите узорке података за вежбу.
  3. Затворите непотребне програме.
    • Ослободите системску RAM меморију.

Проблеми са веб-сајтом уџбеника

9. Поглавље се не учитава

Позадина: Онлајн уџбеник приказује лекције и поглавља.

Симптоми:

  • Поглавље (нпр. Transformers/BERT) недостаје или се не отвара

Познат проблем:

  • Проблем #303: „18 Transformers. BERT. не може се отворити на веб-сајту уџбеника.“ Узроковано грешком у имену датотеке (READMEtransformers.md уместо README.md).

Решења:

  1. Проверите грешке у именовању датотека.
    Ако сте доприносилац, уверите се да су датотеке поглавља именоване README.md.
  2. Пријавите недостајуће датотеке.
    Отворите GitHub проблем са именом поглавља и детаљима о грешци.

Проблеми са доприносом

10. PR није прихваћен или изградње не успевају

Позадина: Доприноси морају проћи тестове и пратити смернице.

Симптоми:

  • Pull request одбијен
  • Грешке у CI/CD процесу

Могући узроци:

  • Тестови не успевају
  • Непоштовање кодних стандарда

Решења:

  1. Прочитајте смернице за допринос.
  2. Покрените тестове локално пре него што их пошаљете.
  3. Проверите правила за формат и линтинг.

Често постављана питања

Где могу да пронађем помоћ за одређене модуле?

  • Сваки модул обично има свој README. Почните тамо за савете о подешавању и коришћењу.

Како да пријавим грешку или затражим нову функцију?

Могу ли да затражим помоћ ако мој проблем није наведен?

  • Да! Прво претражите постојеће проблеме, а ако не пронађете свој проблем, отворите нови.

Добијање помоћи

  • Проверите проблеме: GitHub Issues
  • Поставите питања: Користите GitHub Discussions или отворите проблем.
  • Заједница: Погледајте линкове репозиторијума за опције чета/форума.

Последње ажурирање: 2025-09-20

Одрицање од одговорности:
Овај документ је преведен помоћу услуге за превођење уз помоћ вештачке интелигенције Co-op Translator. Иако настојимо да обезбедимо тачност, молимо вас да имате у виду да аутоматизовани преводи могу садржати грешке или нетачности. Оригинални документ на изворном језику треба сматрати меродавним извором. За критичне информације препоручује се професионални превод од стране људи. Не преузимамо одговорност за било каква погрешна тумачења или неспоразуме који могу настати услед коришћења овог превода.