Modelos Core AI de Apple: Recetas de exportación, primitivas de Python y runtime Swift para IA en el dispositivo
Explora el repositorio Core AI Models de Apple: recetas de exportación para modelos populares, primitivas de autoría en Python y un runtime Swift para implementar IA en macOS y iOS.
Apple ha lanzado como código abierto el repositorio Core AI Models, un conjunto completo de herramientas para construir e implementar IA en el dispositivo en plataformas Apple. Este repositorio proporciona recetas de exportación de modelos, primitivas de Python para crear modelos personalizados y un runtime Swift para integrar IA en aplicaciones de macOS y iOS. Está diseñado para cerrar la brecha entre el desarrollo de modelos PyTorch y la implementación en producción en silicio de Apple.
Qué hay dentro del repositorio
El repositorio está organizado en cuatro directorios principales:
models/: Un catálogo de modelos con archivos README y recetas de exportación para convertir modelos populares de código abierto (de Hugging Face y otras fuentes) al formato Core AI (archivos.aimodel).python/: Primitivas de Python para crear modelos Core AI personalizados en PyTorch, además de utilidades para exportarlos.swift/: Un paquete Swift (coreai-models) que proporciona utilidades de runtime para ejecutar modelos Core AI en tu aplicación en macOS y iOS.skills/: Habilidades conectables para agentes de codificación (como Claude Code, Codex CLI, Gemini CLI) para aprovechar Core AI de manera más efectiva.
Requisitos y configuración
Para exportación de modelos
Necesitas instalar uv (un gestor de paquetes Python rápido):
brew install uv
O mediante el instalador oficial:
curl -LsSf https://astral.sh/uv/install.sh | sh
Una vez instalado, clona el repositorio y explora los modelos disponibles:
git clone https://github.com/apple/coreai-models.git
cd coreai-models
uv run coreai.model.registry --list-models
Usa uv run coreai.model.registry --help para más detalles.
Para ejecutar modelos en aplicaciones
- macOS y iOS 27.0+
- Xcode 27.0+
Los modelos Core AI se exportan como archivos .aimodel independientes. Algunos modelos (como modelos de lenguaje o modelos de difusión) requieren recursos adicionales (por ejemplo, tokenizadores, múltiples modelos en un pipeline). En estos casos, las recetas de exportación producen una carpeta de recursos que contiene uno o más archivos .aimodel junto con los recursos necesarios. El paquete Swift proporciona utilidades de runtime para integrarlos en una aplicación.
También se incluyen herramientas CLI para ejecutar modelos exportados directamente en un Mac (requiere Xcode 27.0+). Consulta el README de cada modelo para conocer las herramientas disponibles y ejemplos de invocación.
Habilidades de agente para agentes de codificación
El repositorio incluye un plugin con habilidades que permiten a los agentes de codificación usar Core AI como un experto. Hay tres habilidades disponibles:
| Habilidad | Descripción |
|---|---|
working-with-coreai |
Flujo de trabajo completo para implementar modelos PyTorch en silicio de Apple, cubriendo exportación con coreai-torch y ejecución con el runtime Core AI. |
model-authoring |
Reglas empíricas para crear modelos PyTorch para ejecución en el dispositivo en plataformas Apple, cubriendo diseño BC1S, compatibilidad de operaciones, patrones de KV cache, reglas de precisión, MoE y problemas comunes. |
model-compression-exploration |
Explorar sistemáticamente configuraciones de compresión de pesos (cuantización y paletización) para un modelo PyTorch usando coreai-opt. |
Instalación para diferentes agentes de codificación
Claude Code:
/plugin marketplace add [email protected]:apple/coreai-models.git
/plugin install coreai-skills@coreai-models
Codex CLI:
codex plugin marketplace add https://github.com/apple/coreai-models
codex plugin add coreai-skills@coreai-models
Gemini CLI:
gemini extensions install /path/to/coreai-models/skills
Una vez instaladas, las habilidades se activan automáticamente según el contexto de tu tarea, o puedes invocarlas explícitamente.
Por qué esto es importante para los desarrolladores
La IA en el dispositivo ofrece varias ventajas sobre las soluciones en la nube: menor latencia, capacidad sin conexión, mejor privacidad (los datos permanecen en el dispositivo) y costos de servidor reducidos. El framework Core AI de Apple proporciona el runtime, pero hasta ahora no había un camino claro para convertir modelos populares de código abierto al formato .aimodel. Este repositorio llena ese vacío con recetas de exportación probadas y primitivas reutilizables.
Las primitivas de Python en el directorio python/ te permiten crear modelos personalizados en PyTorch que sean compatibles con las restricciones de Core AI (por ejemplo, diseño BC1S, soporte de operaciones específicas). El paquete Swift luego facilita cargar y ejecutar esos modelos en tu aplicación con un mínimo de código repetitivo.
Limitaciones actuales y participación de la comunidad
Apple no está aceptando contribuciones de código en este momento. El proyecto se centra en mantener una galería curada y bien probada de modelos y un paquete Swift confiable. Las solicitudes de extracción serán cerradas. Sin embargo, los Issues de GitHub están abiertos para:
- Informes de errores
- Solicitudes de modelos
- Solicitudes de funciones para el flujo de trabajo o las utilidades Swift
Esta es una decisión de alcance deliberada para el lanzamiento inicial, permitiendo a Apple aprender cómo la comunidad usa el proyecto antes de abrir las contribuciones.
Licencia
El proyecto está licenciado bajo la Licencia BSD 3-Cláusulas.
Primeros pasos
- Clona el repositorio:
git clone https://github.com/apple/coreai-models.git - Instala
uvy explora el registro de modelos:uv run coreai.model.registry --list-models - Elige un modelo del directorio
models/y sigue su README para las instrucciones de exportación. - Integra el archivo
.aimodelexportado en tu aplicación usando el paquete Swift.
Para más detalles, visita el repositorio oficial.