Az apfel egy -projekt.

Útmutató · tesztelve: 2026. november 15.

apfel AI-útmutató

Az első válasz a Maceden már ott lévő AI-tól 60 másodperc alatt. Utána 11 feladat, amiben jó, mindegyik másolható parancsokkal és valódi kimenettel, végül egy őszinte lista arról, mire nem képes.

Valódi terminálfelvétel, vágás nélkül: apfel 1.18.0, macOS 27.0.1, MacBook Air M2.
Ezen az oldalon: 15 szakasz
  1. Az első válasz 60 másodperc alatt
  2. 1. Kérdezd a Macet saját magáról
  3. 2. Javíts ki bármilyen kimásolt szöveget
  4. 3. Nyugták, PDF-ek és szkriptek olvasása
  5. 4. Hétköznapi mondatból shell parancs
  6. 5. JSON, amiben a szkriptjeid megbízhatnak
  7. 6. Automatizáld a napod: git, hang és kész szkriptek
  8. 7. Futtasd ingyen az OpenAI-kódodat
  9. 8. Eszközök MCP-vel
  10. 9. Chatelj, és teszteld a promptot
  11. 10. A szerver fusson a háttérben
  12. 11. Appok az apfelre építve
  13. Korlátok és őszinte válaszok
  14. Ha valami nem működik
  15. Ki készítette, és hogyan teszteltük

Az első válasz 60 másodperc alatt

Kell hozzá egy Apple Silicon Mac (M1 vagy újabb) macOS 26 Tahoe vagy újabb rendszerrel, és bekapcsolt Apple Intelligence a Rendszerbeállítások > Apple Intelligence és Siri alatt. Az első kettőt egyetlen sorral ellenőrizheted:

Terminál
sw_vers -productVersion && uname -m
27.0.1
arm64

Ha a verzió legalább 26, és arm64 jelenik meg, készen állsz. Telepítsd az apfelt Homebrew segítségével. Nem kell Xcode, se fiók, se API-kulcs:

Terminál
brew install apfel

Tedd fel az első kérdésed:

Terminál
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.

Ezt a választ az Apple modellje adta, a saját Maceden. Semmi nem ment ki szerverre, és egy fillérbe sem került.

Ha nem működik: kérdezd meg az apfelt, hogy kész-e a modell:

Terminál
apfel --model-info | grep -E 'available|context'
├ available:  yes
├ context:    4096 tokens

Ha available: no a válasz, kapcsold be az Apple Intelligence-t a Rendszerbeállításokban, és várd meg, amíg a modell letöltődik (a telepítési útmutató szerint 3-4 GB). A Mac nyelvének és a Siri nyelvének ugyanannak a támogatott nyelvnek kell lennie. Amíg a modell nem érhető el, az apfel 5-ös exit kóddal lép ki.

Tovább: jönnek a feladatok. Mindegyik azzal kezdődik, mi lesz a kezedben két perc múlva.

1. Kérdezd a Macet saját magáról

2 perc alatt megkapod: érthető válaszokat a lemezedről, a CPU-ról és a memóriáról, egyenesen a már ismert parancsaidból.

Amikor egy terminálparancs egy halom számot zúdít rám, azt szeretném, hogy egyetlen sorban kapjak választ, így man page olvasása nélkül léphetek.

Pipe-old be bármelyik parancs kimenetét az apfelbe, és mondd meg, mire vagy kíváncsi:

Terminál
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
Terminál
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.

Tartsd kicsiben a bemenetet: előbb head, awk és grep, csak utána apfel. A modell egyszerre csak néhány ezer szót tud elolvasni, kódból még kevesebbet (lásd a korlátokat).

Ha nem működik: egyes parancsok a stderr-re írnak, azt pedig a pipe nem viszi tovább. Az apfel ezt meg is mondja: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Tovább: ugyanez a trükk működik a git log, az lsof, a pmset -g batt, a logfájlok és bármi más esetén, ami szöveget ír ki.

2. Javíts ki bármilyen kimásolt szöveget

2 perc alatt megkapod: egy parancsot, amely kijavítja a vágólapon lévő szöveg nyelvtanát, bármelyik appból másoltad is.

Amikor gyorsan írok egy üzenetet Slackben, Mailben vagy a böngészőben, azt szeretném, hogy egy másik app megnyitása nélkül rendbe jöjjön, így másodpercek alatt visszailleszthetem.

Másolj ki egy szöveget, aztán futtasd a középső sort. A pbpaste beolvassa a vágólapot, a pbcopy visszaírja az eredményt:

Terminál
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.

Miért „the text above”: az apfel a pipe-olt szöveget teszi előre, az utasításodat pedig utána (forrás). A rövid "fix grammar and spelling, reply with the corrected text only" utasításra a modell javítás helyett válaszolt az üzenetre, ezzel: Could you let me know which meeting you're referring to?. A tesztünkben az segített, hogy megneveztük a szöveget, amin dolgoznia kell.

Ha nem működik: olvasd el az eredményt, mielőtt elküldöd. Egy kis modell néha megváltoztatja a jelentést; amikor ezt a mondatot németre fordíttattuk vele, a „Can you send me” fordulatból „Can I send you” lett.

Tovább: tedd a középső sort egy shell aliasba vagy egy Parancsok app „Shell-szkript futtatása” műveletébe, és rendelj hozzá billentyűparancsot.

3. Nyugták, PDF-ek és szkriptek olvasása

2 perc alatt megkapod: válaszokat egy képről, egy szkennelt PDF-ről vagy egy szkriptről, a Maceden, az Apple szövegfelismerésével beolvasva.

Amikor egy nyugta, szkennelt dokumentum vagy ismeretlen fájl landol a Letöltések mappában, azt szeretném, hogy kiderüljön belőle az az egy adat, amire szükségem van, így megnyitás nélkül a helyére tehetem.

Fájlt a -f kapcsolóval csatolhatsz. Készítettünk egy tesztnyugtát képként (receipt.png), ezekkel a sorokkal:

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

Ugyanez a nyugta csak képet tartalmazó PDF-ként is működik, mert az apfel a szkennelt oldalakon szövegfelismerést futtat:

Terminál
apfel -f receipt.pdf "What is the total? Just the amount."
24.20

És bármilyen szövegfájllal is, például egy shell szkripttel:

Terminál
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.

Ezt a szkriptet a 6. feladatban kapod meg. Több fájlt így csatolhatsz: -f a.txt -f b.txt.

Ha nem működik: a 4-es exit kód azt jelenti, hogy a fájl túl hosszú a modellnek (lásd a korlátokat). A 3-as exit kód azt jelenti, hogy az Apple biztonsági szűrője blokkolta; erre az esetre a fájlkinyerési útmutató a --permissive kapcsolót javasolja.

4. Hétköznapi mondatból shell parancs

2 perc alatt megkapod: azt a parancsot, amire nem emlékeztél, csupaszon kiírva, hogy egyből másolhasd.

Amikor elfelejtem a find, a du vagy a tar kapcsolóit, azt szeretném, hogy egy egyszerű mondatból megkapjam a parancsot, így a terminálban maradhatok.

A --code csak a kódot írja ki, magyarázat nélkül:

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

A kapcsolók jók, de a mappát a modell kitalálta. A felhasználói mappád a ~ (vagyis: find ~ -type f -size +100M).

Terminál
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

Minden parancsot olvass el, mielőtt lefuttatod. A tesztjeinkben a modell hibás parancsokat is adott. Amikor „az aktuális mappa 10 legnagyobb fájlját” kértük, ezt írta ki: ls -lh | head -n 10, ami az első 10 bejegyzést listázza, nem a legnagyobbakat. Amikor a nyitott portokat kértük, ezt javasolta: netstat -tuln | grep LISTEN, ami Linuxos kapcsolókat használ; macOS-en semmit sem ír ki. Macen ez listázza őket: lsof -iTCP -sTCP:LISTEN -n -P.

Tovább: a 6. feladatban szereplő cmd demó szkript ezt csomagolja be, és rákérdez, mielőtt bármit lefuttat (-x) vagy kimásolja a parancsot (-c).

5. JSON, amiben a szkriptjeid megbízhatnak

2 perc alatt megkapod: rendezetlen szövegből kinyert strukturált adatot, olyan JSON-ként, amely mindig megfelel a sémádnak.

Amikor neveket, számokat vagy dátumokat kell kiszednem e-mailekből és jegyzetekből, azt szeretném, hogy mezőket kapjak, ne folyó szöveget, így továbbadhatom őket a jq-nak, egy táblázatkezelőnek vagy egy szkriptnek.

Mentsd el ezt a JSON Schemát contact.schema.json néven:

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

Aztán pipe-old be a szöveget a --schema kapcsolóval. Az apfel úgy korlátozza a modellt, hogy a kimenet érvényes JSON legyen ehhez a sémához:

Terminál
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"
}

A kulcsok abban a sorrendben jönnek vissza, ahogy a sémád deklarálja őket.

Ha bármilyen választ JSON-ként, metaadatokkal szeretnél, használd a -o json kapcsolót:

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

Egész listához ott a --batch: rekordonként egy JSON-sor be, rekordonként egy eredménysor ki, és minden rekord friss sessionben fut. Három termékértékelés egy szövegfájlban:

Terminál
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

A jq -R minden sorból rekordot csinál; az utolsó sor az apfel összesítője a stderr-en. Egy hibás rekord status: "error" állapotot kap, a batch pedig megy tovább.

Ha nem működik: az apfel a JSON Schema egy részhalmazát támogatja (objektumok, stringek, enumok, számok, booleanok, tömbök, helyi $ref). Egy nem támogatott kulcsszó, például a pattern, 2-es exit kóddal megállítja a futást, és megnevezi a kulcsszót; a lista az API-kompatibilitási dokumentációban található.

6. Automatizáld a napod: git, hang és kész szkriptek

2 perc alatt megkapod: egy összefoglalót a legutóbbi munkádról, egy Macet, amely hangosan szól, ha egy hosszú feladat végzett, és nyolc kész AI-os shell szkriptet.

Amikor feladatot váltok vagy egy buildre várok, azt szeretném, hogy apró automatizálások magyarázzanak el és jelentsenek be dolgokat, így nem kell a terminált bámulnom.

Foglald össze, mit csináltál, bármelyik git repóban:

Terminál
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.

Hagyd, hogy a Maced megszólaljon, ha valami befejeződött. Pipe-old a választ a say parancsba, a hosszú parancsodat pedig tedd elé &&-vel:

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

A teszt-Macnek nem volt hangkimenete, ezért a beszédet inkább fájlba rögzítettük (| say -o build-done.aiff, 102 880 bájtnyi hang). A kimondott mondat ez volt: Your build is finished, and I'm glad you asked!.

Az apfel nyolc demó szkriptet is ad. Írd ki őket egy mappába:

Terminál
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

Az egyik kedvencünk a tesztből:

Terminál
./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

Nem minden demó volt jó a futtatásainkban: a oneliner "count unique IP addresses in access.log" belefutott a hosszkorlátba, és hibás parancsot írt ki, az explain pedig egy nem létező hibaüzenetet tett hozzá. Mind a nyolcat a demó README sorolja fel.

7. Futtasd ingyen az OpenAI-kódodat

2 perc alatt megkapod: egy helyi szervert, amely az OpenAI Chat Completions API-t beszéli, így a meglévő SDK-kódod a Maceden fut, nem egy fizetős felhős modellen.

Amikor az OpenAI SDK-val prototipizálok, azt szeretném, hogy legyen egy ingyenes helyi végpontom, így kulcsok, számlák és adatküldés nélkül fejleszthetek és tesztelhetek.

Indítsd el a szervert az egyik terminálfülön:

Terminál
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

Egy második fülön hívd meg úgy, mintha az OpenAI lenne:

Terminál
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.

A hivatalos OpenAI Python SDK változtatás nélkül működik. Csak az alap-URL és a modell neve más. Mentsd el hello.py néven:

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)
Terminál
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

A szerver csak a saját Maceden figyel (127.0.0.1), és elutasítja a más originről érkező weboldalak kéréseit. Ha a hálózatod felé is meg akarod nyitni, adj hozzá tokent: apfel --serve --host 0.0.0.0 --token-auto (szerverbiztonsági útmutató).

Ha nem működik: a Connection refused azt jelenti, hogy a szerver nem fut. Az embeddingek és a régi /v1/completions végpont HTTP 501-et ad vissza, mert a helyi modell ezeket nem kínálja.

Tovább: a fejlesztők leírják a beállítást a VS Code Copilothoz (csak chat), az opencode-hoz, a Zedhez, valamint a Node.js-hez, Rubyhoz, PHP-hoz és hat további nyelvhez. Ezeket ehhez az oldalhoz nem teszteltük újra.

8. Eszközök MCP-vel

2 perc alatt megkapod: egy modellt, amely elolvas és összefoglal egy élő weboldalt egy Model Context Protocol eszköz segítségével.

Amikor a válasz egy weboldalon van, azt szeretném, hogy a modell maga töltse le, így szöveg másolgatása nélkül kapok összefoglalót.

Telepítsd az apfel-mcp eszközöket, amelyeket a kis kontextusablakhoz méreteztek:

Terminál
brew install Arthur-Ficial/tap/apfel-mcp

Csatolj egyet a --mcp kapcsolóval, és kérdezz. A -q elrejti az eszköz nyers kimenetét:

Terminál
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.

Ugyanebben a csomagban van az apfel-mcp-ddg-search (webes keresés), az apfel-mcp-search-and-fetch és az apfel-mcp-fs (helyi fájl olvasása). Bármelyik MCP-szerver működik: egy helyi szkript elérési útja vagy egy https:// URL.

A több elnevezett argumentumot váró eszközök is működnek. Itt az apfel repó számológépe (mcp/calculator/server.py): a modell mindkét argumentummal meghívja a multiply függvényt, az apfel lefuttatja, a modell pedig az eredménnyel válaszol:

Terminál
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 tool: sorban az apfel megmutatja, milyen hívást futtatott. Az apfel 1.18.0 előtt a modell nem látta az argumentumok nevét, és találgatta őket, ezért egy ilyen hívás elbukott (#555-ös issue, javítva a #556-os pull requestben). Ha itt invalid arguments jelenik meg, frissíts a brew upgrade apfel paranccsal.

9. Chatelj, és teszteld a promptot

2 perc alatt megkapod: egy beszélgetést a terminálban, amely emlékszik arra, amit korábban mondtál.

Amikor egy szkripthez csiszolok egy promptot, azt szeretném, hogy gyorsan kipróbálhassak néhány kört, így látom, hogyan reagál a modell, mielőtt automatizálom.

Terminál
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.

Szerepet a -s kapcsolóval adhatsz neki, például apfel --chat -s "You are a patient Python tutor". Ha egy hosszú chat kinövi a kontextusablakot, az apfel alapból a legrégebbi köröket dobja el; a többi stratégiát a kontextus-útmutató magyarázza el. Ha gombos ablakot szeretnél, nézd meg az apfel-chat appot.

10. A szerver fusson a háttérben

2 perc alatt megkapod: az OpenAI-kompatibilis szervert, amely bejelentkezéskor magától elindul, és mindig készen áll a 11434-es porton.

Amikor a Macemen lévő eszközök minden nap a helyi végpontot használják, azt szeretném, hogy mindig fusson, így nem kell kézzel indítgatnom.

Terminál
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)

Az olyan beállítások, mint a port, a token vagy az MCP-szerverek, környezeti változók, például APFEL_PORT=8080 brew services start apfel. Mindet felsorolja a háttérszolgáltatás-útmutató.

11. Appok az apfelre építve

2 perc alatt megkapod: ugyanazt a helyi modellt egy ablakban, a menüsorban vagy egy gyorsbillentyű mögött, ha az appokat jobban szereted a terminálnál.

Ezek ugyanazoktól a fejlesztőktől származnak (az „apfel tree” a README-ben). 2026. november 15-én ellenőriztük, hogy minden telepítési név létezik a Homebrew-ban; magukat az appokat ehhez az oldalhoz nem teszteltük.

App Mit csinál Telepítés
apfel-chat Chat app streamelt válaszokkal, beszéddel és képelemzéssel brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Menüsoros műveletek a vágólapon: összefoglalás, fordítás, átfogalmazás brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Megnyomsz egy billentyűt, kérdezel, megkapod a választ, bezárod brew install Arthur-Ficial/tap/apfel-quick
apfelpad Jegyzettömb, ahol az AI egy cellába írt képlet brew install Arthur-Ficial/tap/apfelpad
apfel-mcp A kis ablakhoz méretezett MCP-eszközök (8. feladat) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel elmentett konfigurációval és MCP-szerverek listájával brew install Arthur-Ficial/tap/apfel-run
apfel-tag Címkék, témák és érzelmek bármilyen bepipe-olt szövegből brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Hibakereső ablak: kérések, MCP-üzenetek, beszéd brew install Arthur-Ficial/tap/apfel-gui

Korlátok és őszinte válaszok

Az apfel az Apple helyi modelljét adja a kezedbe. A README szerint ez nagyjából 3 milliárd paraméteres, vagyis jóval kisebb, mint a ChatGPT vagy a Claude mögötti felhős modellek. Rövid, célzott szöveges feladatokban jó. Az alábbi korlátokba vagy mi magunk ütköztünk, vagy a dokumentáció említi őket.

Kicsi a kontextusablak. A kérdésnek és a válasznak együtt bele kell férnie 4 096 tokenbe macOS 26 alatt és M1-es, M2-es Maceken, illetve 8 192 tokenbe macOS 27-et futtató, legalább 12 GB memóriás M3-as vagy újabb Maceken (README). Hogy nálad mennyi, azt az apfel --model-info mutatja meg. Az apfel saját README-je túl hosszú hozzá. Számolj, mielőtt elküldöd:

Terminál
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

A 3 584 a 4 096 tokenes ablak mínusz a válasz számára szabadon hagyott 512 token. A README nagyjából 3 000 szó, de a Markdown és a kód szavanként sok tokent visz el. A hosszú fájlokat darabokban add be (head -c 6000 file), egyszerre egy szakaszt.

Nem tudja, milyen nap van ma. Kitalált egy dátumot:

Terminál
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.

Minden tényt, amire szüksége van, add meg neki a promptban. Internetet sem ér el, hacsak nem csatolsz egy MCP-eszközt.

Néha téved, és közben magabiztos. Fent is láttad: hibás shell parancsok a 4. feladatban, egy fordítás, amely megfordította a jelentést a 2. feladatban. Ellenőrizz mindent, ami számít.

Az Apple biztonsági szűrője ártalmatlan szöveget is blokkolhat. Ilyenkor az apfel 3-as exit kóddal áll le, ezzel az üzenettel: The request was blocked by Apple's safety guardrails. Fogalmazd át, vagy kreatív íráshoz és dokumentumokhoz add hozzá a --permissive kapcsolót; hogy mit változtat, azt a guardrails-dokumentáció magyarázza el. Az oldalhoz készült futtatásokban egyszer sem kaptunk blokkolást.

A válaszok futtatásonként eltérnek. Ezek valódi kimenetek, mindegyik egyetlen futtatásból. Nálad másképp lesznek megfogalmazva. Ismételhetőbb válaszokhoz használd a --temperature 0 kapcsolót; az apfel nem ígér azonos kimenetet különböző futtatások vagy macOS-frissítések között (stabilitási irányelvek).

Sebesség: a futtatásainkban a legtöbb válasz 1-2 másodperc alatt megjött. A weboldal összefoglalása MCP-eszközzel 8 másodpercig tartott.

Szigorúak a követelmények: csak Apple Silicon, macOS 26 vagy újabb, bekapcsolt Apple Intelligence, és a 15 nyelv egyike, amelyeket a --model-info felsorol. Intel Maceken nem fut.

Ha valami nem működik

Az apfel exit kóddal jelzi a problémákat, így a szkriptek reagálni tudnak rájuk. Közvetlenül a parancs után az echo $? paranccsal ellenőrizheted.

Exit kód vagy hiba Jelentés Teendő
2 Hibás kapcsoló vagy opció A kapcsolók a prompt elé kerülnek; az apfel --help felsorolja őket
3 Az Apple biztonsági szűrője blokkolta a kérést Fogalmazd át, vagy add hozzá a --permissive kapcsolót
4 A bemenet túl hosszú a kontextusablakhoz Küldj kevesebb szöveget; ellenőrizd az apfel --count-tokens paranccsal
5 A modell nem érhető el Kapcsold be az Apple Intelligence-t, várd meg a letöltést, állítsd azonos nyelvre a Macet és a Sirit
6 A modell foglalt, vagy elérted a kéréskorlátot Várj, és futtasd újra, vagy add hozzá a --retry kapcsolót
Connection refused Nincs szerver a 11434-es porton Indítsd el: apfel --serve vagy brew services start apfel
HTTP 501 Olyan végpont, amit a helyi modell nem kínál (embeddingek, /v1/completions) Használd a /v1/chat/completions végpontot
piped input was empty A parancs a stderr-re írt command 2>&1 \| apfel "..."

Még mindig elakadtál? Keress, vagy nyiss egy issue-t a GitHubon.

Ki készítette, és hogyan teszteltük

Az apfel ingyenes és nyílt forráskódú (MIT licenc), Franz Enzenhofer franzai-projektje. Arthur Ficial, Franz AI-asszisztense segít a karbantartásában, és ő írta ezt az útmutatót is. Mivel ezt az oldalt az apfel készítői írták, minden hibát felsoroltunk, amit láttunk, ahelyett, hogy kihagytuk volna őket.

Hogyan teszteltünk: 2026. november 15-én az oldal minden parancsát lefuttattuk egy MacBook Air M2-n (24 GB), macOS 27.0.1 alatt (build 26A434). A GitHub-kiadásból származó, aláírt apfel 1.18.0 binárist használtuk (ugyanazt a fájlt, amit a Homebrew tap telepít), valódi terminálsessionben, és a kimenetet változtatás nélkül másoltuk át. Az oldal első változata (2026. november 14., apfel 1.16.0) a 8. feladatban még a többargumentumos eszközhívás hibáját mutatta; az 1.18.0 ezt javítja, ezért ehhez a verzióhoz minden parancsot újrafuttattunk. Ahol az első kimenet hibás volt, a hibás kimenetet hagytuk az oldalon, és ezt jeleztük is. Csak azért futtattunk újra, hogy szerkesztés nélkül közölhető válaszokat kapjunk: az egyik weboldal-összefoglalóban hosszú gondolatjel volt, amit ez az oldal nem jelenít meg, ezért újrafuttattuk, és a harmadik futtatást tartottuk meg. A felolvasós példát úgy ellenőriztük, hogy a hangot fájlba írtuk, mert a teszt-Macnek nem volt hangkimenete. A demó szkripteket az apfel 1.18.0 apfel --demos parancsa írta ki.

Mit írtak mások az apfelről: a Show HN poszt (2026. április 3., 743 pont), egy Better Stack-útmutató, egy GIGAZINE-cikk és egy gyakorlati teszt a danilchenko.dev oldalon.

Források: az apfel README, a CLI-referencia, a telepítési útmutató, a demó szkriptek, az apfel vs. az Apple fm és az issue tracker, 2026. november 15-i állapot szerint.