Ú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.
Ezen az oldalon: 15 szakasz
- Az első válasz 60 másodperc alatt
- 1. Kérdezd a Macet saját magáról
- 2. Javíts ki bármilyen kimásolt szöveget
- 3. Nyugták, PDF-ek és szkriptek olvasása
- 4. Hétköznapi mondatból shell parancs
- 5. JSON, amiben a szkriptjeid megbízhatnak
- 6. Automatizáld a napod: git, hang és kész szkriptek
- 7. Futtasd ingyen az OpenAI-kódodat
- 8. Eszközök MCP-vel
- 9. Chatelj, és teszteld a promptot
- 10. A szerver fusson a háttérben
- 11. Appok az apfelre építve
- Korlátok és őszinte válaszok
- Ha valami nem működik
- 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:
sw_vers -productVersion && uname -m
27.0.1
arm64Ha 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:
brew install apfelTedd fel az első kérdésed:
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:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensHa 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:
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.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:
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:
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.20Ugyanez a nyugta csak képet tartalmazó PDF-ként is működik, mert az apfel a szkennelt oldalakon szövegfelismerést futtat:
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:
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:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MA 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).
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 resultMinden 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:
{
"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:
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:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelEgé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:
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 failedA 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:
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:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayA 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:
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
• wtdAz egyik kedvencünk a tesztbő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 pauseNem 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:
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:11434Egy második fülön hívd meg úgy, mintha az OpenAI lenne:
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:
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 SipA 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:
brew install Arthur-Ficial/tap/apfel-mcpCsatolj egyet a --mcp kapcsolóval, és kérdezz. A -q elrejti az eszköz nyers kimenetét:
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:
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.
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.
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:
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: 4A 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:
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.