apfel es un proyecto de .

Tutorial · probado el 15 de noviembre de 2026

Tutorial de apfel AI

Tu primera respuesta de la IA que ya tienes en tu Mac en 60 segundos. Después, 11 tareas que hace bien, cada una lista para copiar y pegar con la salida real, y una lista honesta de lo que no puede hacer.

Grabación real del terminal, sin editar: apfel 1.18.0 en macOS 27.0.1, MacBook Air M2.
En esta página: 15 secciones
  1. Tu primera respuesta en 60 segundos
  2. 1. Pregúntale a tu Mac sobre sí mismo
  3. 2. Corrige cualquier texto que hayas copiado
  4. 3. Lee tickets, PDF y scripts
  5. 4. Convierte lenguaje corriente en un comando de shell
  6. 5. JSON en el que tus scripts pueden confiar
  7. 6. Automatiza tu día: git, voz y scripts listos para usar
  8. 7. Ejecuta tu código de OpenAI gratis
  9. 8. Dale herramientas con MCP
  10. 9. Chatea para probar un prompt
  11. 10. Deja el servidor en marcha en segundo plano
  12. 11. Apps basadas en apfel
  13. Límites y respuestas honestas
  14. Cuando algo falla
  15. Quién hizo esto y cómo se probó

Tu primera respuesta en 60 segundos

Necesitas un Mac con Apple Silicon (M1 o posterior) con macOS 26 Tahoe o posterior, y Apple Intelligence activado en Ajustes del Sistema > Apple Intelligence y Siri. Comprueba los dos primeros requisitos con una sola línea:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Si la versión es 26 o superior y ves arm64, todo está listo. Instala apfel con Homebrew. Sin Xcode, sin cuenta, sin API key:

Terminal
brew install apfel

Haz tu primera pregunta:

Terminal
apfel "In one sentence: what can a small on-device language model do for me?"
A small on-device language model can help you perform tasks like text translation, summarization, and data analysis directly on your device.

Esa respuesta la ha dado el modelo de Apple en tu Mac. No se ha enviado nada a ningún servidor y no te ha costado nada.

Si falla: pregúntale a apfel si el modelo está listo:

Terminal
apfel --model-info | grep -E 'available|context'
├ available:  yes
├ context:    4096 tokens

Si dice available: no, activa Apple Intelligence en Ajustes del Sistema y espera a que el modelo termine de descargarse (según la guía de instalación, ocupa de 3 a 4 GB). El idioma de tu Mac y el de Siri tienen que ser el mismo, y debe ser un idioma compatible. Mientras el modelo no está disponible, apfel termina con el código de salida 5.

Siguiente paso: las tareas de abajo. Cada una empieza con lo que tendrás al cabo de dos minutos.

1. Pregúntale a tu Mac sobre sí mismo

En 2 minutos tienes: respuestas en lenguaje claro sobre tu disco, tu CPU y tu memoria, sacadas directamente de los comandos que ya conoces.

Cuando un comando del terminal me suelta un muro de números, quiero una respuesta de una línea, para poder actuar sin tener que leerme una página man.

Pasa cualquier comando a apfel con un pipe y di qué quieres saber:

Terminal
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
Terminal
ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU, one sentence"
`/System/Library/CoreServices/RemoteManagement/screensharingd.bundle/Contents/MacOS/screensharingd` is using the most CPU.

Mantén la entrada pequeña: primero head, awk y grep, y después apfel. El modelo solo lee unos pocos miles de palabras a la vez, y menos si es código (consulta los límites).

Si falla: algunos comandos escriben en stderr, y eso no pasa por el pipe. apfel te lo avisa: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Siguiente paso: el mismo truco sirve para git log, lsof, pmset -g batt, archivos de log y cualquier otra cosa que imprima texto.

2. Corrige cualquier texto que hayas copiado

En 2 minutos tienes: un comando que corrige la gramática de lo que haya en tu portapapeles, en cualquier app.

Cuando escribo un mensaje rápido en Slack, Mail o el navegador, quiero dejarlo limpio sin abrir otra app, para poder pegarlo de vuelta en segundos.

Copia algo de texto y ejecuta la línea del medio. pbpaste lee el portapapeles y pbcopy devuelve el resultado al portapapeles:

Terminal
printf 'can u send me the slides from yesterdays meeting i lost them' | pbcopy
pbpaste | apfel "Rewrite the text above with correct grammar and spelling. Reply with the rewritten text only." | pbcopy
pbpaste
Can you send me the slides from yesterday’s meeting? I lost them.

Por qué "the text above" ("el texto de arriba"): apfel coloca primero el texto del pipe y después tu instrucción (código fuente). Con la instrucción corta "fix grammar and spelling, reply with the corrected text only", el modelo respondió al mensaje en vez de corregirlo y contestó Could you let me know which meeting you're referring to?. En nuestra prueba, nombrar el texto sobre el que debe trabajar lo solucionó.

Si falla: lee el resultado antes de enviarlo. Un modelo pequeño a veces cambia el sentido: cuando le pedimos que tradujera esta frase al alemán, convirtió "Can you send me" ("¿me puedes enviar?") en "Can I send you" ("¿te puedo enviar?").

Siguiente paso: mete la línea del medio en un alias de shell o en una acción "Ejecutar script de shell" de Atajos y asígnale una combinación de teclas.

3. Lee tickets, PDF y scripts

En 2 minutos tienes: respuestas sobre una imagen, un PDF escaneado o un script, leídos en tu Mac con el reconocimiento de texto de Apple.

Cuando un ticket, un escaneo o un archivo desconocido aterriza en mi carpeta Descargas, quiero el único dato que necesito de él, para poder archivarlo sin abrirlo.

Adjunta un archivo con -f. Creamos una imagen de un ticket de prueba (receipt.png) con estas líneas:

Salida
CAFE APFEL
2x Melange          9.80
1x Sachertorte      7.90
1x Apfelstrudel     6.50
TOTAL EUR          24.20
14.11.2026  21:14
Terminal
apfel -f receipt.png "What is the total? Just the amount."
24.20

El mismo ticket guardado como PDF de solo imagen también funciona, porque apfel aplica reconocimiento de texto a las páginas escaneadas:

Terminal
apfel -f receipt.pdf "What is the total? Just the amount."
24.20

Y cualquier archivo de texto, por ejemplo un script de shell:

Terminal
apfel -f apfel-demos/gitsum "What does this script do? Two sentences."
This script summarizes recent Git activity by summarizing the last N commits, grouping related changes, and generating a concise report. It uses Apple Intelligence to format the output, and optionally copies the summary to the clipboard.

Ese script lo obtienes en la tarea 6. Para adjuntar varios archivos, usa -f a.txt -f b.txt.

Si falla: el código de salida 4 significa que el archivo es demasiado largo para el modelo (consulta los límites). El código de salida 3 significa que el filtro de seguridad de Apple lo ha bloqueado; para ese caso, la guía de extracción de archivos recomienda añadir --permissive.

4. Convierte lenguaje corriente en un comando de shell

En 2 minutos tienes: el comando que no recordabas, impreso sin nada más, listo para copiar.

Cuando se me olvidan los flags de find, du o tar, quiero obtener el comando a partir de una frase normal, para poder seguir en el terminal.

--code imprime solo el código, sin explicaciones:

Terminal
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100M

Los flags son correctos, pero el modelo se ha inventado una carpeta. Tu carpeta de inicio es ~ (aquí: find ~ -type f -size +100M).

Terminal
apfel --code "a python function that removes duplicates from a list but keeps the order"
def remove_duplicates_preserve_order(lst):
    seen = set()
    result = []
    for item in lst:
        if item not in seen:
            seen.add(item)
            result.append(item)
    return result

Lee cada comando antes de ejecutarlo. En nuestras pruebas, el modelo también generó comandos erróneos. Cuando le pedimos "the 10 largest files in the current folder" (los 10 archivos más grandes de la carpeta actual), imprimió ls -lh | head -n 10, que lista las 10 primeras entradas, no las más grandes. Cuando le pedimos "show open ports" (mostrar los puertos abiertos), propuso netstat -tuln | grep LISTEN, que usa flags de Linux; en macOS no imprime absolutamente nada. En un Mac, lsof -iTCP -sTCP:LISTEN -n -P sí los lista.

Siguiente paso: el script de demo cmd de la tarea 6 hace esto mismo y te pregunta antes de ejecutar nada (-x) o copia el comando (-c).

5. JSON en el que tus scripts pueden confiar

En 2 minutos tienes: datos estructurados extraídos de un texto desordenado, como JSON que siempre cumple tu esquema.

Cuando necesito nombres, números o fechas de correos y notas, quiero campos, no prosa, para poder pasárselos a jq, a una hoja de cálculo o a un script.

Guarda un JSON Schema como contact.schema.json:

JSON
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "city": { "type": "string" },
    "phone": { "type": "string" }
  },
  "required": ["name", "city", "phone"]
}

Después pasa el texto por un pipe con --schema. apfel restringe el modelo para que la salida sea JSON válido según ese esquema:

Terminal
echo "Hi, I am Maria Lopez from Vienna, call me on +43 660 1234567" | apfel --schema contact.schema.json "Extract the contact" | jq .
{
  "name": "Maria Lopez",
  "city": "Vienna",
  "phone": "+43 660 1234567"
}

Las claves vuelven en el orden en que las declara tu esquema.

Para obtener cualquier respuesta como JSON con metadatos, usa -o json:

Terminal
apfel -o json "Translate to German: apple" | jq -r .content
Apfel

Para una lista entera, usa --batch: entra una línea JSON por registro y sale una línea de resultado por registro, cada registro en una sesión nueva. Tres reseñas de producto en un archivo de texto:

Terminal
cat reviews.txt
Love it, works offline and it is fast.
Crashes every time I open a PDF.
It is okay, it does the job.
jq -Rc '{custom_id: (input_line_number|tostring), prompt: ("Classify the sentiment of this review as positive, negative or neutral. Reply with one word. Review: " + .)}' reviews.txt | apfel --batch | jq -r '"\(.custom_id) \(.status) \(.content)"'
1 ok Positive
2 ok Negative
3 ok Neutral
apfel: batch: 3 records, 3 ok, 0 failed

jq -R convierte cada línea en un registro; la última línea es el resumen de apfel en stderr. Un registro que falla recibe status: "error" y el lote sigue adelante.

Si falla: apfel admite un subconjunto de JSON Schema (objetos, strings, enums, números, booleanos, arrays, $ref locales). Una palabra clave no admitida, como pattern, detiene la ejecución con el código de salida 2 y la nombra; la lista está en el documento de compatibilidad de la API.

6. Automatiza tu día: git, voz y scripts listos para usar

En 2 minutos tienes: un resumen de tu trabajo reciente, un Mac que te avisa en voz alta cuando termina una tarea larga y ocho scripts de shell con IA listos para usar.

Cuando cambio de tarea o espero a que termine una compilación, quiero pequeñas automatizaciones que expliquen y avisen, para poder dejar de vigilar el terminal.

Resume lo que has hecho, desde dentro de cualquier repositorio git:

Terminal
git log --oneline -10 | apfel "summarize what I have been working on, two sentences"
I've been updating star counts to 6,608 and refining ISO datetimes with timezone handling in the Article JSON-LD. Additionally, I've implemented the apfel AI tutorial and redesigned the pre-header with a centered line about the project.

Haz que tu Mac hable cuando algo termine. Pasa la respuesta a say con un pipe y pon delante tu comando largo con &&:

Terminal
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | say

El Mac de pruebas no tenía salida de sonido, así que grabamos la voz en un archivo (| say -o build-done.aiff, 102.880 bytes de audio). La frase que pronunció fue Your build is finished, and I'm glad you asked!.

apfel también incluye ocho scripts de demo. Escríbelos en una carpeta:

Terminal
apfel --demos
apfel: wrote 9 demo files to /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/apfel-demos
  • cmd
  • explain
  • gitsum
  • mac-narrator
  • naming
  • oneliner
  • port
  • wtd

Uno que nos gustó en las pruebas:

Terminal
./apfel-demos/naming "function that retries HTTP requests with exponential backoff"
retryExponentialBackoff | exponential_retry_backoff | exponential delay retry  
retryWithExponentialBackoff | exponential_retry_http_backoff | HTTP retry with delay  
backoffRetryHTTP | exponential_http_retry | retry with exponential pause

No todas las demos salieron bien en nuestras ejecuciones: oneliner "count unique IP addresses in access.log" chocó con el límite de longitud e imprimió un comando roto, y explain añadió un mensaje de error que no existía. El README de las demos las enumera todas.

7. Ejecuta tu código de OpenAI gratis

En 2 minutos tienes: un servidor local que habla la API Chat Completions de OpenAI, así que el código existente que usa el SDK funciona contra tu Mac en lugar de contra un modelo de pago en la nube.

Cuando hago prototipos con el SDK de OpenAI, quiero un endpoint local gratuito, para poder desarrollar y probar sin claves, sin facturas y sin enviar datos fuera.

Arranca el servidor en una pestaña del terminal:

Terminal
apfel --serve
apfel server v1.18.0
├ endpoint: http://127.0.0.1:11434
├ model:    apple-foundationmodel
├ cors:     disabled
├ origin:   localhost only (http://127.0.0.1, http://localhost, http://[::1])
├ token:    none
├ health:   public
├ max concurrent: 5
├ debug:    off
└ ready

Endpoints:
  POST http://127.0.0.1:11434/v1/chat/completions
  GET  http://127.0.0.1:11434/v1/models
  GET  http://127.0.0.1:11434/health

2026-11-15T13:39:31+0100 info Hummingbird: [HummingbirdCore] Server started and listening on 127.0.0.1:11434

En una segunda pestaña, llámalo como si fuera OpenAI:

Terminal
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.

El SDK oficial de OpenAI para Python funciona sin cambios. Solo cambian la URL base y el nombre del modelo. Guárdalo como hello.py:

Python
from openai import OpenAI

client = OpenAI(base_url="http://localhost:11434/v1", api_key="unused")
reply = client.chat.completions.create(
    model="apple-foundationmodel",
    messages=[{"role": "user", "content": "Give me three names for a coffee shop run by robots."}],
)
print(reply.choices[0].message.content)
Terminal
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

El servidor solo escucha en tu propio Mac (127.0.0.1) y rechaza las peticiones de páginas web de otros orígenes. Para abrirlo a tu red, añade un token: apfel --serve --host 0.0.0.0 --token-auto (guía de seguridad del servidor).

Si falla: Connection refused significa que el servidor no está en marcha. Los embeddings y el antiguo endpoint /v1/completions devuelven HTTP 501, porque el modelo local no los ofrece.

Siguiente paso: los mantenedores documentan configuraciones para VS Code Copilot (solo chat), opencode, Zed y Node.js, Ruby, PHP y seis lenguajes más. No las hemos vuelto a probar para esta página.

8. Dale herramientas con MCP

En 2 minutos tienes: el modelo leyendo una página web en directo y resumiéndola, gracias a una herramienta del Model Context Protocol.

Cuando la respuesta está en una página web, quiero que el modelo la consulte por sí mismo, para poder tener un resumen sin andar copiando texto.

Instala las herramientas apfel-mcp, pensadas para caber en la pequeña ventana de contexto:

Terminal
brew install Arthur-Ficial/tap/apfel-mcp

Conecta una con --mcp y pregunta. -q oculta la salida en bruto de la herramienta:

Terminal
apfel -q --mcp $(which apfel-mcp-url-fetch) "Summarize https://apfel.franzai.com/ in 3 bullets"
- **Purpose**: apfel is a Swift 6.3 tool that wraps Apple’s on-device LLM (part of macOS 26’s Apple Intelligence) and exposes it via a CLI, HTTP server, and interactive chat with context management.  
- **Features**: It handles terminal commands, JSON output, file attachments, real token counting, and context trimming (4,096 or 8,192 tokens depending on hardware), while converting OpenAI tool schemas to Apple’s native format.  
- **Technical details**: Built using the FoundationModels framework, it runs on Apple Silicon’s Neural Engine and GPU without network or cloud dependencies, and is open-source under MIT license.

El mismo paquete incluye apfel-mcp-ddg-search (búsqueda web), apfel-mcp-search-and-fetch y apfel-mcp-fs (leer un archivo local). Sirve cualquier servidor MCP: la ruta de un script local o una URL https://.

Las herramientas con varios argumentos con nombre también funcionan. Aquí está la calculadora del repositorio de apfel (mcp/calculator/server.py): el modelo llama a multiply con ambos argumentos, apfel la ejecuta y el modelo responde con el resultado:

Terminal
apfel --mcp ./server.py "What is 15 times 27?"
mcp: /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/./server.py - add, subtract, multiply, divide, sqrt, power, round_number
tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

La línea tool: es apfel mostrándote la llamada que ha ejecutado. Antes de apfel 1.18.0, el modelo no veía los nombres de los argumentos y los adivinaba, así que una llamada como esta fallaba (issue #555, corregido en la pull request #556). Si aquí ves invalid arguments, actualiza con brew upgrade apfel.

9. Chatea para probar un prompt

En 2 minutos tienes: una conversación en el terminal que recuerda lo que dijiste antes.

Cuando estoy dando forma a un prompt para un script, quiero probar unos cuantos turnos rápidamente, para poder ver cómo reacciona el modelo antes de automatizarlo.

Terminal
apfel --chat
Apple Intelligence · on-device LLM · apfel v1.18.0
────────────────────────────────────────────────────────
Type 'quit' to exit.

you› My name is Franz. I live in Vienna.
 ai› Hello, Franz. It's nice to meet you. I'm here to help with any questions or tasks you might have. How can I assist you today?

you› Suggest one thing I could do there this weekend. One sentence.
 ai› You could visit the Kunsthistorisches Museum to explore its impressive collection of art and artifacts.

you› What is my name?
 ai› Your name is Franz.

you› quit

Goodbye.

Asígnale un rol con -s, por ejemplo apfel --chat -s "You are a patient Python tutor". Cuando un chat largo se sale de la ventana de contexto, apfel descarta por defecto los turnos más antiguos; la guía de contexto explica las demás estrategias. Si prefieres una ventana con botones, echa un vistazo a apfel-chat.

10. Deja el servidor en marcha en segundo plano

En 2 minutos tienes: el servidor compatible con OpenAI arrancando solo al iniciar sesión, siempre listo en el puerto 11434.

Cuando las herramientas de mi Mac usan el endpoint local todos los días, quiero que esté siempre activo, para poder dejar de arrancarlo a mano.

Terminal
brew services start apfel
==> Successfully started `apfel` (label: sh.brew.apfel)
curl -s http://127.0.0.1:11434/health | jq -c '{status, model_available, context_window}'
{"status":"ok","model_available":true,"context_window":4096}
brew services stop apfel
Stopping `apfel`... (might take a while)
==> Successfully stopped `apfel` (label: sh.brew.apfel)

Ajustes como el puerto, un token o los servidores MCP se configuran con variables de entorno, por ejemplo APFEL_PORT=8080 brew services start apfel. Todas aparecen en la guía del servicio en segundo plano.

11. Apps basadas en apfel

En 2 minutos tienes: el mismo modelo local en una ventana, en la barra de menús o con una tecla rápida, si prefieres las apps al terminal.

Vienen de los mismos mantenedores (el "apfel tree" del README). El 15 de noviembre de 2026 comprobamos que cada nombre de instalación existe en Homebrew; no hemos probado las apps para esta página.

App Qué hace Instalación
apfel-chat App de chat con respuestas en streaming, voz y análisis de imágenes brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Acciones sobre el portapapeles desde la barra de menús: resumir, traducir, reescribir brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Pulsa una tecla, pregunta, recibe la respuesta y ciérralo brew install Arthur-Ficial/tap/apfel-quick
apfelpad Bloc de notas en el que la IA es una fórmula que pones en una celda brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Herramientas MCP a la medida de la pequeña ventana de contexto (tarea 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel con una configuración guardada y una lista de servidores MCP brew install Arthur-Ficial/tap/apfel-run
apfel-tag Etiquetas, temas y emociones para cualquier texto que le pases por un pipe brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Ventana de depuración: peticiones, mensajes MCP, voz brew install Arthur-Ficial/tap/apfel-gui

Límites y respuestas honestas

apfel te da el modelo local de Apple. El README habla de unos 3 mil millones de parámetros, mucho menos que los modelos en la nube que hay detrás de ChatGPT o Claude. Se le dan bien las tareas de texto cortas y concretas. Estos son los límites con los que nos topamos o que indica la documentación.

La ventana de contexto es pequeña. La pregunta y la respuesta tienen que caber en 4.096 tokens en macOS 26 y en los Mac M1 y M2, o en 8.192 tokens en los Mac M3 o posteriores con 12 GB o más y macOS 27 (README). apfel --model-info te muestra la tuya. El propio README de apfel es demasiado largo para ella. Cuenta antes de enviar:

Terminal
apfel --count-tokens -f README.md "summarize in 3 bullets"
8272/3584 tokens (over budget)
  prompt=7, README.md=8258
apfel -f README.md "summarize in 3 bullets"; echo "exit code: $?"
error: [context overflow] Input exceeds the model's context window: the input is 8264 tokens, the window is 4096 tokens. Shorten the conversation history.
exit code: 4

Los 3.584 son la ventana de 4.096 menos 512 tokens que se reservan para la respuesta. El README tiene unas 3.000 palabras, pero el Markdown y el código cuestan muchos tokens por palabra. Pasa los archivos largos por partes (head -c 6000 file), una sección cada vez.

No sabe la fecha de hoy. Se inventó una:

Terminal
apfel "What is today's date?"
Today's date is October 27, 2024.
apfel -s "Today is $(date '+%B %d, %Y')." "What is today's date? One sentence."
Today's date is November 15, 2026.

Dale en el prompt cualquier dato que necesite. No tiene acceso a internet, salvo que le conectes una herramienta MCP.

A veces se equivoca, y con total seguridad. Ya lo has visto arriba: comandos de shell erróneos en la tarea 4 y una traducción que invirtió el sentido en la tarea 2. Comprueba todo lo que importe.

El filtro de seguridad de Apple puede bloquear texto inofensivo. En ese caso apfel se detiene con el código de salida 3 y el mensaje The request was blocked by Apple's safety guardrails. Reformula la petición o añade --permissive para escritura creativa y documentos; la documentación de los guardrails explica qué cambia. En las ejecuciones para esta página no nos topamos con ningún bloqueo.

Las respuestas cambian en cada ejecución. Estas son salidas reales de una sola ejecución cada una. Las tuyas estarán redactadas de otra forma. Usa --temperature 0 para obtener respuestas más reproducibles; apfel no promete una salida idéntica entre ejecuciones ni entre actualizaciones de macOS (política de estabilidad).

Velocidad: en nuestras ejecuciones, la mayoría de las respuestas tardaron entre 1 y 2 segundos. El resumen de la página web con una herramienta MCP tardó 8 segundos.

Los requisitos son estrictos: solo Apple Silicon, macOS 26 o posterior, Apple Intelligence activado y uno de los 15 idiomas que lista --model-info. Los Mac con Intel no pueden ejecutarlo.

Cuando algo falla

apfel informa de los problemas con un código de salida, para que los scripts puedan reaccionar. Compruébalo con echo $? justo después del comando.

Código de salida o error Significado Qué hacer
2 Flag u opción incorrectos Los flags van antes del prompt; apfel --help los lista
3 El filtro de seguridad de Apple ha bloqueado la petición Reformula o añade --permissive
4 Entrada demasiado larga para la ventana de contexto Envía menos texto; compruébalo con apfel --count-tokens
5 Modelo no disponible Activa Apple Intelligence, espera a que termine la descarga y usa el mismo idioma en el Mac y en Siri
6 El modelo está ocupado o se ha alcanzado el límite de peticiones Espera y vuelve a ejecutarlo, o añade --retry
Connection refused No hay ningún servidor en el puerto 11434 Inicia apfel --serve o brew services start apfel
HTTP 501 Endpoint que el modelo local no ofrece (embeddings, /v1/completions) Usa /v1/chat/completions
piped input was empty El comando ha escrito en stderr command 2>&1 \| apfel "..."

¿Sigues atascado? Busca o abre una issue en GitHub.

Quién hizo esto y cómo se probó

apfel es gratuito y de código abierto (licencia MIT), un proyecto de franzai creado por Franz Enzenhofer. Lo mantiene junto con Arthur Ficial, el asistente de IA de Franz, que también ha escrito este tutorial. Como esta página la han escrito los creadores de apfel, hemos incluido cada fallo que vimos en lugar de omitirlo.

Cómo lo probamos: el 15 de noviembre de 2026 ejecutamos todos los comandos de esta página en un MacBook Air M2 (24 GB) con macOS 27.0.1 (build 26A434). Usamos el binario firmado de apfel 1.18.0 de la release de GitHub (el mismo archivo que instala el tap de Homebrew), dentro de una sesión de terminal real, y copiamos la salida sin cambios. La primera versión de esta página (14 de noviembre de 2026, apfel 1.16.0) mostraba el bug de las herramientas con varios argumentos de la tarea 8; la 1.18.0 lo corrige, así que volvimos a ejecutar todos los comandos para esta versión. Cuando la primera salida era errónea, la dejamos en la página y lo indicamos. Las únicas repeticiones sirvieron para encontrar respuestas que no necesitaran ninguna edición: un resumen de página web contenía una raya larga, que este sitio no imprime, así que lo ejecutamos de nuevo y nos quedamos con la tercera ejecución. El ejemplo de voz se comprobó escribiendo el audio en un archivo, porque el Mac de pruebas no tenía salida de sonido. Los scripts de demo los escribió apfel --demos de apfel 1.18.0.

Lo que otros han escrito sobre apfel: el post de Show HN (3 de abril de 2026, 743 puntos), una guía de Better Stack, un artículo de GIGAZINE y una reseña práctica en danilchenko.dev.

Fuentes: el README de apfel, la referencia de la CLI, la guía de instalación, los scripts de demo, apfel frente al fm de Apple y el gestor de issues, consultados el 15 de noviembre de 2026.