Link to this sectionYOLO26 Modelleri için CoreML Dışa Aktarımı#

Apple, her modern iPhone, iPad ve Mac'te özel bir yapay zeka silikonu olan Neural Engine'i sunar ve CoreML bunu programlamanın tek yoludur. Ultralytics YOLO26 modellerini CoreML'e dışa aktarmak, eğitilmiş bir .pt kontrol noktasını, altı YOLO görevini de cihaz üzerinde tek haneli milisaniyelerle çalıştıran, ağ bağlantısı gerektirmeyen ve cihazdan hiçbir veri çıkışı olmayan yerel bir .mlpackage dosyasına dönüştürür.

Link to this sectionCoreML nedir?#

CoreML (Apple tarafından "Core ML" olarak yazılır), Apple'ın cihaz üzerinde çalışan makine öğrenimi çerçevesidir. Modelleri, Ultralytics dışa aktarıcısının ürettiği .mlpackage paketi olan modern ML Program formatında 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ışı gerçekleşir, 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ının kamera karelerini YOLO'ya neredeyse sıfır ön işleme maliyetiyle beslemesinin yolu budur.

Link to this sectionNeden YOLO26'yı CoreML'e Dışa Aktarmalısın?#

• Neural Engine hızı: YOLO26n tespiti, tek görüntüler için bir iPhone 17 Pro'da uçtan uca 3,8 ms'de ve sürekli gerçek zamanlı kamera kullanımında kare başına ~16 ms'de çalışır (aşağıdaki tabloya ve notlara bak); bu, uygulamanın geri kalanı için alan bırakacak şekilde rahatlıkla gerçek zamanlıdır.
• Tasarımı gereği NMS içermez: YOLO26 uçtan uca yapıdadır, bu nedenle dışa aktarılan grafiğin NMS işlem hattına ihtiyacı yoktur ve kod çözme işlemi milisaniyenin altındadır. YOLO11 gibi eski modeller nms=True parametresi ile CoreML NMS işlem hattını gömebilir.
• Özel ve çevrimdışı: Tüm hesaplamalar cihazda kalır; buluta gidiş-dönüş yok, API anahtarı yok, tam veri gizliliği var.
• Tek dışa aktarım, tüm ekosistem: Aynı .mlpackage iOS, iPadOS, macOS, watchOS, tvOS ve visionOS üzerinde çalışır ve resmi Ultralytics iOS SDK ile Flutter eklentisine güç verir.

Link to this sectionÖlçülen Performans#

Bir iPhone 17 Pro'da (Apple A19, iOS 26.5) resmi YOLO26n INT8 CoreML modelleri için uçtan uca tek görüntü çıkarımı. Her hücre, altında aşama bazlı ayrımıyla birlikte toplam süreyi (ön işleme + çıkarım + son işleme, açıklama hariç) gösterir. iOS'ta Vision, giriş ölçeklendirmesini çıkarım isteği içinde gerçekleştirdiğinden, ön işleme 0 olarak raporlanır ve maliyeti çıkarıma dahildir.

• ¹ Anlamsal CoreML dışa aktarımları, ArgMax değerini grafiğe gömer ve float logit'ler yerine kompakt, tam çözünürlüklü bir sınıf haritası ([1, 1024, 1024]) döndürür; bu sayede işlem sonrası aşaması milisaniyenin altında bir renk taramasıdır ve maskeler piksel keskinliğinde render edilir.
• Hız değerleri tek görüntülü ani gecikmelerdir — bus.jpg üzerinde 3 ısınma çalıştırmasından sonra yapılan 15 çalıştırmanın ortalamasıdır; iOS SDK'nın sahne bazlı zamanlaması üzerinden Flutter eklentisinin profil modundaki (optimize edilmiş yerel kod) kıyaslama aracıyla ölçülmüştür. Kesintisiz gerçek zamanlı kamera çalışması daha yüksek değerlerde seyreder (her karede tam sensör letterboxing ve termal dengeleme): YOLO26n tespiti, aynı cihazdaki canlı kamera uygulamasında ~16 ms/kare ölçülür — kararlı durum profillemesi için iOS SDK performans belgesine bakabilirsin.
• Eşleşen Snapdragon CPU/GPU/NPU tablosu Qualcomm QNN entegrasyonunda mevcuttur.

Link to this sectionYOLO26 Modellerini CoreML'e Dışa Aktarma#

Link to this sectionKurulum#

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 kurulur. Dışa aktarma macOS veya x86 Linux üzerinde çalışır; ayrıntılı talimatlar ve en iyi uygulamalar için kurulum rehberimize ve Sık Karşılaşılan Sorunlar rehberine göz at.

Link to this sectionKullanım#

CoreML formatı Dışa Aktarma, Tahmin ve Doğrulama modlarını destekler. CoreML ile çıkarım ve doğrulama yalnızca macOS üzerinde çalışır. Modelini dışa aktar, ardından çıkarım yapmak veya doğruluğunu kontrol etmek için dışa aktarılan modeli yükle.

from ultralytics import YOLO

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

# Export to CoreML (FP16 by default); quantize=8 matches the official app models
model.export(format="coreml", quantize=8)  # creates 'yolo26n.mlpackage'

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")

Link to this sectionDışa Aktarma Argümanları#

Dışa aktarma süreci hakkında daha fazla ayrıntı için dışa aktarma hakkındaki Ultralytics dokümantasyon sayfasına git.

Link to this sectionNeural Engine'i Hedefleme#

CoreML chooses hardware via MLModelConfiguration.computeUnits. The Ultralytics iOS SDK defaults to .cpuAndNeuralEngine on iOS 16+ rather than .all: in a real-time camera app the GPU is already busy compositing the preview and overlays, so excluding it avoids contention and frame-time jitter while the ANE does the heavy lifting. Pin .cpuOnly only for compatibility testing — the table above shows what it costs.

Running a CoreML model from Python on a Mac host (via Ultralytics or coremltools) follows the same rule: Ultralytics loads with ComputeUnit.CPU_AND_NE (macOS 13+, falling back to CPU_ONLY on older macOS), keeping inference on the Neural Engine (~3× faster than CPU). This also avoids a current macOS host limitation where the default ComputeUnit.ALL / CPU_AND_GPU — which add the GPU/MPSGraph compile path — abort the process with an Error: MLIR pass manager failed assertion on coremltools 9.x.

Link to this sectionDışa Aktarılan YOLO26 CoreML Modellerini Dağıtma#

En hızlı yol resmi Ultralytics YOLO iOS SDK kullanmaktır; bu, Ultralytics iOS uygulamasını ve Flutter eklentisini destekleyen aynı Swift paketidir. Resmi model adlarını otomatik olarak çözer, .mlpackage dosyasını indirip önbelleğe alır ve tamamen çözülmüş 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 bindirmelerle gerçek zamanlı çıkarım için SDK'nın YOLOView öğesini kullan veya Android ile tek bir kod tabanını paylaşan platformlar arası uygulamalar için Flutter eklentisini kullan.

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

• Bir Core ML Modelini Uygulamana Entegre Etme: Apple'ın bir CoreML modelini paketleme ve çağırma rehberi.
• CoreML Tools: Bu dışa aktarmaya güç veren coremltools araç zinciri için dönüştürme, kuantizasyon 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 paketine gömülü (anında kullanılabilirlik, nano/küçük modeller için ideal) ya da ilk çalıştırmada indirilip önbelleğe alınmış (daha küçük ikili dosya, kolay model güncellemeleri) şekilde gönder; resmi uygulamalar GitHub sürüm varlıklarıyla ikinci yaklaşımı kullanır.

Link to this sectionÖnerilen İş Akışı#

1. Modelini Ultralytics Eğitim modu ile eğit veya resmi YOLO26 ağırlıklarıyla başla.
2. macOS veya x86 Linux üzerinde model.export(format="coreml", quantize=8) ile dışa aktar
3. Mac üzerinde model.val() ile doğruluğu doğrula ve hedef cihazında bir Xcode Core ML Performans Raporu ile profil oluştur.
4. iOS SDK, Flutter eklentisi veya kendi Vision entegrasyonunla, .cpuAndNeuralEngine hedefleyerek dağıt.

Link to this sectionÖzet#

Bu rehberde, Ultralytics YOLO26 modellerini CoreML'in .mlpackage formatına nasıl aktaracağını, Apple Neural Engine için nasıl kuantize edeceğini ve bunları tek haneli milisaniye gecikmeleriyle nasıl dağıtacağını öğrendin; ister resmi iOS SDK ve Flutter eklentisi aracılığıyla ister kendi Vision entegrasyonunla. Diğer dağıtım hedefleri için entegrasyon rehberi sayfasına göz at ve Benchmark modu ile formatları karşılaştır.

Link to this sectionSSS#

Link to this sectionYOLO26 modellerini CoreML formatına nasıl aktarırım?#

Python'da model.export(format="coreml") komutunu veya macOS ya da x86 Linux'ta CLI üzerinden yolo export model=yolo26n.pt format=coreml komutunu çalıştır. Resmi uygulama modelleriyle eşleşmesi için quantize=8 ekle. Dışa aktarma işlemi, Xcode, iOS SDK veya Flutter eklentisi için hazır olan bir yolo26n.mlpackage ML Programı üretir.

Link to this sectionYOLO26'yı dışa aktarırken nms=True kullanmam gerekir mi?#

Hayır. YOLO26 uçtan uca NMS'sizdir, bu nedenle dışa aktarılan grafik zaten nihai tespitleri yayar ve kod çözme maliyeti bir milisaniyenin çok altındadır. nms=True seçeneği, uygulamanın bastırma işlemini uygulamak zorunda kalmaması için bir CoreML NMS hattının gömüldüğü YOLO11 gibi önceki modeller için mevcuttur.

Link to this sectionHangi hassasiyeti kullanmalıyım — FP16 mı yoksa INT8 mi?#

Resmi Ultralytics uygulama modelleri INT8 olarak sunulur; bu, indirme boyutunu minimize eder ve yukarıdaki tablodaki hızlarda çalışır. quantize=16 (FP16), neredeyse hiç doğruluk kaybı olmayan tutarlı bir alternatiftir. Göndermeden önce Mac üzerinde model.val() ile tam dışa aktarımını doğrula.

Link to this sectionÇıkarımın Neural Engine üzerinde çalıştığından nasıl emin olurum?#

MLModelConfiguration.computeUnits = .cpuAndNeuralEngine (iOS 16+'da iOS SDK varsayılanı) olarak ayarla. Kamera uygulamalarında .all kullanmaktan kaçın; GPU önizlemeyi oluşturmakla meşguldür ve çıkarımı orada zamanlamak kare süresi titremesine neden olur. Yerleşimi bir Xcode Core ML Performans Raporu ile onayla.

Link to this sectionCoreML modellerini Ultralytics CLI ile çalıştırıp doğrulayabilir miyim?#

Evet, macOS üzerinde: yolo predict model=yolo26n.mlpackage source=image.jpg ve yolo val model=yolo26n.mlpackage data=coco8.yaml diğer tüm formatlar gibi çalışır. CoreML yürütme Apple donanımı gerektirir, bu nedenle bu modlar Linux ve Windows'ta kullanılamaz.

Link to this sectionYOLO26'yı bir iOS veya Flutter uygulamasında çalıştırmanın en hızlı yolu nedir?#

Resmi Ultralytics YOLO iOS SDK (Swift Paketi) veya Flutter eklentisini kullan. Her ikisi de resmi modelleri isme göre yükler, otomatik olarak indirip önbelleğe alır, Neural Engine üzerinde çalıştırır ve eksiksiz gerçek zamanlı kamera kullanıcı arayüzlerini içerir; yukarıdaki ölçülen performans tablosu tam olarak bu yığınla üretilmiştir.