# AI-For-Beginners Troubleshooting Guide

இந்த வழிகாட்டி [AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners) repository-யைப் பயன்படுத்தும் அல்லது அதில் பங்களிப்புச் செய்யும் போது ஏற்படும் பொதுவான பிரச்சினைகளைத் தீர்க்க உதவுகிறது. ஒவ்வொரு பிரச்சினையும் பின்னணி, அறிகுறிகள், விளக்கங்கள் மற்றும் படிப்படியாக தீர்வுகளை உள்ளடக்கியது.

---

## உள்ளடக்க அட்டவணை

- [பொதுவான பிரச்சினைகள்](../..)
- [நிறுவல் பிரச்சினைகள்](../..)
- [கட்டமைப்பு பிரச்சினைகள்](../..)
- [நோட்புக் இயக்குதல்](../..)
- [செயல்திறன் பிரச்சினைகள்](../..)
- [பாடநூல் இணையதள பிரச்சினைகள்](../..)
- [பங்களிப்பு பிரச்சினைகள்](../..)
- [அடிக்கடி கேட்கப்படும் கேள்விகள்](../..)
- [உதவி பெறுதல்](../..)

---

## பொதுவான பிரச்சினைகள்

### 1. Repository சரியாக Clone ஆகவில்லை

**பின்னணி:** Clone செய்வது repository-யை உங்கள் கணினியில் நகலெடுக்க உதவுகிறது.

**அறிகுறிகள்:**
- பிழை: `fatal: repository not found`
- பிழை: `Permission denied (publickey)`

**சாத்தியமான காரணங்கள்:**
- தவறான repository URL
- போதுமான அனுமதிகள் இல்லை
- SSH கீக்கள் அமைக்கப்படவில்லை

**தீர்வுகள்:**
1. **Repository 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's SSH guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh)-ஐப் பின்பற்றவும்.

---

## நிறுவல் பிரச்சினைகள்

### 2. Python சூழல் பிரச்சினைகள்

**பின்னணி:** இந்த repository Python மற்றும் பல நூலகங்களை சார்ந்துள்ளது.

**அறிகுறிகள்:**
- பிழை: `ModuleNotFoundError: No module named '<package>'`
- ஸ்கிரிப்ட்கள் அல்லது நோட்புக் இயக்கும்போது Import பிழைகள்

**சாத்தியமான காரணங்கள்:**
- Dependencies நிறுவப்படவில்லை
- தவறான Python பதிப்பு

**தீர்வுகள்:**
1. **ஒரு virtual environment அமைக்கவும்.**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   ```
2. **Dependencies-ஐ நிறுவவும்.**  
   ```bash
   pip install -r requirements.txt
   ```
3. **Python பதிப்பைச் சரிபார்க்கவும்.**  
   Python 3.7 அல்லது அதற்கு மேல் பயன்படுத்தவும்.  
   ```bash
   python --version
   ```

### 3. Jupyter நிறுவப்படவில்லை

**பின்னணி:** நோட்புக் கற்றல் வளங்களில் முக்கியமானது.

**அறிகுறிகள்:**
- பிழை: `jupyter: command not found`
- நோட்புக் தொடங்க முடியவில்லை

**சாத்தியமான காரணங்கள்:**
- Jupyter நிறுவப்படவில்லை

**தீர்வுகள்:**
1. **Jupyter Notebook-ஐ நிறுவவும்.**  
   ```bash
   pip install notebook
   ```
   அல்லது, Anaconda பயன்படுத்தினால்:
   ```bash
   conda install notebook
   ```
2. **Jupyter Notebook-ஐ தொடங்கவும்.**  
   ```bash
   jupyter notebook
   ```

### 4. Dependency பதிப்பு முரண்பாடுகள்

**பின்னணி:** Package பதிப்புகள் பொருந்தாதால் திட்டங்கள் செயலிழக்கலாம்.

**அறிகுறிகள்:**
- பொருந்தாத பதிப்புகள் பற்றிய பிழைகள் அல்லது எச்சரிக்கைகள்

**சாத்தியமான காரணங்கள்:**
- பழைய அல்லது முரண்படும் Python packages

**தீர்வுகள்:**
1. **சுத்தமான சூழலில் நிறுவவும்.**  
   பழைய venv/conda env-ஐ நீக்கி புதிய ஒன்றை உருவாக்கவும்.
2. **சரியான பதிப்புகளைப் பயன்படுத்தவும்.**  
   எப்போதும் இயக்கவும்:  
   ```bash
   pip install -r requirements.txt
   ```
   இது தோல்வியடைந்தால், README-ல் விவரிக்கப்பட்ட missing packages-ஐ கையேடு முறையில் நிறுவவும்.

---

## கட்டமைப்பு பிரச்சினைகள்

### 5. சூழல் மாறிகள் அமைக்கப்படவில்லை

**பின்னணி:** சில modules கீக்கள், tokens அல்லது config அமைப்புகளை தேவைப்படுத்தலாம்.

**அறிகுறிகள்:**
- பிழை: `KeyError` அல்லது config இல்லாதது பற்றிய எச்சரிக்கைகள்

**சாத்தியமான காரணங்கள்:**
- தேவையான சூழல் மாறிகள் அமைக்கப்படவில்லை

**தீர்வுகள்:**
1. **`.env.example` அல்லது இதற்கு இணையான கோப்புகளைச் சரிபார்க்கவும்.**
2. **`.env` கோப்பை உருவாக்கி தேவையான மதிப்புகளை நிரப்பவும்.**
3. **சூழல் மாறிகளை அமைத்த பிறகு உங்கள் terminal அல்லது IDE-ஐ மீண்டும் ஏற்றவும்.**

---

## நோட்புக் இயக்குதல்

### 6. நோட்புக் திறக்க அல்லது இயக்க முடியவில்லை

**பின்னணி:** Jupyter நோட்புக் சரியான அமைப்பை தேவைப்படுத்துகிறது.

**அறிகுறிகள்:**
- நோட்புக் தொடங்க முடியவில்லை
- உலாவி தானாக திறக்கவில்லை

**சாத்தியமான காரணங்கள்:**
- Jupyter நிறுவப்படவில்லை
- உலாவி அமைப்பு பிரச்சினைகள்

**தீர்வுகள்:**
1. **Jupyter-ஐ நிறுவவும் (மேலே உள்ள நிறுவல் பிரச்சினைகளைப் பார்க்கவும்).**
2. **நோட்புக் கையேடு முறையில் திறக்கவும்.**
   - Terminal-ல் URL-ஐ (எ.கா., `http://localhost:8888/?token=...`) நகலெடுத்து உலாவியில் ஒட்டவும்.

### 7. Kernel Crash ஆகிறது அல்லது Freeze ஆகிறது

**பின்னணி:** நோட்புக் kernels resource வரம்புகள் அல்லது code பிழைகள் காரணமாக crash ஆகலாம்.

**அறிகுறிகள்:**
- Kernel மீண்டும் மீண்டும் இறக்கிறது அல்லது மறுதொடக்கம் செய்கிறது
- Out-of-memory பிழைகள்

**சாத்தியமான காரணங்கள்:**
- பெரிய datasets
- பொருந்தாத code அல்லது packages

**தீர்வுகள்:**
1. **Kernel-ஐ மறுதொடக்கம் செய்யவும்.**  
   Jupyter-ல் "Restart Kernel" பொத்தானைப் பயன்படுத்தவும்.
2. **Memory பயன்பாட்டைச் சரிபார்க்கவும்.**  
   தேவையற்ற பயன்பாடுகளை மூடவும்.
3. **Cloud platforms-ல் நோட்புக் இயக்கவும்.**  
   [Google Colab](https://colab.research.google.com/) அல்லது [Azure Notebooks](https://notebooks.azure.com/) பயன்படுத்தவும்.

---

## செயல்திறன் பிரச்சினைகள்

### 8. நோட்புக் மெதுவாக இயங்குகிறது

**பின்னணி:** சில AI பணிகள் அதிக memory மற்றும் CPU தேவைப்படுத்தும்.

**அறிகுறிகள்:**
- மெதுவாக செயல்படுகிறது
- Laptop fan அதிகமாக இயங்குகிறது

**சாத்தியமான காரணங்கள்:**
- பெரிய datasets அல்லது models
- வரையறுக்கப்பட்ட கணினி வளங்கள்

**தீர்வுகள்:**
1. **Cloud platform-ஐப் பயன்படுத்தவும்.**
   - நோட்புக்-ஐ Colab அல்லது Azure Notebooks-க்கு upload செய்யவும்.
2. **Dataset அளவைக் குறைக்கவும்.**
   - பயிற்சிக்காக மாதிரி தரவுகளைப் பயன்படுத்தவும்.
3. **தேவையற்ற செயல்பாடுகளை மூடவும்.**
   - System 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 issue-ஐ திறக்கவும்.

---

## பங்களிப்பு பிரச்சினைகள்

### 10. PR ஏற்கப்படவில்லை அல்லது Builds தோல்வியடைந்தது

**பின்னணி:** பங்களிப்புகள் சோதனைகளை கடந்து வழிகாட்டுதல்களைப் பின்பற்ற வேண்டும்.

**அறிகுறிகள்:**
- Pull request நிராகரிக்கப்பட்டது
- CI/CD pipeline பிழைகள்

**சாத்தியமான காரணங்கள்:**
- தோல்வியடைந்த சோதனைகள்
- Coding standards-ஐ பின்பற்றவில்லை

**தீர்வுகள்:**
1. **பங்களிப்பு வழிகாட்டுதல்களைப் படிக்கவும்.**
   - Repository-யின் [CONTRIBUTING.md](https://github.com/microsoft/AI-For-Beginners/blob/main/CONTRIBUTING.md)-ஐ பின்பற்றவும்.
2. **Push செய்யும் முன் உள்ளூர் சோதனைகளை இயக்கவும்.**
3. **Linting விதிகள் அல்லது formatting தேவைகளைச் சரிபார்க்கவும்.**

---

## அடிக்கடி கேட்கப்படும் கேள்விகள்

### குறிப்பிட்ட modules-க்கு உதவியை எங்கு பெறலாம்?
- ஒவ்வொரு module-க்கும் பொதுவாக தனி README இருக்கும். அமைப்பு மற்றும் பயன்பாட்டு குறிப்புகளுக்கு அங்கு தொடங்கவும்.

### பிழையைப் புகாரளிக்க அல்லது அம்சத்தை கோர எப்படி?
- [GitHub Issue-ஐ திறக்கவும்](https://github.com/microsoft/AI-For-Beginners/issues/new) தெளிவான விளக்கம் மற்றும் மீண்டும் உருவாக்குவதற்கான படிகள் உடன்.

### என் பிரச்சினை பட்டியலில் இல்லை என்றால் உதவி கேட்கலாமா?
- ஆம்! உள்ள Issues-ஐ முதலில் தேடவும், உங்கள் பிரச்சினை கிடைக்கவில்லை என்றால் புதிய Issue-ஐ உருவாக்கவும்.

---

## உதவி பெறுதல்

- **Issues-ஐச் சரிபார்க்கவும்:** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **கேள்விகள் கேட்கவும்:** GitHub Discussions-ஐப் பயன்படுத்தவும் அல்லது Issue-ஐ திறக்கவும்.
- **சமூகம்:** Repository இணைப்புகளில் chat/forum விருப்பங்களைப் பார்க்கவும்.

---

_கடைசியாக புதுப்பிக்கப்பட்டது: 2025-09-20_

---

**குறிப்பு**:  
இந்த ஆவணம் [Co-op Translator](https://github.com/Azure/co-op-translator) என்ற AI மொழிபெயர்ப்பு சேவையைப் பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சிக்கின்றோம், ஆனால் தானியங்கி மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறான தகவல்கள் இருக்கக்கூடும் என்பதை தயவுசெய்து கவனத்தில் கொள்ளவும். அதன் தாய்மொழியில் உள்ள மூல ஆவணம் அதிகாரப்பூர்வ ஆதாரமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பைப் பயன்படுத்துவதால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பல்ல.