Qué hace Apfel

Apfel es una herramienta gratuita que te da acceso directo al LLM que Apple incluye con macOS 26 (Tahoe) en Macs con Apple Silicon. Normalmente Apple restringe este modelo a Siri y funciones del sistema, pero Apfel lo expone a través de tres interfaces: una herramienta de línea de comandos UNIX, un servidor HTTP compatible con OpenAI y un chat interactivo.

Detalles técnicos

La herramienta está construida en Swift 6.3 y envuelve el framework FoundationModels de Apple, específicamente la API LanguageModelSession. Toda la inferencia se ejecuta en el Neural Engine y GPU: sin llamadas de red, sin nube y nada sale de tu máquina.

Especificaciones clave de la fuente:

• Versión: v0.6.13
• Requisitos: macOS 26+ (Tahoe), Apple Silicon, Apple Intelligence habilitado
• Ventana de contexto: 4,096 tokens (entrada y salida combinados)
• Licencia: MIT
• Instalación: brew install Arthur-Ficial/tap/apfel

Tres modos de uso

1. Herramienta CLI

Herramienta UNIX compatible con tuberías con soporte stdin/stdout, salida JSON, archivos adjuntos y códigos de salida apropiados:

$ apfel "¿Cuál es la capital de Austria?"
La capital de Austria es Viena.

$ apfel -o json "Traduce al alemán: hola" | jq .content
"Hallo"

2. Servidor compatible con OpenAI

Sustituto directo en localhost:11434 que funciona con cualquier SDK de OpenAI:

$ apfel --serve
Servidor ejecutándose en http://127.0.0.1:11434

cualquier cliente OpenAI funciona
$ curl localhost:11434/v1/chat/completions

Soporta streaming (SSE), llamadas a herramientas, CORS, formatos de respuesta, temperatura, max_tokens y parámetros seed.

3. Chat interactivo

Conversaciones de múltiples turnos con gestión automática de contexto y cinco estrategias de recorte:

$ apfel --chat -s "Eres un asistente de programación"
Chat iniciado. Escribe /quit para salir.
> ¿Cómo invierto una lista en Python?

Qué añade Apfel sobre la API cruda de Apple

• Códigos de salida apropiados para scripts de shell
• Formato de salida JSON
• Soporte para archivos adjuntos
• Cinco estrategias de recorte de contexto para la ventana de 4,096 tokens
• Conteo real de tokens a través del SDK
• Conversión de esquemas de herramientas OpenAI al formato nativo Transcript.ToolDefinition de Apple

Herramientas potentes incluidas

La carpeta demo/ incluye varios scripts de shell:

• cmd: Conversión de lenguaje natural a comandos de shell
• oneliner: Genera cadenas de tuberías a partir de inglés simple
• mac-narrator: Narra la actividad del sistema como un documental de naturaleza
• explain: Explica comandos, mensajes de error o fragmentos de código
• wtd: Orientación instantánea de proyectos para cualquier base de código
• gitsum: Resume commits recientes de git

Para quién es esto

Desarrolladores que quieren experimentar con el LLM en dispositivo de Apple sin escribir aplicaciones Swift o pagar por llamadas a API en la nube.