YOLO26 Modelleri için CoreML Dışa Aktarımı#

Apple, her modern iPhone, iPad ve Mac'te özel yapay zeka silikonu (Neural Engine) sunar ve CoreML, modelleri günümüzde buraya dağıtmak için Ultralytics tarafından desteklenen yoldur. Ultralytics YOLO26 modellerini CoreML'e dışarı aktarmak, eğitilmiş bir .pt kontrol noktasını, yedi YOLO görevini de ağ bağlantısı olmadan ve veriler cihazdan ayrılmadan düşük gecikmeyle cihaz üzerinde çalıştıran yerel bir .mlpackage dosyasına dönüştürür.

CoreML nedir?#

CoreML (Apple tarafından "Core ML" olarak adlandırılır), Apple'ın cihaz üzerinde makine öğrenimi çerçevesidir. Modelleri modern ML Program formatında (Ultralytics dışa aktarıcısının ürettiği .mlpackage paketi) yükler ve bunları cihazın CPU, GPU ve her Apple silikon çipindeki özel NPU olan Apple Neural Engine (ANE) üzerinde zamanlar. Her şey yerel olarak çalıştığı için çıkarım çevrimdışı çalışır, ağ gecikmesi eklemez ve kullanıcı verilerini cihazda tutar.

CoreML, modele giden yolda görüntü ölçeklendirmeyi ve yönlendirmeyi yöneten Apple'ın Vision çerçevesi ile doğrudan entegre olur; Ultralytics iOS SDK'sı kamera karelerini YOLO'ya etkili bir şekilde sıfır ön işleme maliyetiyle işte bu şekilde besler.

Neden YOLO26'yı CoreML'e Dışa Aktarmalısın?#

• Neural Engine hızı: CoreML, cihaz üzerinde düşük gecikmeli çıkarım için desteklenen işlemleri Apple'ın Neural Engine bileşeninde zamanlar. Aşağıdaki fiziksel cihaz tablosuna bakın ve tam dışarı aktarma işleminizi hedef donanımınızda kıyaslayın.
• Tasarım gereği NMS'siz: YOLO26 uçtan uca bir modeldir, bu nedenle dışarı aktarılan grafik NMS işlem hatlarına ihtiyaç duymaz ve kod çözme milisaniyenin altındadır. YOLO11 gibi eski algılama modelleri, nms=True ile bir CoreML NMS işlem hattı gömebilir.
• Gizli ve çevrimdışı: Tüm hesaplamalar cihazda kalır; bulut gidiş-dönüşleri yok, API anahtarları yok, tam veri gizliliği var.
• Tek dışa aktarım, tüm ekosistem: Aynı .mlpackage dosyası iOS, iPadOS, macOS, watchOS, tvOS ve visionOS üzerinde çalışır ve resmi Ultralytics iOS SDK ile Flutter eklentisine güç verir.

Ölçülen Performans#

12 GB belleğe ve iOS 26.5.2 sürümüne sahip bir iPhone 17 Pro üzerinde standartlaştırılmış v8.3.0 YOLO26n INT8 CoreML varlıkları için uçtan uca tekli görüntü çıkarımı. A19 Pro işlemcisi; 6 çekirdekli CPU (2 Performans ve 4 Verimlilik çekirdeği), Sinirsel Hızlandırıcılara sahip 6 çekirdekli GPU ve 16 çekirdekli Neural Engine barındırır. Her hücre, alt kısmındaki aşama bazlı dağılımla birlikte toplam süreyi (ön işleme + çıkarım + son işleme, notlandırma hariç) gösterir. iOS'ta Vision, giriş ölçeklendirmesini çıkarım isteği içinde gerçekleştirir, bu nedenle ön işleme 0 olarak bildirilir ve maliyeti çıkarım içine dahil edilir.

• Tam v8.3.0 sürüm varlıkları, sınıflandırma için 224×224 ve diğer tüm görevler için 640×640 girdiler bildirir.
• Hız değerleri tekli görüntü patlama gecikmeleridir; profil modundaki (optimize edilmiş yerel kod) Flutter eklentisinin kıyaslama test düzeneği aracılığıyla iOS SDK'sının aşama bazlı zamanlaması üzerinden ölçülen, bus.jpg üzerindeki 3 ısınma çalışmasının ardından gelen 15 çalışmanın ortalamasıdır. CPU/hızlandırıcı sırası, tek bir ardışık taramada görevler arasında değişti. CPU satırları Core ML .cpuOnly talep eder; CPU + ANE tercih edilen satırlar ise nihai işlem yerleşimi Core ML tarafından kontrol edilen .cpuAndNeuralEngine talep eder. Sürdürülebilir gerçek zamanlı kamera çalışması, yakalama ve ölçeklendirme boru hattını artı termal dengelemeyi içerdiği için daha yüksek çalışır. Standart öncesi tarihi bir kamera taraması, aynı cihazda YOLO26n nesne tespiti için 11,3 ms/kare ve YOLO26n Derinlik için 16,5 ms/kare ölçmüştür; kararlı durum profillemesi için iOS SDK performans belgesine bakın.
• Android CPU/GPU sonuçlarını LiteRT entegrasyonunda ve Snapdragon NPU sonuçlarını Qualcomm QNN entegrasyonunda karşılaştır.

Desteklenen Görevler#

CoreML dışa aktarımı, yedi Ultralytics görevinin tümünü destekler. Anlamsal segmentasyon ve derinlik tahmini yalnızca bu başlıklara sahip tek aile olan YOLO26 ile kullanılabilir.

YOLO26 Modellerini CoreML'e Dışa Aktarma#

Kurulum#

Gerekli paketi yüklemek için şunu çalıştır:

# Install the required package for YOLO26
pip install ultralytics

coremltools dönüştürücüsü ilk dışa aktarmada otomatik olarak yüklenir. Dışa aktarma macOS veya x86 Linux üzerinde çalışır; ayrıntılı talimatlar ve en iyi uygulamalar için kurulum kılavuzumuza ve Yaygın Sorunlar kılavuzuna göz at.

Kullanım#

CoreML formatı Dışa Aktarma (Export), Tahmin (Predict) ve Doğrulama (Validate) modlarını destekler. CoreML ile çıkarım ve doğrulama yalnızca macOS üzerinde çalışır. Modelini dışa aktar, ardından çıkarım çalıştırmak veya doğruluğunu doğrulamak için dışa aktarılan modeli yükle.

from ultralytics import YOLO

# Load a YOLO26 model
model = YOLO("yolo26n.pt")

# Export to CoreML with INT8 weight quantization, matching the official app models
model.export(format="coreml", quantize=8, imgsz=640)  # use imgsz=224 for classification

from ultralytics import YOLO

# Load the exported CoreML model (macOS)
model = YOLO("yolo26n.mlpackage")

# Run inference
results = model("https://ultralytics.com/images/bus.jpg")

from ultralytics import YOLO

# Load the exported CoreML model (macOS)
model = YOLO("yolo26n.mlpackage")

# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")

Dışa Aktarma Argümanları#

Dışa aktarım süreci hakkında daha fazla ayrıntı için Ultralytics documentation page on exporting sayfasını ziyaret edin.

Neural Engine'i Hedefleme#

CoreML, MLModelConfiguration.computeUnits aracılığıyla donanımı seçer. Ultralytics iOS SDK, iOS 16 ve sonraki sürümlerde .all yerine varsayılan olarak .cpuAndNeuralEngine kullanır: gerçek zamanlı bir kamera uygulamasında GPU, önizlemeyi ve kaplamaları birleştirmekle zaten meşguldür, bu nedenle bunu hariç tutmak, ANE ağır işleri yaparken çekişmeyi ve kare süresi titremesini önler. .cpuOnly değerini yalnızca uyumluluk testi için sabitleyin; yukarıdaki tablo bunun maliyetini gösterir.

Python'dan bir [Mac ana bilgisayarında](https://... veya benzeri durumlar hariç) bir CoreML modeli çalıştırmak (Ultralytics veya coremltools aracılığıyla) aynı kuralı izler: Ultralytics, çıkarımı Neural Engine üzerinde tutarak (CPU'dan ~3 kat daha hızlı) ComputeUnit.CPU_AND_NE ile yükler (macOS 13+; eski macOS sürümlerinde CPU_ONLY sürümüne geri döner). Bu aynı zamanda, GPU/MPSGraph derleme yolunu ekleyen varsayılan ComputeUnit.ALL / CPU_AND_GPU seçeneklerinin coremltools 9.x üzerinde bir Error: MLIR pass manager failed iddiasıyla işlemi sonlandırmasına neden olan mevcut bir macOS ana bilgisayar sınırlamasını da önler.

Dışa Aktarılan YOLO26 CoreML Modellerini Dağıtma#

En hızlı yol, resmi Ultralytics YOLO iOS SDK (Ultralytics iOS uygulamasına ve Flutter eklentisine güç veren aynı Swift paketi) kullanmaktır. Resmi model adlarını otomatik olarak çözümler, .mlpackage dosyasını indirir ve önbelleğe alır ve tamamen kodlanmamış sonuçlar döndürür:

import UltralyticsYOLO

// Loads the official INT8 model (downloaded and cached on first use), then runs inference
let yolo = YOLO("yolo26n", task: .detect) { result in
    if case .success(let model) = result {
        let results = model(uiImage)  // boxes, labels, confidences, timing
    }
}

Kamera uygulamaları için, yerel katmanlarla gerçek zamanlı çıkarım için SDK'nın YOLOView öğesini ekle veya Android ile tek bir kod tabanını paylaşan platformlar arası uygulamalar için Flutter eklentisini kullan.

Ham bir .mlpackage öğesini kendin entegre etmek de Apple'ın yığınıyla basittir; onu MLModel ile yükle, bir VNCoreMLRequest içine sar ve görüntüleri VNImageRequestHandler aracılığıyla besle. Bu kaynaklar ayrıntıları kapsar:

• Uygulamanıza Core ML Modeli Entegre Etme: Apple'ın bir CoreML modelini paketleme ve çağırma kılavuzu.
• CoreML Tools: Bu dışa aktarıma güç veren coremltools araç zinciri için dönüştürme, kantelleştirme ve optimizasyon referansı.
• Xcode Core ML Performans Raporları: Tam modelin ve cihazın için katman bazlı cihaz yerleşimi ve gecikme profili oluşturma.

Modeli ya uygulama paketinin içine gömülü olarak (anında kullanılabilirlik, nano/küçük modeller için ideal) ya da ilk çalıştırmada indirilen ve önbelleğe alınan (daha küçük ikili dosya, kolay model güncellemeleri) şekilde dağıtın. Resmi uygulamalar her iki yaklaşımı birleştirir: varsayılan nano modeller hemen kullanım için paketlenirken, daha büyük varyantlar talep üzerine indirilir ve yerel olarak önbelleğe alınır.

Önerilen İş Akışı#

1. Ultralytics Train modu ile modelini eğit veya resmi YOLO26 ağırlıklarıyla başla
2. macOS veya x86 Linux üzerinde model.export(format="coreml", quantize=8, imgsz=640) ile dışa aktar (sınıflandırma için imgsz=224 kullan)
3. Mac üzerinde model.val() ile doğruluğu doğrula ve hedef cihazında bir Xcode Core ML Performans Raporu ile profille
4. .cpuAndNeuralEngine hedefleyerek iOS SDK, Flutter eklentisi veya kendi Vision entegrasyonun ile dağıt

Özet#

Bu kılavuzda, Ultralytics YOLO26 modellerini CoreML'in .mlpackage formatına nasıl dışa aktaracağını, Apple Neural Engine için bunları nasıl kantelleştireceğini ve — resmi iOS SDK ve Flutter eklentisi veya kendi Vision entegrasyonun aracılığıyla — tek haneli milisaniye gecikmelerle nasıl dağıtacağını öğrendin. Diğer dağıtım hedefleri için entegrasyon kılavuzu sayfasına göz at ve Benchmark modu ile formatları karşılaştır.

SSS#