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

8.3 KiB
Raw Blame History

Ghid de depanare AI-For-Beginners

Acest ghid te ajută să rezolvi problemele comune întâlnite în utilizarea sau contribuția la repository-ul AI-For-Beginners. Fiecare problemă include context, simptome, explicații și soluții pas cu pas.

Cuprins

Probleme Generale

1. Repository-ul nu se clonează corect

Context: Clonarea îți permite să copiezi repository-ul pe dispozitivul tău.

Simptome:

  • Eroare: fatal: repository not found
  • Eroare: Permission denied (publickey)

Cauze posibile:

  • URL-ul repository-ului este incorect
  • Permisiuni insuficiente
  • Cheile SSH nu sunt configurate

Soluții:

  1. Verifică URL-ul repository-ului.
    Folosește URL-ul HTTPS: 
    git clone https://github.com/microsoft/AI-For-Beginners.git
  2. Comută la HTTPS dacă SSH eșuează.
    Dacă vezi Permission denied (publickey), folosește linkul HTTPS de mai sus în loc de SSH.
  3. Configurează cheile SSH (opțional).
    Dacă vrei să folosești SSH, urmează ghidul SSH de la GitHub.

Probleme de Instalare

2. Probleme cu mediul Python

Context: Repository-ul se bazează pe Python și diverse biblioteci.

Simptome:

  • Eroare: ModuleNotFoundError: No module named '<package>'
  • Erori de import la rularea scripturilor sau notebooks

Cauze posibile:

  • Dependențele nu sunt instalate
  • Versiunea Python este greșită

Soluții:

  1. Configurează un mediu virtual. 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. Instalează dependențele. 
    pip install -r requirements.txt
  3. Verifică versiunea Python.
    Folosește Python 3.7 sau mai nou. 
    python --version

3. Jupyter nu este instalat

Context: Notebooks sunt o resursă esențială pentru învățare.

Simptome:

  • Eroare: jupyter: command not found
  • Notebooks nu se lansează

Cauze posibile:

  • Jupyter nu este instalat

Soluții:

  1. Instalează Jupyter Notebook. 
    pip install notebook
    sau, dacă folosești Anaconda: 
    conda install notebook
  2. Pornește Jupyter Notebook. 
    jupyter notebook

4. Conflicte de versiuni ale dependențelor

Context: Proiectele pot eșua dacă versiunile pachetelor nu sunt compatibile.

Simptome:

  • Erori sau avertismente despre versiuni incompatibile

Cauze posibile:

  • Pachete Python vechi sau conflictuale

Soluții:

  1. Instalează într-un mediu curat.
    Șterge vechiul venv/env conda și creează unul nou.
  2. Folosește versiuni exacte.
    Rulează mereu: 
    pip install -r requirements.txt
    Dacă acest lucru eșuează, instalează manual pachetele lipsă conform README.

Probleme de Configurare

5. Variabilele de mediu nu sunt setate

Context: Unele module pot necesita chei, token-uri sau setări de configurare.

Simptome:

  • Eroare: KeyError sau avertismente despre configurări lipsă

Cauze posibile:

  • Variabilele de mediu necesare nu sunt setate

Soluții:

  1. Verifică fișierele .env.example sau similare.
  2. Creează un fișier .env și completează valorile necesare.
  3. Reîncarcă terminalul sau IDE-ul după setarea variabilelor de mediu.

Rularea Notebooks

6. Notebook-ul nu se deschide sau nu rulează

Context: Notebooks Jupyter necesită o configurare corectă.

Simptome:

  • Notebook-ul nu se lansează
  • Browserul nu se deschide automat

Cauze posibile:

  • Jupyter nu este instalat
  • Probleme de configurare a browserului

Soluții:

  1. Instalează Jupyter (vezi Probleme de Instalare de mai sus).
  2. Deschide notebooks manual.
    • Copiază URL-ul din terminal (ex.: http://localhost:8888/?token=...) și lipește-l în browser.

7. Kernel-ul se blochează sau se oprește

Context: Kernel-urile notebook-urilor pot eșua din cauza limitelor de resurse sau erorilor de cod.

Simptome:

  • Kernel-ul moare sau se repornește repetat
  • Erori de memorie insuficientă

Cauze posibile:

  • Seturi de date mari
  • Cod sau pachete incompatibile

Soluții:

  1. Repornește kernel-ul.
    Folosește butonul "Restart Kernel" din Jupyter.
  2. Verifică utilizarea memoriei.
    Închide aplicațiile neutilizate.
  3. Rulează notebooks pe platforme cloud.
    Folosește Google Colab sau Azure Notebooks.

Probleme de Performanță

8. Notebooks rulează lent

Context: Unele sarcini AI necesită memorie și CPU semnificative.

Simptome:

  • Execuție lentă
  • Ventilatorul laptopului funcționează intens

Cauze posibile:

  • Seturi de date sau modele mari
  • Resurse limitate ale sistemului

Soluții:

  1. Folosește o platformă cloud.
    • Încarcă notebook-ul pe Colab sau Azure Notebooks.
  2. Redu dimensiunea setului de date.
    • Folosește date de probă pentru practică.
  3. Închide programele inutile.
    • Eliberează RAM-ul sistemului.

Probleme cu Website-ul Manualului

9. Capitolul nu se încarcă

Context: Manualul online afișează lecții și capitole.

Simptome:

  • Un capitol (ex.: Transformers/BERT) lipsește sau nu se deschide

Problemă cunoscută:

  • Issue #303: „18 Transformers. BERT. nu poate fi deschis pe website-ul manualului.” Cauzată de o eroare de denumire a fișierului (READMEtransformers.md în loc de README.md).

Soluții:

  1. Verifică erorile de redenumire a fișierelor.
    Dacă ești contributor, asigură-te că fișierele capitolului sunt denumite README.md.
  2. Raportează fișierele lipsă.
    Deschide un issue pe GitHub cu numele capitolului și detaliile erorii.

Probleme de Contribuție

10. PR nu este acceptat sau build-urile eșuează

Context: Contribuțiile trebuie să treacă teste și să respecte ghidurile.

Simptome:

  • Pull request respins
  • Erori în pipeline-ul CI/CD

Cauze posibile:

  • Teste eșuate
  • Nerespectarea standardelor de codare

Soluții:

  1. Citește ghidul de contribuție.
  2. Rulează testele local înainte de a face push.
  3. Verifică regulile de linting sau cerințele de formatare.

FAQ

Unde pot găsi ajutor pentru module specifice?

  • Fiecare modul are de obicei propriul README. Începe acolo pentru sfaturi de configurare și utilizare.

Cum raportez un bug sau cer o funcționalitate?

Pot cere ajutor dacă problema mea nu este listată?

  • Da! Caută mai întâi în issues existente, iar dacă nu găsești problema ta, creează un issue nou.

Obținerea Ajutorului

  • Verifică Issues: GitHub Issues
  • Pune întrebări: Folosește GitHub Discussions sau deschide un issue.
  • Comunitate: Vezi linkurile repository-ului pentru opțiuni de chat/forum.

Ultima actualizare: 20-09-2025

Declinare de responsabilitate:
Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim să asigurăm acuratețea, vă rugăm să fiți conștienți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa natală ar trebui considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm responsabilitatea pentru eventualele neînțelegeri sau interpretări greșite care pot apărea din utilizarea acestei traduceri.