Link to this sectionIntegração do Apple Core AI#

Core AI é o novo framework da Apple para executar redes neurais diretamente no Apple silicon. Ele introduz o formato de modelo .aimodel, uma moderna API de inferência Swift, ferramentas de conversão baseadas em PyTorch, compilação antecipada, especialização de modelos e ferramentas dedicadas de depuração e análise.

A Apple descreve o Core AI como a próxima evolução da execução de IA no dispositivo e o framework de inferência por trás da Apple Intelligence no dispositivo. Ele foi projetado para as arquiteturas de rede neural atuais, desde modelos de visão compactos até grandes modelos generativos, e pode agendar tarefas através da CPU, GPU e Apple Neural Engine (ANE).

O Core AI é um novo caminho de implementação em vez de apenas um novo nome para o Core ML. Os frameworks utilizam diferentes formatos de modelo, ferramentas de conversão, APIs de runtime e padrões de integração de aplicações.

Link to this sectionComparação entre Core AI e Core ML#

O Core ML continua sendo a escolha apropriada quando uma aplicação precisa de ampla cobertura de dispositivos, integração com o framework Vision ou tipos de modelo como árvores de decisão e pipelines tabulares. A Apple continua a suportar o Core ML e direciona desenvolvedores com tipos de modelos não neurais para ele.

Link to this sectionComo funciona o formato Core AI#

O fluxo de trabalho de criação do Core AI começa a partir de um modelo PyTorch:

PyTorch model
    ↓ torch.export
ExportedProgram
    ↓ coreai-torch
Core AI program
    ↓ optimize and save
.aimodel
    ↓ specialize or compile ahead of time
Apple silicon executable

O pacote coreai-torch da Apple converte um torch.export.ExportedProgram reduzindo as operações ATen do PyTorch para operações Core AI. Operações não suportadas podem ser implementadas com um lowering customizado ou um kernel Metal customizado.

O .aimodel resultante é um ativo de modelo não especializado. Quando uma aplicação prepara o modelo, o Core AI especializa-o para o dispositivo alvo. As aplicações podem deixar isso acontecer no primeiro uso, solicitar a especialização mais cedo ou enviar um modelo compilado antecipadamente para reduzir o tempo inicial de carregamento.

Em Swift, as aplicações carregam o ativo com o framework Core AI, selecionam uma função de inferência, fornecem entradas NDArray tipadas e recebem saídas nomeadas. Isso é diferente de envolver um modelo Core ML em uma solicitação Vision, portanto, adotar o Core AI requer um runtime de aplicação projetado para ativos .aimodel.

Para detalhes de implementação, veja a documentação da Apple para AIModel, especialização e cache de modelos e compilação antecipada de modelos.

Link to this sectionUso futuro do Ultralytics#

Após o lançamento da integração planejada, espera-se que a API Python exporte um modelo YOLO26 para .aimodel com um valor de formato dedicado:

from ultralytics import YOLO

model = YOLO("yolo26n.pt")
model.export(format="coreai")  # Planned: creates yolo26n.aimodel

O comando CLI planejado equivalente é:

yolo export model=yolo26n.pt format=coreai # Planned: not yet available

Os argumentos finais, tarefas YOLO suportadas, opções de precisão e comportamento de forma dinâmica serão documentados em Modo de exportação após o exportador ser implementado e validado.

No iOS 27 ou macOS 27, uma aplicação carregaria e executaria o ativo exportado através da API Swift Core AI da Apple. Os nomes de funções e tensores abaixo são ilustrativos; o contrato de saída suportado pelo Ultralytics será publicado com o exportador:

import CoreAI

let modelURL = Bundle.main.url(forResource: "yolo26n", withExtension: "aimodel")!
let model = try await AIModel(contentsOf: modelURL)
guard let function = try model.loadFunction(named: "main") else {
    throw AppError.missingInferenceFunction
}

let outputs = try await function.run(inputs: ["image": imageTensor])

Ao contrário do atual fluxo de trabalho Core ML e Vision, o futuro caminho do Core AI precisará definir pré-processamento de imagem, construção de NDArray, metadados de modelo e decodificação de saída no SDK iOS do Ultralytics. A Apple fornece detalhes da API atual na documentação do framework Core AI e exemplos de modelos funcionais no repositório de modelos Core AI.

Link to this sectionVantagens do Core AI#

O Core AI oferece várias vantagens promissoras para futuras implementações do Ultralytics:

• Caminho moderno de exportação PyTorch: A conversão começa a partir de torch.export, preservando um grafo PyTorch mais expressivo do que o fluxo de trabalho de rastreamento usado por muitos exportadores existentes.
• Controle de runtime detalhado: As aplicações podem gerenciar especialização, caches de modelos compilados, funções de inferência, memória e posicionamento de computação.
• Suporte avançado a modelos: Execução com estado, formas dinâmicas, múltiplas funções em um artefato e kernels Metal customizados são projetados para arquiteturas modernas de visão e generativas.
• Ferramentas dedicadas para desenvolvedores: O Core AI Debugger pode inspecionar grafos e valores de tensores e rastreá-los de volta ao código Python original. O Xcode e o Instruments fornecem análise de runtime.
• Oportunidades de cópia zero: O Core AI expõe controles de armazenamento e buffer destinados a reduzir cópias entre a câmera, gráficos e cargas de trabalho de inferência.
• Otimização para Apple silicon: A especialização do dispositivo permite que a Apple otimize um modelo para a CPU, GPU e Neural Engine disponíveis no dispositivo específico.
• Compressão flexível: As ferramentas de otimização Core AI da Apple suportam quantização, paletização e poda, incluindo formatos de peso de baixa precisão (low-bit).

Essas capacidades podem ser particularmente úteis para futuros modelos YOLO com execução dinâmica, componentes multimodais maiores ou operações customizadas que não mapeiam claramente para as operações existentes do Core ML.

Link to this sectionDesvantagens e limitações atuais#

O Core AI não é atualmente um substituto para o caminho de produção do Core ML:

• Novos sistemas operacionais necessários: O framework público tem como alvo a geração iOS 27 e macOS 27, enquanto o Core ML suporta uma base instalada muito maior.
• Software Beta: O framework Core AI da Apple e partes de sua cadeia de ferramentas Python ainda são preliminares e podem mudar antes de seus lançamentos estáveis.
• Ambiente de exportação mais restrito: O coreai-torch requer atualmente Python 3.11 ou mais recente e versões recentes do PyTorch, o que é muito mais restrito do que o alcance de Python e PyTorch suportado pelo Ultralytics.
• Nenhum comando Ultralytics atual: yolo export format=coreai não é implementado, testado ou coberto pelas garantias de compatibilidade do Ultralytics.
• Nenhum runtime de aplicação Ultralytics ainda: O aplicativo oficial YOLO iOS e o plugin Flutter carregam atualmente artefatos Core ML através de MLModel e Vision.
• Migração de aplicação necessária: Um .aimodel não pode ser substituído por um .mlpackage; o carregamento do modelo, pré-processamento, chamadas de inferência, gerenciamento de metadados e decodificação de saída precisam de uma implementação Core AI.
• Evidência de produção limitada: Desempenho, uso de energia, tempo de especialização na primeira execução, precisão e compressão precisam de validação em toda a matriz de tarefas YOLO e dispositivos suportados.
• Nenhum pipeline NMS legado estabelecido: O Core ML pode empacotar um estágio NMS para modelos de detecção YOLO mais antigos. Espera-se que a primeira integração do Core AI foque em modelos YOLO26 sem NMS.

Link to this sectionQual formato da Apple você deve usar?#

Use Core ML hoje quando você precisar de:

• Um comando de exportação Ultralytics suportado
• Implementação em sistemas operacionais Apple atuais e antigos
• Integração com o SDK Ultralytics para iOS ou Flutter
• Tratamento de imagem pelo framework Vision
• Implementação YOLO testada em FP16 e INT8
• NMS embutido para modelos de detecção legados compatíveis

Avalie o Core AI no futuro quando puder exigir o iOS 27 ou macOS 27 e precisar de:

• O mais novo runtime de rede neural da Apple no dispositivo
• Especialização explícita e gerenciamento de cache
• Execução avançada de modelos dinâmicos ou com estado
• Operações Core AI customizadas ou kernels Metal
• Depuração detalhada de grafos Core AI e análise de runtime

Espera-se que o Core ML e o Core AI coexistam enquanto as aplicações fazem a transição. Suportar o Core AI não remove imediatamente a necessidade do Core ML, pois seus alvos de implementação e contratos de aplicação diferem.

Link to this sectionRoadmap do Ultralytics#

O Ultralytics planeja avaliar um alvo de exportação coreai dedicado no Q4 de 2026, após o iOS 27 e o macOS 27 estarem geralmente disponíveis. Espera-se que o trabalho inicial foque em modelos YOLO26 sem NMS e no formato .aimodel, enquanto retém o Core ML para alvos de implementação Apple estabelecidos.

Antes que o Core AI possa se tornar um formato de exportação suportado, a integração precisa de:

1. Exportação e validação numérica em detecção, segmentação de instância, segmentação semântica, classificação, pose e caixas delimitadoras orientadas.
2. Testes de precisão em FP16 e quantizados em relação às linhas de base do PyTorch e Core ML.
3. Benchmarks de latência, memória, energia e especialização no dispositivo.
4. Carregamento e pré-processamento de modelos Core AI no SDK iOS do Ultralytics.
5. Integração com Flutter e uma estratégia de compatibilidade para dispositivos abaixo do iOS 27.
6. Lançamentos estáveis do framework Apple e das ferramentas de conversão.

Siga o roadmap do Ultralytics e as notas de lançamento para verificar a disponibilidade. Até que o suporte seja lançado, comandos ou patches de terceiros que produzem arquivos .aimodel são experimentais e estão fora da matriz de exportação suportada pelo Ultralytics.

Link to this sectionRecursos adicionais#

• Visão geral do Apple Core AI
• Documentação do framework Core AI
• Extensões PyTorch para Core AI
• Otimização para Core AI
• Repositório de modelos Apple Core AI
• Integração Ultralytics com Core ML

Link to this sectionFAQ#

Link to this sectionO Ultralytics consegue exportar modelos YOLO para .aimodel atualmente?#

Não. O Ultralytics suporta atualmente o formato .mlpackage do Core ML da Apple através de model.export(format="coreml"). Um destino de exportação nativo para Core AI está planejado, mas ainda não faz parte do exportador suportado.

Link to this sectionO Core AI substituirá o Core ML?#

Não imediatamente. O Core AI é o caminho mais recente da Apple para redes neurais modernas, enquanto o Core ML continua sendo suportado e oferece uma cobertura mais ampla do sistema operacional, integração com Vision e suporte a modelos não neurais.

Link to this sectionPosso renomear um .mlpackage para .aimodel?#

Não. Eles contêm representações de modelo diferentes e são carregados por frameworks diferentes. A conversão deve começar a partir do modelo de origem por meio da cadeia de ferramentas apropriada da Apple.

Link to this sectionA integração do Ultralytics com Core AI substituirá format=coreml?#

Espera-se que a integração inicial coexista com o Core ML. Qualquer decisão de substituição futura dependerá da adoção pelo sistema operacional, estabilidade das ferramentas, desempenho e suporte subsequente para iOS e Flutter.