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

ఈ మార్గదర్శకం [AI-For-Beginners](https://github.com/microsoft/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 గైడ్](https://docs.github.com/en/authentication/connecting-to-github-with-ssh) ను అనుసరించండి.

---

## ఇన్‌స్టాలేషన్ సమస్యలు

### 2. Python వాతావరణ సమస్యలు

**నేపథ్యం:** రిపాజిటరీ Python మరియు వివిధ లైబ్రరీలపై ఆధారపడి ఉంటుంది.

**లక్షణాలు:**
- Error: `ModuleNotFoundError: No module named '<package>'`
- స్క్రిప్టులు లేదా నోట్‌బుక్స్ నడిపేటప్పుడు ఇంపోర్ట్ లోపాలు

**సాధ్యమైన కారణాలు:**
- డిపెండెన్సీలు ఇన్‌స్టాల్ చేయబడకపోవడం
- తప్పు Python వెర్షన్

**పరిష్కారాలు:**
1. **వర్చువల్ ఎన్విరాన్‌మెంట్ సెట్ చేయండి.**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # విండోస్‌లో: venv\Scripts\activate
   ```
2. **డిపెండెన్సీలు ఇన్‌స్టాల్ చేయండి.**  
   ```bash
   pip install -r requirements.txt
   ```
3. **Python వెర్షన్ తనిఖీ చేయండి.**  
   Python 3.7 లేదా కొత్త వెర్షన్ ఉపయోగించండి.  
   ```bash
   python --version
   ```

### 3. Jupyter ఇన్‌స్టాల్ కాలేదు

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

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

**సాధ్యమైన కారణాలు:**
- Jupyter ఇన్‌స్టాల్ కాలేదు

**పరిష్కారాలు:**
1. **Jupyter Notebook ఇన్‌స్టాల్ చేయండి.**  
   ```bash
   pip install notebook
   ```
   లేదా, Anaconda ఉపయోగిస్తుంటే:  
   ```bash
   conda install notebook
   ```
2. **Jupyter Notebook ప్రారంభించండి.**  
   ```bash
   jupyter notebook
   ```

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

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

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

**సాధ్యమైన కారణాలు:**
- పాత లేదా ఘర్షణ కలిగించే Python ప్యాకేజీలు

**పరిష్కారాలు:**
1. **శుభ్రమైన వాతావరణంలో ఇన్‌స్టాల్ చేయండి.**  
   పాత వర్చువల్ ఎన్విరాన్‌మెంట్ లేదా కండా ఎన్విరాన్‌మెంట్ తొలగించి కొత్తది సృష్టించండి.
2. **ఖచ్చితమైన వెర్షన్లు ఉపయోగించండి.**  
   ఎప్పుడూ ఈ కింద ఇచ్చిన ఆదేశం నడపండి:  
   ```bash
   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](https://colab.research.google.com/) లేదా [Azure Notebooks](https://notebooks.azure.com/) ఉపయోగించండి.

---

## పనితీరు సమస్యలు

### 8. నోట్‌బుక్స్ నెమ్మదిగా నడుస్తున్నాయి

**నేపథ్యం:** కొన్ని AI పనులు ఎక్కువ మెమరీ మరియు CPU అవసరం.

**లక్షణాలు:**
- నెమ్మదిగా అమలు
- ల్యాప్‌టాప్ ఫ్యాన్ ఎక్కువగా పనిచేస్తోంది

**సాధ్యమైన కారణాలు:**
- పెద్ద డేటాసెట్‌లు లేదా మోడల్స్
- పరిమిత సిస్టమ్ వనరులు

**పరిష్కారాలు:**
1. **క్లౌడ్ ప్లాట్‌ఫారమ్ ఉపయోగించండి.**  
   - నోట్‌బుక్‌ను Colab లేదా Azure Notebooks కు అప్‌లోడ్ చేయండి.
2. **డేటాసెట్ పరిమాణం తగ్గించండి.**  
   - అభ్యాసానికి నమూనా డేటాను ఉపయోగించండి.
3. **అవసరంలేని ప్రోగ్రామ్స్ మూసివేయండి.**  
   - సిస్టమ్ RAM ను ఖాళీ చేయండి.

---

## పాఠ్యపుస్తక వెబ్‌సైట్ సమస్యలు

### 9. అధ్యాయం లోడ్ కావడం లేదు

**నేపథ్యం:** ఆన్‌లైన్ పాఠ్యపుస్తకం పాఠాలు మరియు అధ్యాయాలను చూపిస్తుంది.

**లక్షణాలు:**
- ఒక అధ్యాయం (ఉదా: Transformers/BERT) కనిపించడం లేదా తెరవడం లేదు

**తెలిసిన సమస్య:**  
- [Issue #303](https://github.com/microsoft/AI-For-Beginners/issues/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](https://github.com/microsoft/AI-For-Beginners/blob/main/CONTRIBUTING.md) అనుసరించండి.
2. **పుష్ చేయక ముందు స్థానికంగా పరీక్షలు నడపండి.**
3. **లింటింగ్ నియమాలు లేదా ఫార్మాటింగ్ అవసరాలు తనిఖీ చేయండి.**

---

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

### నేను ప్రత్యేక మాడ్యూల్స్ కోసం సహాయం ఎక్కడ పొందగలను?
- ప్రతి మాడ్యూల్ సాధారణంగా తన README కలిగి ఉంటుంది. అక్కడి నుండి సెటప్ మరియు ఉపయోగ సూచనలు ప్రారంభించండి.

### బగ్ నివేదించాలంటే లేదా ఫీచర్ అభ్యర్థించాలంటే ఎలా?
- [GitHub Issue ఓపెన్ చేయండి](https://github.com/microsoft/AI-For-Beginners/issues/new) స్పష్టమైన వివరణ మరియు పునరుత్పత్తి దశలతో.

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

---

## సహాయం పొందడం

- **ఇష్యూలను తనిఖీ చేయండి:** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **ప్రశ్నలు అడగండి:** GitHub Discussions ఉపయోగించండి లేదా ఇష్యూ ఓపెన్ చేయండి.
- **కమ్యూనిటీ:** చాట్/ఫోరమ్ ఎంపికల కోసం రిపాజిటరీ లింకులను చూడండి.

---

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

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**అస్పష్టత**:  
ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలో అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారితీసే అర్థాలు కోసం మేము బాధ్యత వహించము.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->