apfel est un projet .

Tutoriel · testé le 15 novembre 2026

Tutoriel apfel AI

Votre première réponse de l'IA déjà présente sur votre Mac, en 60 secondes. Puis 11 tâches qu'elle fait bien, chacune prête à copier-coller avec sa vraie sortie, et une liste honnête de ce qu'elle ne sait pas faire.

Vrai enregistrement du terminal, sans montage : apfel 1.18.0 sur macOS 27.0.1, MacBook Air M2.
Sur cette page : 15 sections
  1. Votre première réponse en 60 secondes
  2. 1. Interrogez votre Mac sur lui-même
  3. 2. Corrigez n'importe quel texte copié
  4. 3. Lisez reçus, PDF et scripts
  5. 4. Transformez une phrase en commande shell
  6. 5. Obtenez du JSON fiable pour vos scripts
  7. 6. Automatisez votre journée : git, voix et scripts prêts à l'emploi
  8. 7. Faites tourner votre code OpenAI gratuitement
  9. 8. Donnez-lui des outils avec MCP
  10. 9. Discutez pour tester un prompt
  11. 10. Gardez le serveur actif en arrière-plan
  12. 11. Les apps construites sur apfel
  13. Limites et réponses honnêtes
  14. En cas de problème
  15. Qui a fait ce tutoriel et comment il a été testé

Votre première réponse en 60 secondes

Il vous faut un Mac Apple Silicon (M1 ou plus récent) sous macOS 26 Tahoe ou ultérieur, avec Apple Intelligence activé dans Réglages Système > Apple Intelligence et Siri. Vérifiez les deux premiers points en une ligne :

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Une version 26 ou supérieure et arm64 : vous êtes prêt. Installez apfel avec Homebrew. Pas de Xcode, pas de compte, pas de clé API :

Terminal
brew install apfel

Posez votre première question :

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.

Cette réponse vient du modèle d'Apple, sur votre Mac. Rien n'a été envoyé à un serveur, et cela n'a rien coûté.

En cas d'échec : demandez à apfel si le modèle est prêt :

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

S'il affiche available: no, activez Apple Intelligence dans les Réglages Système et attendez la fin du téléchargement du modèle (le guide d'installation l'estime à 3 à 4 Go). La langue de votre Mac et celle de Siri doivent être identiques et faire partie des langues prises en charge. Tant que le modèle est indisponible, apfel se termine avec le code 5.

Ensuite : les tâches ci-dessous. Chacune commence par ce que vous aurez au bout de deux minutes.

1. Interrogez votre Mac sur lui-même

En 2 minutes, vous avez : des réponses claires sur votre disque, votre CPU et votre mémoire, tirées directement des commandes que vous connaissez déjà.

Quand une commande affiche un mur de chiffres, je veux une réponse en une ligne, pour pouvoir agir sans lire une page de man.

Envoyez n'importe quelle commande dans apfel via un pipe et dites ce que vous voulez savoir :

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.

Gardez une entrée courte : d'abord head, awk et grep, ensuite apfel. Le modèle ne lit que quelques milliers de mots à la fois, et moins encore pour du code (voir les limites).

En cas d'échec : certaines commandes écrivent sur stderr, que le pipe ne transmet pas. apfel vous le signale : piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Ensuite : la même astuce fonctionne avec git log, lsof, pmset -g batt, les fichiers de log et tout ce qui affiche du texte.

2. Corrigez n'importe quel texte copié

En 2 minutes, vous avez : une commande qui corrige la grammaire de ce qui se trouve dans votre presse-papiers, quelle que soit l'app.

Quand j'écris un message rapide dans Slack, Mail ou un navigateur, je veux le faire corriger sans ouvrir une autre app, pour pouvoir le recoller en quelques secondes.

Copiez un texte, puis lancez la ligne du milieu. pbpaste lit le presse-papiers, pbcopy y réécrit le résultat :

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.

Pourquoi « the text above » : apfel place le texte reçu par le pipe en premier et votre instruction après (source). Avec l'instruction courte "fix grammar and spelling, reply with the corrected text only", le modèle a répondu au message au lieu de le corriger, avec Could you let me know which meeting you're referring to?. Désigner explicitement le texte à traiter a réglé le problème lors de notre test.

En cas d'échec : relisez le résultat avant de l'envoyer. Un petit modèle change parfois le sens : quand nous lui avons demandé de traduire cette phrase en allemand, il a transformé « Can you send me » en « Can I send you ».

Ensuite : placez la ligne du milieu dans un alias shell ou dans une action « Exécuter un script shell » de Raccourcis, et associez-lui un raccourci clavier.

3. Lisez reçus, PDF et scripts

En 2 minutes, vous avez : des réponses sur une image, un PDF scanné ou un script, lus sur votre Mac grâce à la reconnaissance de texte d'Apple.

Quand un reçu, un scan ou un fichier inconnu atterrit dans mes Téléchargements, je veux en extraire la seule information utile, pour pouvoir le classer sans l'ouvrir.

Joignez un fichier avec -f. Nous avons créé une image de reçu de test (receipt.png) contenant ces lignes :

Sortie
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

Le même reçu enregistré en PDF composé uniquement d'images fonctionne aussi, car apfel applique la reconnaissance de texte aux pages scannées :

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

Et n'importe quel fichier texte, par exemple un script 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.

Vous obtiendrez ce script dans la tâche 6. Pour joindre plusieurs fichiers : -f a.txt -f b.txt.

En cas d'échec : le code de sortie 4 signifie que le fichier est trop long pour le modèle (voir les limites). Le code 3 signifie que le filtre de sécurité d'Apple l'a bloqué ; le guide d'extraction de fichiers conseille alors d'ajouter --permissive.

4. Transformez une phrase en commande shell

En 2 minutes, vous avez : la commande dont vous ne vous souveniez plus, affichée seule pour que vous puissiez la copier.

Quand j'oublie les options de find, du ou tar, je veux obtenir la commande à partir d'une simple phrase, pour pouvoir rester dans le terminal.

--code n'affiche que le code, sans explication :

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

Les options sont justes, mais le modèle a inventé un dossier. Votre dossier personnel, c'est ~ (ici : 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

Relisez chaque commande avant de l'exécuter. Lors de nos tests, le modèle en a aussi produit de fausses. À la demande « the 10 largest files in the current folder », il a affiché ls -lh | head -n 10, qui liste les 10 premières entrées, pas les plus volumineuses. À la demande « show open ports », il a proposé netstat -tuln | grep LISTEN, qui utilise des options Linux : sur macOS, cela n'affiche rien du tout. Sur un Mac, c'est lsof -iTCP -sTCP:LISTEN -n -P qui les liste.

Ensuite : le script de démo cmd de la tâche 6 encapsule tout cela et demande confirmation avant d'exécuter quoi que ce soit (-x) ou copie la commande (-c).

5. Obtenez du JSON fiable pour vos scripts

En 2 minutes, vous avez : des données structurées extraites d'un texte brouillon, en JSON toujours conforme à votre schéma.

Quand j'ai besoin de noms, de chiffres ou de dates tirés d'e-mails et de notes, je veux des champs, pas de la prose, pour pouvoir les passer à jq, à un tableur ou à un script.

Enregistrez un JSON Schema sous le nom contact.schema.json :

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

Puis envoyez le texte via un pipe avec --schema. apfel contraint le modèle pour que la sortie soit un JSON valide pour ce schéma :

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"
}

Les clés reviennent dans l'ordre où votre schéma les déclare.

Pour obtenir n'importe quelle réponse en JSON avec ses métadonnées, utilisez -o json :

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

Pour toute une liste, utilisez --batch : une ligne JSON par enregistrement en entrée, une ligne de résultat par enregistrement en sortie, chaque enregistrement dans une nouvelle session. Trois avis produits dans un fichier texte :

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 transforme chaque ligne en enregistrement ; la dernière ligne est le récapitulatif d'apfel sur stderr. Un enregistrement en échec reçoit status: "error" et le traitement continue.

En cas d'échec : apfel prend en charge un sous-ensemble de JSON Schema (objets, chaînes, enums, nombres, booléens, tableaux, $ref locaux). Un mot-clé non pris en charge, comme pattern, provoque un arrêt avec le code 2 et apfel le nomme ; la liste figure dans la documentation de compatibilité de l'API.

6. Automatisez votre journée : git, voix et scripts prêts à l'emploi

En 2 minutes, vous avez : un résumé de votre travail récent, un Mac qui vous annonce à voix haute la fin d'une longue tâche, et huit scripts shell IA prêts à l'emploi.

Quand je change de tâche ou que j'attends la fin d'un build, je veux de petites automatisations qui expliquent et annoncent les choses, pour pouvoir arrêter de surveiller le terminal.

Résumez ce que vous avez fait, depuis n'importe quel dépôt 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.

Faites parler votre Mac quand quelque chose se termine. Envoyez la réponse dans say via un pipe, et placez votre longue commande devant avec && :

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

Le Mac de test n'avait pas de sortie audio : nous avons donc enregistré la parole dans un fichier (| say -o build-done.aiff, 102 880 octets d'audio). La phrase prononcée était Your build is finished, and I'm glad you asked!.

apfel est aussi livré avec huit scripts de démo. Écrivez-les dans un dossier :

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

Un script qui nous a plu pendant les tests :

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

Toutes les démos n'ont pas été bonnes lors de nos essais : oneliner "count unique IP addresses in access.log" s'est heurté à la limite de longueur et a affiché une commande cassée, et explain a ajouté un message d'erreur qui n'existait pas. Le README des démos présente les huit.

7. Faites tourner votre code OpenAI gratuitement

En 2 minutes, vous avez : un serveur local qui parle l'API OpenAI Chat Completions, pour que votre code SDK existant tourne sur votre Mac au lieu d'un modèle cloud payant.

Quand je prototype avec le SDK OpenAI, je veux un endpoint local gratuit, pour pouvoir développer et tester sans clés, sans factures et sans envoyer de données ailleurs.

Lancez le serveur dans un onglet du 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

Dans un second onglet, appelez-le comme vous appelleriez 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.

Le SDK Python officiel d'OpenAI fonctionne sans modification. Seuls l'URL de base et le nom du modèle changent. Enregistrez ceci sous 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

Le serveur n'écoute que sur votre propre Mac (127.0.0.1) et refuse les requêtes des pages web d'autres origines. Pour l'ouvrir à votre réseau, ajoutez un token : apfel --serve --host 0.0.0.0 --token-auto (guide de sécurité du serveur).

En cas d'échec : Connection refused signifie que le serveur ne tourne pas. Les embeddings et l'ancien endpoint /v1/completions renvoient HTTP 501, car le modèle local ne les propose pas.

Ensuite : les mainteneurs documentent la configuration pour VS Code Copilot (chat uniquement), opencode, Zed et Node.js, Ruby, PHP et six autres langages. Nous ne les avons pas retestées pour cette page.

8. Donnez-lui des outils avec MCP

En 2 minutes, vous avez : le modèle qui lit une page web en direct et la résume, grâce à un outil Model Context Protocol.

Quand la réponse se trouve sur une page web, je veux que le modèle aille la chercher lui-même, pour pouvoir obtenir un résumé sans copier de texte à la main.

Installez les outils apfel-mcp, conçus pour tenir dans la petite fenêtre de contexte :

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

Branchez-en un avec --mcp et posez votre question. -q masque la sortie brute de l'outil :

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.

Le même paquet contient apfel-mcp-ddg-search (recherche web), apfel-mcp-search-and-fetch et apfel-mcp-fs (lecture d'un fichier local). N'importe quel serveur MCP fonctionne : un chemin vers un script local ou une URL https://.

Les outils à plusieurs arguments nommés fonctionnent aussi. Voici la calculatrice du dépôt apfel (mcp/calculator/server.py) : le modèle appelle multiply avec les deux arguments, apfel l'exécute et le modèle répond avec le résultat :

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 ligne tool:, c'est apfel qui vous montre l'appel qu'il a exécuté. Avant apfel 1.18.0, le modèle ne voyait pas les noms des arguments et les devinait, si bien qu'un appel comme celui-ci échouait (issue #555, corrigée par la pull request #556). Si vous voyez invalid arguments ici, mettez à jour avec brew upgrade apfel.

9. Discutez pour tester un prompt

En 2 minutes, vous avez : une conversation dans le terminal qui se souvient de ce que vous avez dit plus tôt.

Quand je mets au point un prompt pour un script, je veux essayer rapidement quelques échanges, pour pouvoir voir comment le modèle réagit avant d'automatiser.

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.

Donnez-lui un rôle avec -s, par exemple apfel --chat -s "You are a patient Python tutor". Quand une longue conversation dépasse la fenêtre de contexte, apfel supprime par défaut les échanges les plus anciens ; le guide du contexte explique les autres stratégies. Pour une fenêtre avec des boutons, voyez apfel-chat.

10. Gardez le serveur actif en arrière-plan

En 2 minutes, vous avez : le serveur compatible OpenAI qui démarre tout seul à l'ouverture de session, toujours prêt sur le port 11434.

Quand des outils de mon Mac utilisent l'endpoint local tous les jours, je veux qu'il soit toujours actif, pour pouvoir arrêter de le lancer à la main.

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)

Les réglages comme le port, un token ou des serveurs MCP passent par des variables d'environnement, par exemple APFEL_PORT=8080 brew services start apfel. Elles sont toutes listées dans le guide du service en arrière-plan.

11. Les apps construites sur apfel

En 2 minutes, vous avez : le même modèle local dans une fenêtre, dans la barre des menus ou derrière un raccourci clavier, si vous préférez les apps au terminal.

Elles viennent des mêmes mainteneurs (l'« apfel tree » du README). Nous avons vérifié le 15 novembre 2026 que chaque nom d'installation existe dans Homebrew ; nous n'avons pas testé les apps pour cette page.

App Ce qu'elle fait Installation
apfel-chat App de chat avec réponses en streaming, voix et analyse d'images brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Actions sur le presse-papiers depuis la barre des menus : résumer, traduire, reformuler brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Une touche, une question, la réponse, et ça disparaît brew install Arthur-Ficial/tap/apfel-quick
apfelpad Bloc-notes où l'IA est une formule que vous placez dans une cellule brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Outils MCP taillés pour la petite fenêtre (tâche 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel avec une configuration enregistrée et une liste de serveurs MCP brew install Arthur-Ficial/tap/apfel-run
apfel-tag Tags, thèmes et émotions pour tout texte reçu par un pipe brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Fenêtre de débogage : requêtes, messages MCP, voix brew install Arthur-Ficial/tap/apfel-gui

Limites et réponses honnêtes

apfel vous donne accès au modèle local d'Apple. Le README l'estime à environ 3 milliards de paramètres, bien moins que les modèles cloud derrière ChatGPT ou Claude. Il est bon pour les tâches textuelles courtes et ciblées. Voici les limites que nous avons rencontrées ou que la documentation indique.

La fenêtre de contexte est petite. Question et réponse doivent tenir dans 4 096 tokens sous macOS 26 et sur les Mac M1 et M2, ou dans 8 192 tokens sur les Mac M3 ou plus récents dotés d'au moins 12 Go et sous macOS 27 (README). apfel --model-info affiche la vôtre. Le README d'apfel lui-même est trop long pour elle. Comptez avant d'envoyer :

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

Le 3 584 correspond à la fenêtre de 4 096 moins 512 tokens réservés à la réponse. Le README compte environ 3 000 mots, mais le Markdown et le code coûtent beaucoup de tokens par mot. Envoyez les fichiers longs par morceaux (head -c 6000 file), une section à la fois.

Il ne connaît pas la date du jour. Il en a inventé une :

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.

Donnez-lui dans le prompt tout fait dont il a besoin. Il n'a pas accès à Internet, sauf si vous branchez un outil MCP.

Il se trompe parfois, avec aplomb. Vous l'avez vu plus haut : des commandes shell fausses dans la tâche 4, une traduction qui inverse le sens dans la tâche 2. Vérifiez tout ce qui compte.

Le filtre de sécurité d'Apple peut bloquer un texte inoffensif. apfel s'arrête alors avec le code de sortie 3 et le message The request was blocked by Apple's safety guardrails. Reformulez, ou ajoutez --permissive pour l'écriture créative et les documents ; la documentation sur les garde-fous explique ce que cela change. Nous n'avons subi aucun blocage lors des essais pour cette page.

Les réponses varient à chaque exécution. Ce sont de vraies sorties, issues d'une seule exécution chacune. Les vôtres seront formulées autrement. Utilisez --temperature 0 pour des réponses plus reproductibles ; apfel ne garantit pas une sortie identique d'une exécution à l'autre ni après une mise à jour de macOS (politique de stabilité).

Vitesse : lors de nos essais, la plupart des réponses sont arrivées en 1 à 2 secondes. Le résumé de page web avec un outil MCP a pris 8 secondes.

Les prérequis sont stricts : Apple Silicon uniquement, macOS 26 ou plus récent, Apple Intelligence activé, et l'une des 15 langues listées par --model-info. Les Mac Intel ne peuvent pas le faire tourner.

En cas de problème

apfel signale les problèmes par un code de sortie, pour que les scripts puissent réagir. Vérifiez-le avec echo $? juste après la commande.

Code de sortie ou erreur Signification Que faire
2 Option ou argument incorrect Les options se placent avant le prompt ; apfel --help les liste
3 Le filtre de sécurité d'Apple a bloqué la requête Reformulez, ou ajoutez --permissive
4 Entrée trop longue pour la fenêtre de contexte Envoyez moins de texte ; vérifiez avec apfel --count-tokens
5 Modèle indisponible Activez Apple Intelligence, attendez la fin du téléchargement, alignez la langue du Mac et celle de Siri
6 Le modèle est occupé ou limité en débit Patientez et relancez, ou ajoutez --retry
Connection refused Aucun serveur sur le port 11434 Lancez apfel --serve ou brew services start apfel
HTTP 501 Endpoint que le modèle local ne propose pas (embeddings, /v1/completions) Utilisez /v1/chat/completions
piped input was empty La commande a écrit sur stderr command 2>&1 \| apfel "..."

Toujours bloqué ? Cherchez ou ouvrez une issue sur GitHub.

Qui a fait ce tutoriel et comment il a été testé

apfel est libre et gratuit (licence MIT), un projet franzai de Franz Enzenhofer. Il est maintenu avec Arthur Ficial, l'assistant IA de Franz, qui a aussi écrit ce tutoriel. Comme ce sont les créateurs d'apfel qui ont rédigé cette page, nous avons listé chaque échec constaté au lieu de les passer sous silence.

Notre méthode de test : le 15 novembre 2026, nous avons exécuté chaque commande de cette page sur un MacBook Air M2 (24 Go) sous macOS 27.0.1 (build 26A434). Nous avons utilisé le binaire signé d'apfel 1.18.0 issu de la release GitHub (le même fichier que celui installé par le tap Homebrew), dans une vraie session de terminal, et copié la sortie sans la modifier. La première version de cette page (14 novembre 2026, apfel 1.16.0) montrait le bug des outils à plusieurs arguments de la tâche 8 ; la version 1.18.0 le corrige, nous avons donc relancé chaque commande pour cette version. Quand la première sortie était fausse, nous l'avons laissée sur la page en le signalant. Les seules relances visaient à obtenir des réponses publiables sans retouche : un résumé de page web contenait un tiret long, que ce site n'affiche pas, nous l'avons donc relancé et gardé le troisième essai. L'exemple vocal a été vérifié en écrivant l'audio dans un fichier, car le Mac de test n'avait pas de sortie audio. Les scripts de démo ont été générés par apfel --demos d'apfel 1.18.0.

Ce que d'autres ont écrit sur apfel : le post Show HN (3 avril 2026, 743 points), un guide de Better Stack, un article de GIGAZINE et un test pratique sur danilchenko.dev.

Sources : le README d'apfel, la référence de la CLI, le guide d'installation, les scripts de démo, apfel face au fm d'Apple et le suivi des issues, consultés le 15 novembre 2026.