RomanNum3ral
/
AI-For-Beginners
mirror of https://github.com/microsoft/AI-For-Beginners.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AI-For-Beginners/translations/tr/troubleshoot.md

8.5 KiB
Raw Blame History

AI-For-Beginners Sorun Giderme Kılavuzu

Bu kılavuz, AI-For-Beginners deposunu kullanırken veya katkıda bulunurken karşılaşılan yaygın sorunları çözmenize yardımcı olur. Her sorun için arka plan bilgisi, belirtiler, açıklamalar ve adım adım çözümler sunulmaktadır.

İçindekiler

Genel Sorunlar

1. Depo Doğru Şekilde Klonlanamıyor

Arka Plan: Klonlama, depoyu bilgisayarınıza kopyalamanıza olanak tanır.

Belirtiler:

  • Hata: fatal: repository not found
  • Hata: Permission denied (publickey)

Olası Nedenler:

  • Yanlış depo URL'si
  • Yetersiz izinler
  • SSH anahtarları yapılandırılmamış

Çözümler:

  1. Depo URL'sini kontrol edin.
    HTTPS URL'sini kullanın: 
    git clone https://github.com/microsoft/AI-For-Beginners.git
  2. SSH başarısız olursa HTTPS'e geçin.
    Eğer Permission denied (publickey) hatası alıyorsanız, SSH yerine yukarıdaki HTTPS bağlantısını kullanın.
  3. SSH anahtarlarını yapılandırın (isteğe bağlı).
    SSH kullanmak istiyorsanız, GitHub'ın SSH rehberini takip edin.

Kurulum Sorunları

2. Python Ortamı Sorunları

Arka Plan: Depo, Python ve çeşitli kütüphanelere dayanır.

Belirtiler:

  • Hata: ModuleNotFoundError: No module named '<package>'
  • Script veya notebook çalıştırırken ithalat hataları

Olası Nedenler:

  • Bağımlılıklar yüklenmemiş
  • Yanlış Python sürümü

Çözümler:

  1. Sanal bir ortam oluşturun. 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. Bağımlılıkları yükleyin. 
    pip install -r requirements.txt
  3. Python sürümünü kontrol edin.
    Python 3.7 veya daha yeni bir sürüm kullanın. 
    python --version

3. Jupyter Yüklenmemiş

Arka Plan: Notebook'lar temel öğrenme kaynağıdır.

Belirtiler:

  • Hata: jupyter: command not found
  • Notebook'lar açılmıyor

Olası Nedenler:

  • Jupyter yüklenmemiş

Çözümler:

  1. Jupyter Notebook'u yükleyin. 
    pip install notebook
    veya, Anaconda kullanıyorsanız: 
    conda install notebook
  2. Jupyter Notebook'u başlatın. 
    jupyter notebook

4. Bağımlılık Sürüm Çakışmaları

Arka Plan: Paket sürümleri uyumsuz olduğunda projeler bozulabilir.

Belirtiler:

  • Uyumsuz sürümlerle ilgili hata veya uyarılar

Olası Nedenler:

  • Eski veya çakışan Python paketleri

Çözümler:

  1. Temiz bir ortamda yükleme yapın.
    Eski venv/conda ortamını silin ve yenisini oluşturun.
  2. Kesin sürümleri kullanın.
    Her zaman şu komutu çalıştırın: 
    pip install -r requirements.txt
    Eğer bu başarısız olursa, README'de açıklanan şekilde eksik paketleri manuel olarak yükleyin.

Yapılandırma Sorunları

5. Ortam Değişkenleri Ayarlanmamış

Arka Plan: Bazı modüller anahtarlar, token'lar veya yapılandırma ayarları gerektirebilir.

Belirtiler:

  • Hata: KeyError veya eksik yapılandırma ile ilgili uyarılar

Olası Nedenler:

  • Gerekli ortam değişkenleri ayarlanmamış

Çözümler:

  1. .env.example veya benzer dosyaları kontrol edin.
  2. Bir .env dosyası oluşturun ve gerekli değerleri doldurun.
  3. Ortam değişkenlerini ayarladıktan sonra terminalinizi veya IDE'nizi yeniden başlatın.

Notebook Çalıştırma

6. Notebook Açılmıyor veya Çalışmıyor

Arka Plan: Jupyter notebook'ların doğru şekilde kurulması gerekir.

Belirtiler:

  • Notebook başlatılamıyor
  • Tarayıcı otomatik olarak açılmıyor

Olası Nedenler:

  • Jupyter yüklenmemiş
  • Tarayıcı yapılandırma sorunları

Çözümler:

  1. Jupyter'i yükleyin (yukarıdaki Kurulum Sorunları bölümüne bakın).
  2. Notebook'ları manuel olarak açın.
    • Terminaldeki URL'yi (örneğin, http://localhost:8888/?token=...) kopyalayıp tarayıcınıza yapıştırın.

7. Çekirdek Çöküyor veya Donuyor

Arka Plan: Notebook çekirdekleri kaynak sınırları veya kod hataları nedeniyle çökebilir.

Belirtiler:

  • Çekirdek sürekli olarak çöküyor veya yeniden başlıyor
  • Bellek yetersiz hataları

Olası Nedenler:

  • Büyük veri setleri
  • Uyumsuz kod veya paketler

Çözümler:

  1. Çekirdeği yeniden başlatın.
    Jupyter'deki "Restart Kernel" düğmesini kullanın.
  2. Bellek kullanımını kontrol edin.
    Kullanılmayan uygulamaları kapatın.
  3. Notebook'ları bulut platformlarında çalıştırın.
    Google Colab veya Azure Notebooks kullanın.

Performans Sorunları

8. Notebook'lar Yavaş Çalışıyor

Arka Plan: Bazı AI görevleri önemli miktarda bellek ve CPU gerektirir.

Belirtiler:

  • Yavaş çalışma
  • Dizüstü bilgisayar fanının yüksek sesle çalışması

Olası Nedenler:

  • Büyük veri setleri veya modeller
  • Sınırlı sistem kaynakları

Çözümler:

  1. Bir bulut platformu kullanın.
    • Notebook'u Colab veya Azure Notebooks'a yükleyin.
  2. Veri seti boyutunu küçültün.
    • Uygulama için örnek veri kullanın.
  3. Gereksiz programları kapatın.
    • Sistem RAM'ini boşaltın.

Ders Kitabı Web Sitesi Sorunları

9. Bölüm Yüklenmiyor

Arka Plan: Çevrimiçi ders kitabı, dersleri ve bölümleri görüntüler.

Belirtiler:

  • Bir bölüm (örneğin, Transformers/BERT) eksik veya açılmıyor

Bilinen Sorun:

  • Sorun #303: “18 Transformers. BERT. ders kitabı web sitesinde açılamıyor.” Dosya adı hatasından kaynaklanıyor (READMEtransformers.md yerine README.md).

Çözümler:

  1. Dosya adlandırma hatalarını kontrol edin.
    Eğer katkıda bulunuyorsanız, bölüm dosyalarının README.md olarak adlandırıldığından emin olun.
  2. Eksik dosyaları bildirin.
    Bölüm adı ve hata detaylarıyla bir GitHub sorunu açın.

Katkı Sağlama Sorunları

10. PR Kabul Edilmiyor veya Yapılar Başarısız

Arka Plan: Katkılar testleri geçmeli ve yönergelere uygun olmalıdır.

Belirtiler:

  • Pull request reddedildi
  • CI/CD pipeline hataları

Olası Nedenler:

  • Başarısız testler
  • Kodlama standartlarına uyulmaması

Çözümler:

  1. Katkı yönergelerini okuyun.
  2. Push yapmadan önce testleri yerel olarak çalıştırın.
  3. Linting kurallarını veya biçimlendirme gereksinimlerini kontrol edin.

SSS

Belirli modüller için nereden yardım alabilirim?

  • Her modül genellikle kendi README dosyasına sahiptir. Kurulum ve kullanım ipuçları için oradan başlayın.

Bir hata nasıl bildirilir veya özellik talep edilir?

Sorunum listede yoksa yardım isteyebilir miyim?

  • Evet! Önce mevcut sorunları arayın, eğer sorununuzu bulamazsanız yeni bir sorun oluşturun.

Yardım Alma

  • Sorunları Kontrol Edin: GitHub Sorunları
  • Sorular Sorun: GitHub Discussions'ı kullanın veya bir sorun açın.
  • Topluluk: Sohbet/forum seçenekleri için depo bağlantılarını inceleyin.

Son Güncelleme: 2025-09-20

Feragatname:
Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayın. Belgenin orijinal dili, yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımından kaynaklanan yanlış anlamalar veya yanlış yorumlamalar için sorumluluk kabul etmiyoruz.