280 lines
17 KiB
Markdown
280 lines
17 KiB
Markdown
# 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 --> |