Spaces:
Sleeping
Sleeping
| ================================================================================ | |
| HUGGING FACE SPACES DEPLOYMENT - ADIM ADIM | |
| ================================================================================ | |
| 📁 HAZIR DOSYALAR: | |
| ✓ Dockerfile | |
| ✓ app.py | |
| ✓ requirements.txt | |
| ✓ README.md | |
| ✓ test_deployed_api.py | |
| ================================================================================ | |
| ADIMLAR: | |
| ================================================================================ | |
| 1️⃣ HUGGING FACE'E GİT | |
| URL: https://huggingface.co/new-space | |
| Hesabın yoksa önce kayıt ol: | |
| https://huggingface.co/join | |
| -------------------------------------------------------------------------------- | |
| 2️⃣ YENİ SPACE OLUŞTUR | |
| ⚙️ AYARLAR: | |
| Space name: dog-breed-api | |
| (veya istediğin isim) | |
| Space SDK: 🐳 Docker ⚠️ ÇOK ÖNEMLİ! | |
| (Gradio veya Streamlit DEĞİL - sadece Docker!) | |
| Space hardware: CPU basic - Free | |
| Visibility: Public | |
| ➤ "Create Space" tıkla | |
| -------------------------------------------------------------------------------- | |
| 3️⃣ DOSYALARI YÜKLE | |
| Space açıldıktan sonra: | |
| a) Üstteki "+ Add file" → "Upload files" tıkla | |
| b) Şu SIRAYA GÖRE dosyaları yükle: | |
| 1. Dockerfile | |
| 2. requirements.txt | |
| 3. app.py | |
| 4. README.md (opsiyonel) | |
| c) Her dosyadan sonra "Commit changes to main" tıkla | |
| -------------------------------------------------------------------------------- | |
| 4️⃣ BUILD İZLE | |
| Dosyalar yüklendikten sonra: | |
| - "App" sekmesine geç | |
| - "Building..." yazısını göreceksin | |
| - Logs açılacak | |
| ⏱️ Bekleme: 5-10 dakika | |
| Loglar: | |
| ┌─────────────────────────────────────┐ | |
| │ Building Docker image... │ | |
| │ Installing dependencies... │ | |
| │ Downloading model (200+ MB)... │ | |
| │ Starting application... │ | |
| │ ✓ Running on port 7860 │ | |
| └─────────────────────────────────────┘ | |
| Başarılı olunca: ✓ Running | |
| -------------------------------------------------------------------------------- | |
| 5️⃣ TEST ET! | |
| Space URL'in: | |
| https://KULLANICI-ADIN-dog-breed-api.hf.space | |
| API Endpoint: | |
| https://KULLANICI-ADIN-dog-breed-api.hf.space/predict_pet | |
| 📝 Test scripti ile: | |
| a) test_deployed_api.py dosyasını aç | |
| b) İlk satırı düzenle: | |
| SPACE_URL = "https://SENIN-KULLANICI-ADIN-dog-breed-api.hf.space" | |
| c) Çalıştır: | |
| python test_deployed_api.py | |
| 🌐 Browser'da test: | |
| a) https://KULLANICI-ADIN-dog-breed-api.hf.space/ aç | |
| → Sağlık kontrolü göreceksin (JSON) | |
| b) Postman/Insomnia kullan: | |
| - URL: .../predict_pet | |
| - Method: POST | |
| - Body: form-data | |
| - Key: image (file type) | |
| - Value: Bir köpek fotoğrafı seç | |
| ================================================================================ | |
| BAŞARILI OLDUKTAN SONRA: | |
| ================================================================================ | |
| ✅ API'n hazır! | |
| 📡 Endpoint: | |
| https://KULLANICI-ADIN-dog-breed-api.hf.space/predict_pet | |
| 📊 Kullanım örnekleri: | |
| - README.md dosyasına bak | |
| - Python, JavaScript, cURL örnekleri var | |
| ⚡ Performans: | |
| - İlk istek: 10-15s (model yükleme) | |
| - Sonraki: 2-4s (hızlı!) | |
| 💰 Maliyet: | |
| - TAMAMEN ÜCRETSİZ! (Public Space) | |
| ================================================================================ | |
| SORUN GİDERME | |
| ================================================================================ | |
| ❌ "Building failed" | |
| → Logs'a bak, hata mesajını gör | |
| → Dockerfile'ı kontrol et | |
| → requirements.txt'yi kontrol et | |
| ❌ "503 Service Unavailable" | |
| → Space henüz başlamadı, 1-2 dakika bekle | |
| ❌ "Out of memory" | |
| → Model çok büyük, ücretli tier gerek | |
| → Ya da daha küçük model kullan | |
| ❌ Fotoğraf yüklenmiyor | |
| → Dosya boyutu max 10MB olmalı | |
| → Format: JPEG, PNG, WebP | |
| ================================================================================ | |
| İPUCU: Space'i aktif tut | |
| ================================================================================ | |
| Hugging Face Spaces'te free tier'da Space'ler inaktifse uyku moduna girer. | |
| İlk istekte tekrar uyanır (10-15 saniye sürer). | |
| Sürekli aktif tutmak için: | |
| - Her gün 1 istek at | |
| - Ya da ücretli tier'a geç (always-on) | |
| ================================================================================ | |
| BAŞARILAR! 🚀 | |
| ================================================================================ | |