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

AI-For-Beginners సమస్య పరిష్కార మార్గదర్శకం

ఈ మార్గదర్శకం 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>'
• స్క్రిప్టులు లేదా నోట్‌బుక్స్ నడిపేటప్పుడు ఇంపోర్ట్ లోపాలు

సాధ్యమైన కారణాలు:

• డిపెండెన్సీలు ఇన్‌స్టాల్ చేయబడకపోవడం
• తప్పు 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 ఇన్‌స్టాల్ కాలేదు

నేపథ్యం: నోట్‌బుక్స్ ముఖ్యమైన అభ్యాస వనరు.

లక్షణాలు:

• Error: jupyter: command not found
• నోట్‌బుక్స్ ప్రారంభం కావడం లేదు

సాధ్యమైన కారణాలు:

• Jupyter ఇన్‌స్టాల్ కాలేదు

పరిష్కారాలు:

1. Jupyter Notebook ఇన్‌స్టాల్ చేయండి.

   pip install notebook
   

   లేదా, Anaconda ఉపయోగిస్తుంటే:

   conda install notebook
   

2. Jupyter Notebook ప్రారంభించండి.

   jupyter notebook
   

4. డిపెండెన్సీ వెర్షన్ ఘర్షణలు

నేపథ్యం: ప్యాకేజీ వెర్షన్లు సరిపోకపోతే ప్రాజెక్టులు విఫలమవుతాయి.

లక్షణాలు:

• అనుకూలం కాని వెర్షన్ల గురించి లోపాలు లేదా హెచ్చరికలు

సాధ్యమైన కారణాలు:

• పాత లేదా ఘర్షణ కలిగించే Python ప్యాకేజీలు

పరిష్కారాలు:

1. శుభ్రమైన వాతావరణంలో ఇన్‌స్టాల్ చేయండి.
   పాత వర్చువల్ ఎన్విరాన్‌మెంట్ లేదా కండా ఎన్విరాన్‌మెంట్ తొలగించి కొత్తది సృష్టించండి.
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. కర్నెల్ క్రాష్ అవడం లేదా ఫ్రీజ్ అవడం

నేపథ్యం: రిసోర్స్ పరిమితులు లేదా కోడ్ లోపాల వల్ల కర్నెల్ క్రాష్ అవుతుంది.

లక్షణాలు:

• కర్నెల్ మరణించడం లేదా పునఃప్రారంభం అవడం
• 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 ఇష్యూ ఓపెన్ చేయండి.

---

సహకారం సమస్యలు

10. PR అంగీకరించబడడం లేదు లేదా బిల్డ్స్ విఫలమవుతున్నాయి

నేపథ్యం: సహకారాలు పరీక్షలు పాస్ అవ్వాలి మరియు మార్గదర్శకాలు పాటించాలి.

లక్షణాలు:

• పుల్ రిక్వెస్ట్ తిరస్కరించబడింది
• CI/CD పైప్‌లైన్ లోపాలు

సాధ్యమైన కారణాలు:

• పరీక్షలు విఫలమవడం
• కోడింగ్ ప్రమాణాలు పాటించకపోవడం

పరిష్కారాలు:

1. సహకార మార్గదర్శకాలు చదవండి.
   రిపాజిటరీ యొక్క CONTRIBUTING.md అనుసరించండి.
2. పుష్ చేయక ముందు స్థానికంగా పరీక్షలు నడపండి.
3. లింటింగ్ నియమాలు లేదా ఫార్మాటింగ్ అవసరాలు తనిఖీ చేయండి.

---

సాధారణ ప్రశ్నలు

నేను ప్రత్యేక మాడ్యూల్స్ కోసం సహాయం ఎక్కడ పొందగలను?

• ప్రతి మాడ్యూల్ సాధారణంగా తన README కలిగి ఉంటుంది. అక్కడి నుండి సెటప్ మరియు ఉపయోగ సూచనలు ప్రారంభించండి.

బగ్ నివేదించాలంటే లేదా ఫీచర్ అభ్యర్థించాలంటే ఎలా?

• GitHub Issue ఓపెన్ చేయండి స్పష్టమైన వివరణ మరియు పునరుత్పత్తి దశలతో.

నా సమస్య జాబితాలో లేకపోతే సహాయం అడగవచ్చా?

• అవును! ముందుగా ఉన్న ఇష్యూలను శోధించండి, మీ సమస్య దొరకకపోతే కొత్త ఇష్యూ సృష్టించండి.

---

సహాయం పొందడం

• ఇష్యూలను తనిఖీ చేయండి: GitHub Issues
• ప్రశ్నలు అడగండి: GitHub Discussions ఉపయోగించండి లేదా ఇష్యూ ఓపెన్ చేయండి.
• కమ్యూనిటీ: చాట్/ఫోరమ్ ఎంపికల కోసం రిపాజిటరీ లింకులను చూడండి.

---

చివరిసారిగా నవీకరించబడింది: 2025-09-20

---

అస్పష్టత:
ఈ పత్రాన్ని AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలో అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారితీసే అర్థాలు కోసం మేము బాధ్యత వహించము.