PhotoPrism’de Tekrar Yüz Tanıma Nasıl Yapılır?

PhotoPrism, fotoğraf arşivlerini akıllı etiketleme ve yüz tanıma özellikleriyle düzenlemeyi oldukça kolaylaştıran güçlü bir açık kaynak platformu. Ancak bazen yüz tanıma sonuçları beklendiği gibi olmayabilir ya da kütüphaneye sonradan eklenen fotoğraflar için yüz tanımanın yeniden çalıştırılması gerekebilir. Bu yazıda PhotoPrism’de yüz tanımayı (Face Recognition) nasıl tekrar çalıştırabileceğinizi adım adım anlatıyorum.

Nasıl Çalışır?

PhotoPrism yüz tanımayı iki ayrı aşamada yapar:

Tespit: Her fotoğraftaki yüzleri bulur, koordinatlarını kaydeder.
Kümeleme ve Eşleştirme: Benzer yüzleri gruplar, daha önce isimlendirdiğiniz kişilerle karşılaştırır ve eşleşme bulursa otomatik atar.

💡 PhotoPrism sıfırdan otomatik isimlendirme yapmaz. Yüzleri gruplayıp size getirir; siz bir kez “bu Ali” dersiniz, sonraki fotoğraflarda Ali’yi kendisi bulur.

Ne Zaman Yeniden Çalıştırmalısınız?

Yeni fotoğraflar eklediniz ama yüzler eşleşmiyorsa
PhotoPrism’i güncellediniz ve algoritma iyileştirmelerinden faydalanmak istiyorsanız
Yanlış eşleştirilen yüzleri temizledikten sonra yeniden analiz yapmak istiyorsanız
Yüz tanıma kapalıyken fotoğraflar eklenmişse
Sunucuyu veya cihazı değiştirdiyseniz — örneğin Raspberry Pi’dan başka bir makineye geçiş

Adım 1: Yüz Verilerini Denetleyin ve Düzeltin

Önce bozuk veya tutarsız küme verilerini tespit edip onarın:

docker exec -it photoprism photoprism faces audit --fix

Çıktıda şöyle satırlar görebilirsiniz — bu normaldir:

faces: normalized 503 face clusters (13819 marker distances updated)
faces: successful conflict resolution for 'Utku Kahraman'

Çözülemeyen “ambiguous subject” uyarıları kritik değildir; o kümeler People sayfasından manuel düzeltilebilir.

Adım 2: Yüzleri Yeniden İndeksleyin

Tüm fotoğrafları tarar, yüz kümelerini günceller:

docker exec -it photoprism photoprism faces index

⚠️ Bu versiyonda --force flag’i tanımlı değil; düz faces index yeterli. 20.000+ fotoğraflık arşivlerde 2–3 saat sürebilir.

Terminal kapanınca durmasın istiyorsanız arka planda çalıştırın:

nohup docker exec photoprism photoprism faces index > faces_index.log 2>&1 &

İlerlemeyi takip etmek için:

tail -f faces_index.log

Bitmesini şu satırla anlarsınız:

indexed 21,718 files in 2h18m51s

Adım 3: Kişilerle Eşleştirin

Kümeleri daha önce isimlendirdiğiniz kişilerle karşılaştırır ve eşleşmeleri atar:

docker exec -it photoprism photoprism faces update

faces: updated 244 markers, recognized 245 faces, 0 unknown [1m50s]
completed in 35m59s

Adım 4: Optimize Edin

Küme kalitesini artırır, yanlış eşleşmeleri azaltır:

docker exec -it photoprism photoprism faces optimize

Tüm adımlar tamamlandıktan sonra People sayfasını yenileyin — eşleşmeler görünür hale gelecektir.

Etiketler Silinir Mi?

Hayır. Kişi isimleri veritabanında ayrı bir tabloda tutulur. Bu dört komutun hiçbiri mevcut isimleri veya etiketleri silmez.

Komut	Ne Yapar	Etiketlere Dokunur mu?
`faces audit --fix`	Bozuk verileri onarır	✅ Hayır
`faces index`	Yüzleri yeniden tarar	✅ Hayır
`faces update`	Kişilerle eşleştirir	✅ Hayır
`faces optimize`	Küme kalitesini artırır	✅ Hayır
`faces reset`	Kümeleri sıfırlar	⚠️ İsimleri korur, eşleştirmeleri siler

Sık Karşılaşılan Durumlar

İki Kişi Yanlışlıkla Birleştirildi

People sayfasında bir kişiye yanlışlıkla “Bu aynı kişi” derseniz ikisi birleşir. Geri almanın yolu:

Birleşmiş kişiyi açın
Her fotoğrafa girerek yanlış atanmış yüzleri Remove ile o kişiden ayırın
Ayrılmış yüzleri doğru kişiye atayın

Eşleştirme eşiğini daha katı hale getirmek için docker-compose.yml dosyanıza şunu ekleyin:

environment:
  PHOTOPRISM_FACE_DIST: "0.6"  # Varsayılan: 0.7 — düşürünce daha az yanlış birleştirme

Sonra container’ı yeniden başlatın:

docker compose down
docker compose up -d

Sildiğim Yüzler Geri Geliyor

faces index her çalıştırıldığında fotoğraflardaki tüm yüzleri yeniden tarar. PhotoPrism silinen kümeleri kalıcı olarak hatırlamadığı için bir sonraki taramada tekrar oluşturabilir. Hayvan yüzleri de bu şekilde geri gelebilir — mevcut versiyonda otomatik filtre yok.

“Ambiguous Subject” Uyarıları

faces: face JPAOZYV6... has ambiguous subject at dist 0.318367
faces: conflict resolution for <unknown> not successful

Bu uyarı birden fazla kişiye benzeyen bir yüz kümesi olduğunu gösterir. Kritik değildir — People sayfasından manuel düzeltebilirsiniz.

Performans İpuçları (Eski Donanım)

İşlemleri gece başlatın, gündüz dokunmayın
İndeksleme sırasında başka yoğun işlem çalıştırmayın
docker-compose.yml dosyasında bellek limiti varsa kaldırın ya da artırın
Birden fazla tur çalıştırın — her turda sistem biraz daha fazla yüz tanır
Mac Mini 2012 gibi kısıtlı donanımlarda sabırlı olun; faces index tek bir fotoğraf için 150–200ms harcayabilir

Sonuç

PhotoPrism’de yüz tanıma, Google Photos gibi tamamen otomatik çalışmıyor — ama doğru komutları çalıştırdıktan sonra bir kez isimlendirdiğiniz kişileri yeni fotoğraflarda kendisi buluyor. Düzenli indeksleme ve doğru etiketlemeyle kalite zamanla gözle görülür şekilde artıyor.