microsoft/AI-For-Beginners

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "8d9c5a4a7c7798d699672a22cb7fea86",
  "translation_date": "2025-10-03T09:39:51+00:00",
  "source_file": "troubleshoot.md",
  "language_code": "bn"
}
-->
# AI-For-Beginners সমস্যার সমাধানের গাইড

এই গাইডটি আপনাকে [AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners) রিপোজিটরি ব্যবহার বা এতে অবদান রাখার সময় সাধারণ সমস্যাগুলি সমাধান করতে সাহায্য করবে। প্রতিটি সমস্যার পেছনের কারণ, লক্ষণ, ব্যাখ্যা এবং ধাপে ধাপে সমাধান অন্তর্ভুক্ত রয়েছে।

---

## বিষয়সূচি

- [সাধারণ সমস্যা](../..)
- [ইনস্টলেশন সমস্যা](../..)
- [কনফিগারেশন সমস্যা](../..)
- [নোটবুক চালানো](../..)
- [পারফরম্যান্স সমস্যা](../..)
- [টেক্সটবুক ওয়েবসাইট সমস্যা](../..)
- [অবদান রাখার সমস্যা](../..)
- [প্রশ্নোত্তর](../..)
- [সাহায্য পাওয়া](../..)

---

## সাধারণ সমস্যা

### ১. রিপোজিটরি সঠিকভাবে ক্লোন হচ্ছে না

**পেছনের কারণ:** ক্লোনিং আপনাকে রিপোজিটরি আপনার মেশিনে কপি করতে দেয়।

**লক্ষণ:**
- ত্রুটি: `fatal: repository not found`
- ত্রুটি: `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) অনুসরণ করুন।

---

## ইনস্টলেশন সমস্যা

### ২. পাইথন এনভায়রনমেন্ট সমস্যা

**পেছনের কারণ:** এই রিপোজিটরি পাইথন এবং বিভিন্ন লাইব্রেরির উপর নির্ভরশীল।

**লক্ষণ:**
- ত্রুটি: `ModuleNotFoundError: No module named '<package>'`
- স্ক্রিপ্ট বা নোটবুক চালানোর সময় ইমপোর্ট ত্রুটি

**সম্ভাব্য কারণ:**
- ডিপেন্ডেন্সি ইনস্টল করা হয়নি
- ভুল পাইথন ভার্সন

**সমাধান:**
1. **একটি ভার্চুয়াল এনভায়রনমেন্ট সেটআপ করুন।**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   ```
2. **ডিপেন্ডেন্সি ইনস্টল করুন।**  
   ```bash
   pip install -r requirements.txt
   ```
3. **পাইথন ভার্সন পরীক্ষা করুন।**  
   পাইথন ৩.৭ বা নতুন ভার্সন ব্যবহার করুন।  
   ```bash
   python --version
   ```

### ৩. জুপিটার ইনস্টল করা হয়নি

**পেছনের কারণ:** নোটবুকগুলো প্রধান শিক্ষার রিসোর্স।

**লক্ষণ:**
- ত্রুটি: `jupyter: command not found`
- নোটবুক চালু হতে ব্যর্থ

**সম্ভাব্য কারণ:**
- জুপিটার ইনস্টল করা হয়নি

**সমাধান:**
1. **জুপিটার নোটবুক ইনস্টল করুন।**  
   ```bash
   pip install notebook
   ```
   অথবা, যদি Anaconda ব্যবহার করেন:
   ```bash
   conda install notebook
   ```
2. **জুপিটার নোটবুক চালু করুন।**  
   ```bash
   jupyter notebook
   ```

### ৪. ডিপেন্ডেন্সি ভার্সন কনফ্লিক্ট

**পেছনের কারণ:** প্যাকেজ ভার্সন মিসম্যাচ হলে প্রজেক্ট ভেঙে যেতে পারে।

**লক্ষণ:**
- অসঙ্গত ভার্সন সম্পর্কিত ত্রুটি বা সতর্কবার্তা

**সম্ভাব্য কারণ:**
- পুরানো বা অসঙ্গত পাইথন প্যাকেজ

**সমাধান:**
1. **পরিষ্কার এনভায়রনমেন্টে ইনস্টল করুন।**  
   পুরানো venv/conda env মুছে ফেলে নতুন একটি তৈরি করুন।
2. **নির্দিষ্ট ভার্সন ব্যবহার করুন।**  
   সবসময় চালান:  
   ```bash
   pip install -r requirements.txt
   ```
   যদি এটি ব্যর্থ হয়, README-তে বর্ণিত পদ্ধতি অনুযায়ী মিসিং প্যাকেজ ম্যানুয়ালি ইনস্টল করুন।

---

## কনফিগারেশন সমস্যা

### ৫. এনভায়রনমেন্ট ভেরিয়েবল সেট করা হয়নি

**পেছনের কারণ:** কিছু মডিউল কী, টোকেন বা কনফিগারেশন সেটিংস প্রয়োজন।

**লক্ষণ:**
- ত্রুটি: `KeyError` বা মিসিং কনফিগারেশন সম্পর্কিত সতর্কবার্তা

**সম্ভাব্য কারণ:**
- প্রয়োজনীয় এনভায়রনমেন্ট ভেরিয়েবল সেট করা হয়নি

**সমাধান:**
1. **`.env.example` বা অনুরূপ ফাইল খুঁজুন।**
2. **একটি `.env` ফাইল তৈরি করুন এবং প্রয়োজনীয় মান পূরণ করুন।**
3. **এনভায়রনমেন্ট ভেরিয়েবল সেট করার পর টার্মিনাল বা IDE পুনরায় লোড করুন।**

---

## নোটবুক চালানো

### ৬. নোটবুক খুলছে না বা চালু হচ্ছে না

**পেছনের কারণ:** জুপিটার নোটবুক সঠিক সেটআপ প্রয়োজন।

**লক্ষণ:**
- নোটবুক চালু হতে ব্যর্থ
- ব্রাউজার স্বয়ংক্রিয়ভাবে খুলছে না

**সম্ভাব্য কারণ:**
- জুপিটার ইনস্টল করা হয়নি
- ব্রাউজার কনফিগারেশন সমস্যা

**সমাধান:**
1. **জুপিটার ইনস্টল করুন (উপরে ইনস্টলেশন সমস্যাগুলি দেখুন)।**
2. **নোটবুক ম্যানুয়ালি খুলুন।**
   - টার্মিনাল থেকে URL কপি করুন (যেমন, `http://localhost:8888/?token=...`) এবং এটি ব্রাউজারে পেস্ট করুন।

### ৭. কার্নেল ক্র্যাশ করছে বা ফ্রিজ করছে

**পেছনের কারণ:** নোটবুক কার্নেল রিসোর্স সীমা বা কোড ত্রুটির কারণে ক্র্যাশ করতে পারে।

**লক্ষণ:**
- কার্নেল বারবার মারা যাচ্ছে বা রিস্টার্ট হচ্ছে
- মেমোরি সংক্রান্ত ত্রুটি

**সম্ভাব্য কারণ:**
- বড় ডেটাসেট
- অসঙ্গত কোড বা প্যাকেজ

**সমাধান:**
1. **কার্নেল রিস্টার্ট করুন।**  
   জুপিটারে "Restart Kernel" বোতাম ব্যবহার করুন।
2. **মেমোরি ব্যবহার পরীক্ষা করুন।**  
   অপ্রয়োজনীয় অ্যাপ্লিকেশন বন্ধ করুন।
3. **ক্লাউড প্ল্যাটফর্মে নোটবুক চালান।**  
   [Google Colab](https://colab.research.google.com/) বা [Azure Notebooks](https://notebooks.azure.com/) ব্যবহার করুন।

---

## পারফরম্যান্স সমস্যা

### ৮. নোটবুক ধীরে চলছে

**পেছনের কারণ:** কিছু AI কাজ উল্লেখযোগ্য মেমোরি এবং CPU প্রয়োজন।

**লক্ষণ:**
- ধীর এক্সিকিউশন
- ল্যাপটপের ফ্যান জোরে চলছে

**সম্ভাব্য কারণ:**
- বড় ডেটাসেট বা মডেল
- সীমিত সিস্টেম রিসোর্স

**সমাধান:**
1. **ক্লাউড প্ল্যাটফর্ম ব্যবহার করুন।**
   - নোটবুক Colab বা Azure Notebooks-এ আপলোড করুন।
2. **ডেটাসেটের আকার কমান।**
   - অনুশীলনের জন্য নমুনা ডেটা ব্যবহার করুন।
3. **অপ্রয়োজনীয় প্রোগ্রাম বন্ধ করুন।**
   - সিস্টেম RAM মুক্ত করুন।

---

## টেক্সটবুক ওয়েবসাইট সমস্যা

### ৯. অধ্যায় লোড হচ্ছে না

**পেছনের কারণ:** অনলাইন টেক্সটবুক পাঠ এবং অধ্যায় প্রদর্শন করে।

**লক্ষণ:**
- একটি অধ্যায় (যেমন, Transformers/BERT) অনুপস্থিত বা খুলছে না

**পরিচিত সমস্যা:**  
- [Issue #303](https://github.com/microsoft/AI-For-Beginners/issues/303): “18 Transformers. BERT. টেক্সটবুক ওয়েবসাইটে খোলা যাচ্ছে না।” ফাইলনেম ত্রুটি (`READMEtransformers.md` এর পরিবর্তে `README.md`) এর কারণে।

**সমাধান:**
1. **ফাইল রিনেমিং ত্রুটি পরীক্ষা করুন।**  
   আপনি যদি কন্ট্রিবিউটর হন, নিশ্চিত করুন যে অধ্যায় ফাইলের নাম `README.md`।
2. **মিসিং ফাইল রিপোর্ট করুন।**  
   অধ্যায়ের নাম এবং ত্রুটির বিবরণ সহ একটি GitHub ইস্যু খুলুন।

---

## অবদান রাখার সমস্যা

### ১০. 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 ব্যবহার করুন বা একটি ইস্যু খুলুন।
- **কমিউনিটি:** চ্যাট/ফোরাম অপশনের জন্য রিপোজিটরি লিঙ্ক দেখুন।

---

_সর্বশেষ আপডেট: ২০২৫-০৯-২০_

---

**অস্বীকৃতি**:  
এই নথিটি AI অনুবাদ পরিষেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার জন্য চেষ্টা করি, তবে অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল ভাষায় থাকা নথিটিকে প্রামাণিক উৎস হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য, পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদ ব্যবহারের ফলে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যা হলে আমরা দায়বদ্ধ থাকব না।