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

AI-For-Beginners خرابیوں کو دور کرنے کی گائیڈ

یہ گائیڈ آپ کو AI-For-Beginners ریپوزیٹری استعمال کرتے وقت یا اس میں تعاون کرتے وقت پیش آنے والے عام مسائل کو حل کرنے میں مدد فراہم کرتی ہے۔ ہر مسئلے میں پس منظر، علامات، وضاحتیں، اور مرحلہ وار حل شامل ہیں۔

---

فہرستِ مواد

• عام مسائل
• انسٹالیشن کے مسائل
• کنفیگریشن کے مسائل
• نوٹ بکس چلانا
• کارکردگی کے مسائل
• ٹیکسٹ بک ویب سائٹ کے مسائل
• تعاون کے مسائل
• اکثر پوچھے گئے سوالات
• مدد حاصل کرنا

---

عام مسائل

1. ریپوزیٹری صحیح طریقے سے کلون نہیں ہو رہی

پس منظر: کلوننگ آپ کو ریپوزیٹری کو اپنی مشین پر کاپی کرنے کی اجازت دیتی ہے۔

علامات:

• ایرر: 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 گائیڈ کو فالو کریں۔

---

انسٹالیشن کے مسائل

2. پائتھون ماحول کے مسائل

پس منظر: ریپوزیٹری پائتھون اور مختلف لائبریریوں پر انحصار کرتی ہے۔

علامات:

• ایرر: ModuleNotFoundError: No module named '<package>'
• اسکرپٹس یا نوٹ بکس چلانے پر امپورٹ ایررز

ممکنہ وجوہات:

• ڈیپینڈنسیز انسٹال نہیں کی گئیں
• غلط پائتھون ورژن

حل:

1. ورچوئل ماحول سیٹ اپ کریں۔

   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   

2. ڈیپینڈنسیز انسٹال کریں۔

   pip install -r requirements.txt
   

3. پائتھون ورژن چیک کریں۔
   پائتھون 3.7 یا جدید ورژن استعمال کریں۔

   python --version
   

3. جیوپیٹر انسٹال نہیں ہے

پس منظر: نوٹ بکس ایک بنیادی تعلیمی وسیلہ ہیں۔

علامات:

• ایرر: jupyter: command not found
• نوٹ بکس لانچ کرنے میں ناکام

ممکنہ وجوہات:

• جیوپیٹر انسٹال نہیں ہے

حل:

1. جیوپیٹر نوٹ بک انسٹال کریں۔

   pip install notebook
   

   یا، اگر اناکونڈا استعمال کر رہے ہیں:

   conda install notebook
   

2. جیوپیٹر نوٹ بک شروع کریں۔

   jupyter notebook
   

4. ڈیپینڈنسی ورژن کے تنازعات

پس منظر: پروجیکٹس تب خراب ہو سکتے ہیں جب پیکج ورژنز میں تضاد ہو۔

علامات:

• ایررز یا وارننگز جو غیر مطابقت پذیر ورژنز کے بارے میں ہوں

ممکنہ وجوہات:

• پرانے یا متضاد پائتھون پیکجز

حل:

1. صاف ماحول میں انسٹال کریں۔
   پرانے venv/conda env کو ڈیلیٹ کریں اور نیا بنائیں۔
2. عین ورژنز استعمال کریں۔
   ہمیشہ یہ چلائیں:

   pip install -r requirements.txt
   

   اگر یہ ناکام ہو، تو README میں بیان کردہ طریقے سے گمشدہ پیکجز کو دستی طور پر انسٹال کریں۔

---

کنفیگریشن کے مسائل

5. ماحول کے متغیرات سیٹ نہیں کیے گئے

پس منظر: کچھ ماڈیولز کو کیز، ٹوکنز، یا کنفیگریشن سیٹنگز کی ضرورت ہو سکتی ہے۔

علامات:

• ایرر: KeyError یا کنفیگریشن کے بارے میں وارننگز

ممکنہ وجوہات:

• مطلوبہ ماحول کے متغیرات سیٹ نہیں کیے گئے

حل:

1. .env.example یا اسی طرح کی فائلز چیک کریں۔
2. .env فائل بنائیں اور مطلوبہ ویلیوز بھریں۔
3. ماحول کے متغیرات سیٹ کرنے کے بعد اپنا ٹرمینل یا IDE دوبارہ لوڈ کریں۔

---

نوٹ بکس چلانا

6. نوٹ بک نہیں کھل رہی یا چل نہیں رہی

پس منظر: جیوپیٹر نوٹ بکس کو صحیح سیٹ اپ کی ضرورت ہوتی ہے۔

علامات:

• نوٹ بک لانچ کرنے میں ناکام
• براؤزر خود بخود نہیں کھل رہا

ممکنہ وجوہات:

• جیوپیٹر انسٹال نہیں ہے
• براؤزر کنفیگریشن کے مسائل

حل:

1. جیوپیٹر انسٹال کریں (اوپر انسٹالیشن کے مسائل دیکھیں).
2. نوٹ بکس کو دستی طور پر کھولیں۔
   • ٹرمینل سے URL کاپی کریں (جیسے، http://localhost:8888/?token=...) اور اسے اپنے براؤزر میں پیسٹ کریں۔

7. کرنل کریش ہو رہا ہے یا فریز ہو رہا ہے

پس منظر: نوٹ بک کرنلز وسائل کی حد یا کوڈ ایررز کی وجہ سے کریش کر سکتے ہیں۔

علامات:

• کرنل بار بار مر رہا ہے یا ری اسٹارٹ ہو رہا ہے
• آؤٹ آف میموری ایررز

ممکنہ وجوہات:

• بڑے ڈیٹا سیٹس
• غیر مطابقت پذیر کوڈ یا پیکجز

حل:

1. کرنل کو ری اسٹارٹ کریں۔
   جیوپیٹر میں "Restart Kernel" بٹن استعمال کریں۔
2. میموری کا استعمال چیک کریں۔
   غیر استعمال شدہ ایپلیکیشنز بند کریں۔
3. نوٹ بکس کو کلاؤڈ پلیٹ فارمز پر چلائیں۔
   Google Colab یا Azure Notebooks استعمال کریں۔

---

کارکردگی کے مسائل

8. نوٹ بکس آہستہ چل رہی ہیں

پس منظر: کچھ AI ٹاسکس کو کافی میموری اور CPU کی ضرورت ہوتی ہے۔

علامات:

• سست عملدرآمد
• لیپ ٹاپ کا فین زور سے چل رہا ہے

ممکنہ وجوہات:

• بڑے ڈیٹا سیٹس یا ماڈلز
• محدود سسٹم وسائل

حل:

1. کلاؤڈ پلیٹ فارم استعمال کریں۔
   • نوٹ بک کو Colab یا Azure Notebooks پر اپلوڈ کریں۔
2. ڈیٹا سیٹ کا سائز کم کریں۔
   • مشق کے لیے نمونہ ڈیٹا استعمال کریں۔
3. غیر ضروری پروگرامز بند کریں۔
   • سسٹم RAM کو خالی کریں۔

---

ٹیکسٹ بک ویب سائٹ کے مسائل

9. باب لوڈ نہیں ہو رہا

پس منظر: آن لائن ٹیکسٹ بک اسباق اور ابواب دکھاتی ہے۔

علامات:

• کوئی باب (جیسے، Transformers/BERT) غائب ہے یا نہیں کھل رہا

معروف مسئلہ:

• مسئلہ #303: “18 Transformers. BERT. ٹیکسٹ بک ویب سائٹ پر نہیں کھل رہا۔” فائل نام کی غلطی کی وجہ سے (READMEtransformers.md بجائے README.md).

حل:

1. فائل کے نام کی غلطیوں کو چیک کریں۔
   اگر آپ کنٹریبیوٹر ہیں، تو یقینی بنائیں کہ باب کی فائلز کا نام README.md ہے۔
2. گمشدہ فائلز کی رپورٹ کریں۔
   باب کے نام اور ایرر کی تفصیلات کے ساتھ ایک GitHub مسئلہ کھولیں۔

---

تعاون کے مسائل

10. PR قبول نہیں ہو رہا یا بلڈز ناکام ہو رہے ہیں

پس منظر: تعاون کو ٹیسٹس پاس کرنے اور گائیڈ لائنز پر عمل کرنے کی ضرورت ہوتی ہے۔

علامات:

• پل ریکویسٹ مسترد ہو رہا ہے
• CI/CD پائپ لائن ایررز

ممکنہ وجوہات:

• ناکام ٹیسٹس
• کوڈنگ اسٹینڈرڈز پر عمل نہ کرنا

حل:

1. تعاون کی گائیڈ لائنز پڑھیں۔
   • ریپوزیٹری کے CONTRIBUTING.md کو فالو کریں۔
2. پش کرنے سے پہلے لوکل ٹیسٹس چلائیں۔
3. لینٹنگ رولز یا فارمیٹنگ کی ضروریات چیک کریں۔

---

اکثر پوچھے گئے سوالات

مخصوص ماڈیولز کے لیے مدد کہاں مل سکتی ہے؟

• ہر ماڈیول کے پاس عام طور پر اپنی README ہوتی ہے۔ سیٹ اپ اور استعمال کے نکات کے لیے وہاں سے شروع کریں۔

میں بگ رپورٹ کرنے یا فیچر کی درخواست کیسے کر سکتا ہوں؟

• GitHub مسئلہ کھولیں واضح تفصیل اور دوبارہ پیدا کرنے کے مراحل کے ساتھ۔

اگر میرا مسئلہ درج نہیں ہے تو کیا میں مدد مانگ سکتا ہوں؟

• جی ہاں! پہلے موجودہ مسائل تلاش کریں، اور اگر آپ کو اپنا مسئلہ نہ ملے، تو نیا مسئلہ بنائیں۔

---

مدد حاصل کرنا

• مسائل چیک کریں: GitHub Issues
• سوالات پوچھیں: GitHub Discussions استعمال کریں یا مسئلہ کھولیں۔
• کمیونٹی: چیٹ/فورم کے اختیارات کے لیے ریپوزیٹری لنکس دیکھیں۔

---

آخری اپ ڈیٹ: 2025-09-20

---

ڈسکلیمر:
یہ دستاویز AI ترجمہ سروس Co-op Translator کا استعمال کرتے ہوئے ترجمہ کی گئی ہے۔ ہم درستگی کے لیے کوشش کرتے ہیں، لیکن براہ کرم آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا غیر درستیاں ہو سکتی ہیں۔ اصل دستاویز کو اس کی اصل زبان میں مستند ذریعہ سمجھا جانا چاہیے۔ اہم معلومات کے لیے، پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ ہم اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کے ذمہ دار نہیں ہیں۔