DEPLOYMENT.md

🚀 Hugging Face'e Yükleme Talimatları

Bu dosya, projeyi Hugging Face'e nasıl yükleyeceğinizi açıklar.

📋 Ön Hazırlık

1. Hugging Face hesabı oluşturun: https://huggingface.co/join
2. Access token alın: https://huggingface.co/settings/tokens
3. Git LFS kurun (büyük dosyalar için):

   git lfs install
   

🌐 Space Olarak Yükleme

1. Yeni Space Oluştur

Hugging Face'te: https://huggingface.co/new-space

• Space name: advanced-dataset-tutorial
• License: MIT
• SDK: Gradio
• Hardware: CPU (basic)

2. Repository'yi Clone Et

git clone https://huggingface.co/spaces/YOUR-USERNAME/advanced-dataset-tutorial
cd advanced-dataset-tutorial

3. Dosyaları Kopyala

# Proje dosyalarını kopyala
cp -r /path/to/advanced-dataset-tutorial/* .

# Yapı:
# .
# ├── README.md
# ├── requirements.txt
# ├── LICENSE
# ├── .gitignore
# ├── datasets/
# └── space/
#     ├── app.py
#     └── modules/

4. Push Et

git add .
git commit -m "Initial commit: Advanced Dataset Tutorial"
git push

5. Space Otomatik Deploy Olacak! 🎉

Birkaç dakika içinde: https://huggingface.co/spaces/YOUR-USERNAME/advanced-dataset-tutorial

📊 Dataset Olarak Yükleme (Opsiyonel)

1. Dataset Repository Oluştur

# Yeni dataset repository
huggingface-cli repo create advanced-dataset-tutorial --type dataset

# Clone
git clone https://huggingface.co/datasets/YOUR-USERNAME/advanced-dataset-tutorial
cd advanced-dataset-tutorial

2. Dataset Dosyalarını Hazırla

# create_datasets.py
from datasets import Dataset, DatasetDict

# Örnek dataset'leri oluştur
datasets = DatasetDict({
    'large_scale_examples': ...,
    'domain_specific_examples': ...,
    'advanced_techniques_examples': ...,
    'task_specific_examples': ...
})

# Kaydet
datasets.save_to_disk('dataset')

3. Push Dataset

git add .
git commit -m "Add dataset examples"
git push

🔗 GitHub Integration (Opsiyonel)

1. GitHub Repository Oluştur

# GitHub'da repo oluştur, sonra:
git remote add github https://github.com/YOUR-USERNAME/advanced-dataset-tutorial
git push github main

2. Hugging Face ile Sync Et

Hugging Face Space settings'de:

• GitHub repository'yi bağla
• Auto-sync etkinleştir

📝 Yükleme Sonrası Checklist

• Space çalışıyor mu? Test et
• README düzgün görünüyor mu?
• Gradio demo açılıyor mu?
• Tüm modüller yüklendi mi?
• License doğru mu?
• Tags eklendi mi?

🎨 Customization

Space Settings

Settings'den düzenle:

• Title: Advanced Dataset Tutorial
• Emoji: 📚
• Theme: Soft (veya istediğiniz)
• Hardware: CPU Basic (ücretsiz)

README Metadata

README.md başındaki metadata'yı güncelleyin: ```yaml

title: Advanced Dataset Tutorial emoji: 📚 colorFrom: blue colorTo: purple sdk: gradio sdk_version: 4.44.0 app_file: space/app.py

## 🐛 Sorun Giderme

### Space Build Hatası

1. Logs'u kontrol et
2. `requirements.txt` doğru mu?
3. `app.py` path'i doğru mu?

### Import Hatası

```python
# app.py'de path ekle
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent / "modules"))

Network Hatası

Hugging Face'te bazı URL'ler block'lanabilir. Lokal dataset'ler kullanın.

📚 Kaynaklar

• Hugging Face Spaces Docs
• Gradio Docs
• Git LFS

✅ Başarı!

Space'iniz hazır! Şimdi:

1. 🌐 Demo'yu paylaş: Space URL'ini arkadaşlarınla paylaş
2. ⭐ Community: Discussion'lar aç, feedback al
3. 🔄 Güncelle: Düzenli olarak yeni örnekler ekle
4. 📊 İstatistik: Space usage'i takip et

---

İyi şanslar! 🚀

Sorularınız için: @yourusername