Tutorial · testado a 15 de novembro de 2026
Tutorial do apfel AI
A primeira resposta da IA que já está no seu Mac em 60 segundos. Depois, 11 tarefas que faz bem, cada uma pronta a copiar e colar com a saída real, e uma lista honesta do que não consegue fazer.
Nesta página: 15 secções
- A primeira resposta em 60 segundos
- 1. Pergunte ao Mac sobre ele próprio
- 2. Corrija qualquer texto que copiou
- 3. Leia recibos, PDFs e scripts
- 4. Transforme linguagem natural num comando de shell
- 5. Obtenha JSON em que os seus scripts podem confiar
- 6. Automatize o seu dia: git, voz e scripts prontos
- 7. Execute o seu código OpenAI de graça
- 8. Dê-lhe ferramentas com MCP
- 9. Converse para testar um prompt
- 10. Mantenha o servidor a correr em segundo plano
- 11. Apps construídas sobre o apfel
- Limites e respostas honestas
- Quando algo falha
- Quem fez isto e como foi testado
A primeira resposta em 60 segundos
Precisa de um Mac com Apple Silicon (M1 ou mais recente) com o macOS 26 Tahoe ou posterior, e do Apple Intelligence ativado em Definições do Sistema > Apple Intelligence e Siri. Verifique os dois primeiros requisitos numa só linha:
sw_vers -productVersion && uname -m
27.0.1
arm64Uma versão 26 ou superior e arm64 significam que está tudo pronto. Instale o apfel com o Homebrew. Sem Xcode, sem conta, sem chave de API:
brew install apfelFaça a sua primeira pergunta:
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.Esta resposta veio do modelo da Apple no seu Mac. Nada foi enviado para um servidor e não custou nada.
Se falhar: pergunte ao apfel se o modelo está pronto:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensSe aparecer available: no, ative o Apple Intelligence nas Definições do Sistema e espere até o modelo terminar de ser transferido (segundo o guia de instalação, ocupa 3 a 4 GB). O idioma do Mac e o da Siri têm de ser o mesmo e um dos idiomas suportados. Enquanto o modelo não estiver disponível, o apfel termina com o código de saída 5.
A seguir: as tarefas abaixo. Cada uma começa pelo que terá ao fim de dois minutos.
1. Pergunte ao Mac sobre ele próprio
Em 2 minutos tem: respostas em linguagem simples sobre o disco, o CPU e a memória, diretamente a partir dos comandos que já conhece.
Quando um comando de terminal despeja uma parede de números, quero uma resposta numa linha, para poder agir sem ler uma man page.
Passe a saída de qualquer comando ao apfel por pipe e diga o que quer saber:
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.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.Mantenha a entrada pequena: primeiro head, awk e grep, depois o apfel. O modelo só lê alguns milhares de palavras de cada vez, e menos ainda se for código (veja os limites).
Se falhar: alguns comandos escrevem para o stderr, que o pipe não transporta. O apfel avisa: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.
A seguir: o mesmo truque funciona com git log, lsof, pmset -g batt, ficheiros de log e tudo o que imprima texto.
2. Corrija qualquer texto que copiou
Em 2 minutos tem: um comando que corrige a gramática do que estiver na área de transferência, em qualquer app.
Quando escrevo uma mensagem rápida no Slack, no Mail ou no browser, quero que fique limpa sem abrir outra app, para poder colá-la de volta em segundos.
Copie um texto e execute a linha do meio. O pbpaste lê a área de transferência e o pbcopy escreve lá o resultado:
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.Porquê "the text above": o apfel coloca primeiro o texto recebido por pipe e só depois a sua instrução (código-fonte). Com a instrução curta "fix grammar and spelling, reply with the corrected text only", o modelo respondeu à mensagem em vez de a corrigir e devolveu Could you let me know which meeting you're referring to?. Indicar o texto sobre o qual deve trabalhar resolveu o problema no nosso teste.
Se falhar: leia o resultado antes de o enviar. Um modelo pequeno às vezes altera o sentido; quando lhe pedimos para traduzir esta frase para alemão, transformou "Can you send me" em "Can I send you".
A seguir: coloque a linha do meio num alias de shell ou numa ação "Executar script de shell" dos Atalhos e atribua-lhe um atalho de teclado.
3. Leia recibos, PDFs e scripts
Em 2 minutos tem: respostas sobre uma imagem, um PDF digitalizado ou um script, lidos no seu Mac com o reconhecimento de texto da Apple.
Quando um recibo, uma digitalização ou um ficheiro desconhecido aparece nas Transferências, quero o único dado de que preciso, para poder arquivá-lo sem o abrir.
Anexe um ficheiro com -f. Criámos uma imagem de recibo de teste (receipt.png) com estas linhas:
CAFE APFEL
2x Melange 9.80
1x Sachertorte 7.90
1x Apfelstrudel 6.50
TOTAL EUR 24.20
14.11.2026 21:14apfel -f receipt.png "What is the total? Just the amount."
24.20O mesmo recibo guardado como PDF só com imagem também funciona, porque o apfel aplica reconhecimento de texto às páginas digitalizadas:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20E qualquer ficheiro de texto, por exemplo um script de shell:
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.Esse script está na tarefa 6. Para anexar vários ficheiros, use -f a.txt -f b.txt.
Se falhar: o código de saída 4 significa que o ficheiro é demasiado longo para o modelo (veja os limites). O código de saída 3 significa que o filtro de segurança da Apple o bloqueou; para esse caso, o guia de extração de ficheiros sugere acrescentar --permissive.
4. Transforme linguagem natural num comando de shell
Em 2 minutos tem: o comando de que não se lembrava, impresso sem mais nada para o poder copiar.
Quando me esqueço das flags do find, do du ou do tar, quero obter o comando a partir de uma frase simples, para poder continuar no terminal.
O --code imprime só o código, sem explicações:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MAs flags estão certas, mas o modelo inventou uma pasta. A sua pasta pessoal é ~ (aqui: find ~ -type f -size +100M).
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 resultLeia cada comando antes de o executar. Nos nossos testes, o modelo também gerou comandos errados. Quando lhe pedimos "os 10 maiores ficheiros da pasta atual", imprimiu ls -lh | head -n 10, que lista as 10 primeiras entradas, não as maiores. Quando lhe pedimos para "mostrar as portas abertas", sugeriu netstat -tuln | grep LISTEN, que usa flags de Linux; no macOS não imprime absolutamente nada. Num Mac, é o lsof -iTCP -sTCP:LISTEN -n -P que as lista.
A seguir: o script de demonstração cmd da tarefa 6 faz isto por si e pergunta antes de executar alguma coisa (-x) ou copia o comando (-c).
5. Obtenha JSON em que os seus scripts podem confiar
Em 2 minutos tem: dados estruturados extraídos de texto desarrumado, em JSON que corresponde sempre ao seu schema.
Quando preciso de nomes, números ou datas de e-mails e notas, quero campos e não prosa, para poder passá-los ao jq, a uma folha de cálculo ou a um script.
Guarde um JSON Schema como contact.schema.json:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"city": { "type": "string" },
"phone": { "type": "string" }
},
"required": ["name", "city", "phone"]
}Depois passe o texto por pipe com --schema. O apfel restringe o modelo para que a saída seja JSON válido segundo esse schema:
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"
}As chaves vêm pela ordem em que o seu schema as declara.
Para obter qualquer resposta em JSON com metadados, use -o json:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelPara uma lista inteira, use --batch: entra uma linha JSON por registo, sai uma linha de resultado por registo, cada registo numa sessão nova. Três avaliações de produtos num ficheiro de texto:
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 failedO jq -R transforma cada linha num registo; a última linha é o resumo do apfel no stderr. Um registo que falhe recebe status: "error" e o lote continua.
Se falhar: o apfel suporta um subconjunto do JSON Schema (objetos, strings, enums, números, booleanos, arrays, $ref local). Uma palavra-chave não suportada, como pattern, termina com o código de saída 2 e é indicada pelo nome; a lista está no documento de compatibilidade da API.
6. Automatize o seu dia: git, voz e scripts prontos
Em 2 minutos tem: um resumo do seu trabalho recente, um Mac que o avisa em voz alta quando uma tarefa longa termina e oito scripts de shell com IA prontos a usar.
Quando mudo de tarefa ou espero por um build, quero pequenas automatizações que expliquem e anunciem as coisas, para poder deixar de vigiar o terminal.
Resuma o que fez, a partir de qualquer repositório git:
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.Ponha o Mac a falar quando algo termina. Passe a resposta ao say por pipe e coloque o seu comando longo antes, com &&:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayO Mac de teste não tinha saída de som, por isso gravámos a fala num ficheiro (| say -o build-done.aiff, 102.880 bytes de áudio). A frase dita foi Your build is finished, and I'm glad you asked!.
O apfel inclui também oito scripts de demonstração. Escreva-os numa pasta:
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
• wtdUm de que gostámos nos testes:
./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 pauseNem todas as demonstrações correram bem nos nossos testes: oneliner "count unique IP addresses in access.log" esbarrou no limite de comprimento e imprimiu um comando partido, e o explain acrescentou uma mensagem de erro que não existia. O README das demonstrações lista as oito.
7. Execute o seu código OpenAI de graça
Em 2 minutos tem: um servidor local que fala a API Chat Completions da OpenAI, para que o código SDK que já tem corra no seu Mac em vez de num modelo pago na cloud.
Quando faço protótipos com o SDK da OpenAI, quero um endpoint local gratuito, para poder desenvolver e testar sem chaves, sem faturas e sem enviar dados para fora.
Inicie o servidor num separador do 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:11434Num segundo separador, chame-o como chamaria a OpenAI:
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.O SDK oficial da OpenAI para Python funciona sem alterações. Só mudam o URL base e o nome do modelo. Guarde como hello.py:
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)python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew
2. CogCafé
3. Circuit SipO servidor só escuta no seu próprio Mac (127.0.0.1) e recusa pedidos de páginas web de outras origens. Para o abrir à sua rede, acrescente um token: apfel --serve --host 0.0.0.0 --token-auto (guia de segurança do servidor).
Se falhar: Connection refused significa que o servidor não está a correr. Os embeddings e o antigo endpoint /v1/completions devolvem HTTP 501, porque o modelo on-device não os oferece.
A seguir: os responsáveis pelo projeto documentam configurações para o VS Code Copilot (só chat), o opencode, o Zed e para Node.js, Ruby, PHP e mais seis linguagens. Não voltámos a testá-las para esta página.
8. Dê-lhe ferramentas com MCP
Em 2 minutos tem: o modelo a ler uma página web ao vivo e a resumi-la, através de uma ferramenta Model Context Protocol.
Quando a resposta está numa página web, quero que o modelo a vá buscar sozinho, para poder ter um resumo sem andar a copiar texto de um lado para o outro.
Instale as ferramentas apfel-mcp, feitas para caber na pequena janela de contexto:
brew install Arthur-Ficial/tap/apfel-mcpAnexe uma com --mcp e pergunte. O -q esconde a saída em bruto da ferramenta:
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.O mesmo pacote inclui apfel-mcp-ddg-search (pesquisa na web), apfel-mcp-search-and-fetch e apfel-mcp-fs (ler um ficheiro local). Qualquer servidor MCP funciona: o caminho de um script local ou um URL https://.
Também funcionam ferramentas com vários argumentos nomeados. Eis a calculadora do repositório do apfel (mcp/calculator/server.py): o modelo chama multiply com os dois argumentos, o apfel executa-a e o modelo responde com o resultado:
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.A linha tool: é o apfel a mostrar-lhe a chamada que executou. Antes do apfel 1.18.0, o modelo não via os nomes dos argumentos e adivinhava-os, por isso uma chamada como esta falhava (issue #555, corrigida no pull request #556). Se aqui aparecer invalid arguments, atualize com brew upgrade apfel.
9. Converse para testar um prompt
Em 2 minutos tem: uma conversa no terminal que se lembra do que disse antes.
Quando estou a afinar um prompt para um script, quero experimentar rapidamente algumas trocas, para poder ver como o modelo reage antes de o automatizar.
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.Acrescente uma persona com -s, por exemplo apfel --chat -s "You are a patient Python tutor". Quando uma conversa longa ultrapassa a janela de contexto, o apfel descarta por omissão as trocas mais antigas; o guia de contexto explica as outras estratégias. Para uma janela com botões, veja o apfel-chat.
10. Mantenha o servidor a correr em segundo plano
Em 2 minutos tem: o servidor compatível com a OpenAI a arrancar sozinho no início de sessão, sempre pronto na porta 11434.
Quando as ferramentas do meu Mac usam o endpoint local todos os dias, quero que esteja sempre ligado, para poder deixar de o iniciar à mão.
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)Definições como a porta, um token ou servidores MCP são variáveis de ambiente, por exemplo APFEL_PORT=8080 brew services start apfel. Estão todas listadas no guia do serviço em segundo plano.
11. Apps construídas sobre o apfel
Em 2 minutos tem: o mesmo modelo on-device numa janela, na barra de menus ou num atalho de teclado, se preferir apps ao terminal.
Vêm dos mesmos responsáveis pelo projeto (a "apfel tree" no README). A 15 de novembro de 2026 confirmámos que cada nome de instalação existe no Homebrew; não testámos as apps para esta página.
| App | O que faz | Instalação |
|---|---|---|
| apfel-chat | App de chat com respostas em streaming, voz e análise de imagens | brew install Arthur-Ficial/tap/apfel-chat |
| apfel-clip | Ações na barra de menus sobre a área de transferência: resumir, traduzir, reescrever | brew install Arthur-Ficial/tap/apfel-clip |
| apfel-quick | Carregue numa tecla, pergunte, receba a resposta, feche | brew install Arthur-Ficial/tap/apfel-quick |
| apfelpad | Bloco de notas em que a IA é uma fórmula que se põe numa célula | brew install Arthur-Ficial/tap/apfelpad |
| apfel-mcp | Ferramentas MCP dimensionadas para a janela pequena (tarefa 8) | brew install Arthur-Ficial/tap/apfel-mcp |
| apfel-run | O apfel com uma configuração guardada e uma lista de servidores MCP | brew install Arthur-Ficial/tap/apfel-run |
| apfel-tag | Etiquetas, temas e emoções para qualquer texto recebido por pipe | brew install Arthur-Ficial/tap/apfel-tag |
| apfel-gui | Janela de depuração: pedidos, mensagens MCP, voz | brew install Arthur-Ficial/tap/apfel-gui |
Limites e respostas honestas
O apfel dá-lhe acesso ao modelo on-device da Apple. O README estima-o em cerca de 3 mil milhões de parâmetros, muito mais pequeno do que os modelos na cloud por trás do ChatGPT ou do Claude. É bom em tarefas de texto curtas e focadas. Estes são os limites com que nos deparámos ou que a documentação indica.
A janela de contexto é pequena. Pergunta e resposta têm de caber em 4.096 tokens no macOS 26 e nos Mac M1 e M2, ou em 8.192 tokens nos Mac M3 ou mais recentes com 12 GB ou mais a correr o macOS 27 (README). O apfel --model-info mostra a sua. O próprio README do apfel é demasiado longo para ela. Conte antes de enviar:
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: 4Os 3.584 são a janela de 4.096 menos 512 tokens reservados para a resposta. O README tem cerca de 3.000 palavras, mas Markdown e código custam muitos tokens por palavra. Passe os ficheiros longos por partes (head -c 6000 file), uma secção de cada vez.
Não sabe a data de hoje. Inventou uma:
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.Dê-lhe no prompt todos os factos de que precisa. Não tem acesso à internet, a menos que lhe anexe uma ferramenta MCP.
Às vezes erra, e com toda a confiança. Já viu acima: comandos de shell errados na tarefa 4, uma tradução que inverteu o sentido na tarefa 2. Verifique tudo o que for importante.
O filtro de segurança da Apple pode bloquear texto inofensivo. Nesse caso, o apfel para com o código de saída 3 e a mensagem The request was blocked by Apple's safety guardrails. Reformule, ou acrescente --permissive para escrita criativa e documentos; o documento sobre os guardrails explica o que isso muda. Não tivemos nenhum bloqueio nos testes desta página.
As respostas mudam a cada execução. As saídas aqui mostradas são reais, de uma única execução cada. As suas terão outra formulação. Use --temperature 0 para respostas mais reprodutíveis; o apfel não promete uma saída idêntica entre execuções nem entre atualizações do macOS (política de estabilidade).
Velocidade: nos nossos testes, a maioria das respostas chegou em 1 a 2 segundos. O resumo da página web com uma ferramenta MCP demorou 8 segundos.
Os requisitos são rígidos: só Apple Silicon, macOS 26 ou mais recente, Apple Intelligence ativado e um dos 15 idiomas que o --model-info lista. Os Mac com Intel não o conseguem executar.
Quando algo falha
O apfel comunica os problemas com um código de saída, para que os scripts possam reagir. Verifique-o com echo $? logo a seguir ao comando.
| Código de saída ou erro | Significado | O que fazer |
|---|---|---|
2 |
Flag ou opção errada | As flags vêm antes do prompt; apfel --help lista-as |
3 |
O filtro de segurança da Apple bloqueou o pedido | Reformule, ou acrescente --permissive |
4 |
Entrada demasiado longa para a janela de contexto | Envie menos texto; verifique com apfel --count-tokens |
5 |
Modelo indisponível | Ative o Apple Intelligence, espere pela transferência, use o mesmo idioma no Mac e na Siri |
6 |
O modelo está ocupado ou atingiu o limite de pedidos | Espere e execute de novo, ou acrescente --retry |
Connection refused |
Nenhum servidor na porta 11434 | Inicie apfel --serve ou brew services start apfel |
| HTTP 501 | Endpoint que o modelo on-device não oferece (embeddings, /v1/completions) |
Use /v1/chat/completions |
piped input was empty |
O comando escreveu para o stderr | command 2>&1 \| apfel "..." |
Continua com problemas? Pesquise ou abra uma issue no GitHub.
Quem fez isto e como foi testado
O apfel é gratuito e open source (licença MIT), um projeto franzai de Franz Enzenhofer. É mantido com Arthur Ficial, o assistente de IA de Franz, que também escreveu este tutorial. Como esta página foi escrita pelos próprios criadores do apfel, listámos todas as falhas que vimos em vez de as omitir.
Como testámos: a 15 de novembro de 2026 executámos todos os comandos desta página num MacBook Air M2 (24 GB) com o macOS 27.0.1 (build 26A434). Usámos o binário assinado do apfel 1.18.0 da release no GitHub (o mesmo ficheiro que o tap do Homebrew instala), numa sessão de terminal real, e copiámos a saída sem alterações. A primeira versão desta página (14 de novembro de 2026, apfel 1.16.0) mostrava o bug das ferramentas com vários argumentos na tarefa 8; o 1.18.0 corrige-o, por isso voltámos a executar todos os comandos para esta versão. Quando a primeira saída estava errada, mantivemo-la na página e dissemo-lo. As únicas repetições serviram para encontrar respostas que não precisassem de edição: um resumo de página web continha um travessão longo, que este site não imprime, por isso executámo-lo de novo e ficámos com a terceira execução. O exemplo de voz foi verificado gravando o áudio num ficheiro, porque o Mac de teste não tinha saída de som. Os scripts de demonstração foram escritos pelo apfel --demos do apfel 1.18.0.
O que outros escreveram sobre o apfel: o post no Show HN (3 de abril de 2026, 743 pontos), um guia da Better Stack, um artigo da GIGAZINE e uma análise prática no danilchenko.dev.
Fontes: o README do apfel, a referência da CLI, o guia de instalação, os scripts de demonstração, o apfel vs o fm da Apple e o registo de issues, consultados a 15 de novembro de 2026.