apfel je projekt .

Vodič · preizkušeno 15. novembra 2026

Vodič za apfel AI

Prvi odgovor AI, ki je že na tvojem Macu, v 60 sekundah. Nato 11 opravil, ki jih dobro opravi, vsako pripravljeno za kopiranje s pravim izpisom, in iskren seznam tega, česar ne zmore.

Pravi posnetek terminala, nič urejeno: apfel 1.18.0 na macOS 27.0.1, MacBook Air M2.
Na tej strani: 15 razdelkov
  1. Prvi odgovor v 60 sekundah
  2. 1. Vprašaj Mac o njem samem
  3. 2. Popravi besedilo, ki si ga kopiral
  4. 3. Beri račune, PDF-je in skripte
  5. 4. Iz navadnega stavka v shell ukaz
  6. 5. JSON, ki mu tvoje skripte lahko zaupajo
  7. 6. Avtomatiziraj dan: git, glas in pripravljene skripte
  8. 7. Poganjaj svojo OpenAI kodo zastonj
  9. 8. Daj mu orodja z MCP
  10. 9. Klepet za preizkus prompta
  11. 10. Naj strežnik teče v ozadju
  12. 11. Aplikacije, zgrajene na apfel
  13. Omejitve in iskreni odgovori
  14. Ko kaj ne deluje
  15. Kdo je to naredil in kako smo testirali

Prvi odgovor v 60 sekundah

Potrebuješ Mac z Apple Silicon (M1 ali novejši) z macOS 26 Tahoe ali novejšim in vklopljen Apple Intelligence v razdelku Sistemske nastavitve > Apple Intelligence in Siri. Prvi dve zahtevi preveriš v eni vrstici:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Če je različica 26 ali višja in vidiš arm64, si pripravljen. apfel namesti s Homebrew. Brez Xcode, brez računa, brez API ključa:

Terminal
brew install apfel

Postavi prvo vprašanje:

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.

Ta odgovor je dal Applov model na tvojem Macu. Nič ni šlo na strežnik in nič ni stalo.

Če ne deluje: vprašaj apfel, ali je model pripravljen:

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

Če piše available: no, v Sistemskih nastavitvah vklopi Apple Intelligence in počakaj, da se model prenese do konca (po navodilih za namestitev ima 3 do 4 GB). Jezik Maca in jezik Siri morata biti enaka in podprta. Dokler model ni na voljo, se apfel konča z izhodno kodo 5.

Naprej: opravila spodaj. Vsako se začne s tem, kar boš imel po dveh minutah.

1. Vprašaj Mac o njem samem

V 2 minutah imaš: odgovore v navadnem jeziku o disku, procesorju in pomnilniku, naravnost iz ukazov, ki jih že poznaš.

Ko ukaz v terminalu izpiše steno številk, želim odgovor v eni vrstici, da lahko ukrepam, ne da bi bral man stran.

Kateri koli ukaz pošlji po cevovodu v apfel in povej, kaj te zanima:

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.

Vhod naj bo majhen: najprej head, awk in grep, šele nato apfel. Model naenkrat prebere le nekaj tisoč besed, kode še manj (glej omejitve).

Če ne deluje: nekateri ukazi pišejo na stderr, ki ga cevovod ne prenaša. apfel te na to opozori: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Naprej: isti trik deluje za git log, lsof, pmset -g batt, dnevniške datoteke in vse drugo, kar izpisuje besedilo.

2. Popravi besedilo, ki si ga kopiral

V 2 minutah imaš: ukaz, ki popravi slovnico v tem, kar je v odložišču, v kateri koli aplikaciji.

Ko na hitro napišem sporočilo v Slacku, Mailu ali brskalniku, želim ga počistiti, ne da bi odpiral drugo aplikacijo, da ga lahko v nekaj sekundah prilepim nazaj.

Kopiraj nekaj besedila in zaženi srednjo vrstico. pbpaste prebere odložišče, pbcopy vanj zapiše rezultat:

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.

Zakaj »the text above«: apfel besedilo iz cevovoda postavi na začetek, tvoje navodilo pa za njim (vir). S kratkim navodilom "fix grammar and spelling, reply with the corrected text only" je model na sporočilo odgovoril, namesto da bi ga popravil, in vrnil Could you let me know which meeting you're referring to?. Ko smo izrecno poimenovali besedilo, ki naj ga obdela, je v našem testu delovalo.

Če ne deluje: rezultat preberi, preden ga pošlješ. Majhen model včasih spremeni pomen; ko smo ga prosili, naj ta stavek prevede v nemščino, je iz »Can you send me« naredil »Can I send you«.

Naprej: srednjo vrstico shrani kot alias v lupini ali kot dejanje »Run Shell Script« v Bližnjicah in ji dodeli bližnjico na tipkovnici.

3. Beri račune, PDF-je in skripte

V 2 minutah imaš: odgovore o sliki, skeniranem PDF-ju ali skripti, prebrane na tvojem Macu z Applovim prepoznavanjem besedila.

Ko v mapo Prenosi prispe račun, sken ali neznana datoteka, želim iz nje izvedeti tisti en podatek, ki ga potrebujem, da jo lahko pospravim, ne da bi jo odpiral.

Datoteko priložiš z -f. Pripravili smo testno sliko računa (receipt.png) s temi vrsticami:

Izpis
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

Deluje tudi isti račun, shranjen kot PDF, ki vsebuje samo sliko, ker apfel na skeniranih straneh zažene prepoznavanje besedila:

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

In katera koli besedilna datoteka, na primer shell skripta:

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.

To skripto dobiš v opravilu 6. Več datotek priložiš z -f a.txt -f b.txt.

Če ne deluje: izhodna koda 4 pomeni, da je datoteka za model predolga (glej omejitve). Izhodna koda 3 pomeni, da jo je blokiral Applov varnostni filter; vodič za branje datotek za ta primer predlaga dodatek --permissive.

4. Iz navadnega stavka v shell ukaz

V 2 minutah imaš: ukaz, ki se ga nisi mogel spomniti, izpisan brez okrasja, da ga lahko kopiraš.

Ko pozabim zastavice za find, du ali tar, želim ukaz iz navadnega stavka, da lahko ostanem v terminalu.

--code izpiše samo kodo, brez razlage:

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

Zastavice so pravilne, mapo pa si je model izmislil. Tvoja domača mapa je ~ (torej: 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

Vsak ukaz preberi, preden ga zaženeš. V naših testih je model dal tudi napačne. Na prošnjo za »10 največjih datotek v trenutni mapi« je izpisal ls -lh | head -n 10, kar pokaže prvih 10 vnosov, ne največjih. Na prošnjo »pokaži odprta vrata« je predlagal netstat -tuln | grep LISTEN, ki uporablja zastavice za Linux; na macOS ne izpiše ničesar. Na Macu jih izpiše lsof -iTCP -sTCP:LISTEN -n -P.

Naprej: predstavitvena skripta cmd v opravilu 6 to zapakira in te vpraša, preden karkoli zažene (-x) ali kopira ukaz (-c).

5. JSON, ki mu tvoje skripte lahko zaupajo

V 2 minutah imaš: strukturirane podatke, izluščene iz neurejenega besedila, kot JSON, ki se vedno ujema s tvojo shemo.

Ko iz e-pošte in zapiskov potrebujem imena, številke ali datume, želim polja, ne proze, da jih lahko podam jq, preglednici ali skripti.

JSON Schema shrani kot contact.schema.json:

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

Nato besedilo pošlji po cevovodu z --schema. apfel model omeji tako, da je izpis veljaven JSON za to shemo:

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

Ključi se vrnejo v vrstnem redu, kot jih navaja tvoja shema.

Za kateri koli odgovor kot JSON z metapodatki uporabi -o json:

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

Za cel seznam uporabi --batch: na vhodu ena vrstica JSON na zapis, na izhodu ena vrstica rezultata na zapis, vsak zapis v novi seji. Tri ocene izdelkov v besedilni datoteki:

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 vsako vrstico spremeni v zapis; zadnja vrstica je apfelov povzetek na stderr. Zapis, ki ne uspe, dobi status: "error", paketna obdelava pa se nadaljuje.

Če ne deluje: apfel podpira podmnožico JSON Schema (objekti, nizi, enum, števila, logične vrednosti, polja, lokalni $ref). Pri nepodprti ključni besedi, kot je pattern, se ustavi z izhodno kodo 2 in jo poimenuje; seznam je v dokumentu o združljivosti API.

6. Avtomatiziraj dan: git, glas in pripravljene skripte

V 2 minutah imaš: povzetek svojega nedavnega dela, Mac, ki ti na glas pove, ko se dolgo opravilo konča, in osem pripravljenih AI shell skript.

Ko preklapljam med nalogami ali čakam na build, želim majhne avtomatizacije, ki stvari razložijo in sporočijo, da lahko neham buljiti v terminal.

Povzemi, kaj si delal, iz katerega koli git repozitorija:

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.

Naj Mac spregovori, ko se nekaj konča. Odgovor pošlji po cevovodu v say, svoj dolgi ukaz pa postavi pred to z &&:

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

Testni Mac ni imel zvočnega izhoda, zato smo govor posneli v datoteko (| say -o build-done.aiff, 102.880 bajtov zvoka). Izgovorjeni stavek je bil Your build is finished, and I'm glad you asked!.

apfel ima priloženih tudi osem predstavitvenih skript. Zapiši jih v mapo:

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

Ena, ki nam je bila med testiranjem všeč:

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

Vse predstavitvene skripte se v naših poskusih niso dobro odrezale: oneliner "count unique IP addresses in access.log" je naletel na omejitev dolžine in izpisal pokvarjen ukaz, explain pa je dodal sporočilo o napaki, ki se sploh ni pojavilo. README predstavitvenih skript navaja vseh osem.

7. Poganjaj svojo OpenAI kodo zastonj

V 2 minutah imaš: lokalni strežnik, ki govori OpenAI Chat Completions API, tako da obstoječa koda s SDK teče na tvojem Macu namesto na plačljivem modelu v oblaku.

Ko delam prototip z OpenAI SDK, želim brezplačno lokalno končno točko, da lahko gradim in testiram brez ključev, računov in pošiljanja podatkov drugam.

Strežnik zaženi v enem zavihku terminala:

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

V drugem zavihku ga pokliči kot 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.

Uradni OpenAI SDK za Python deluje brez sprememb. Razlikujeta se le osnovni URL in ime modela. Shrani kot 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

Strežnik posluša samo na tvojem Macu (127.0.0.1) in zavrne zahteve spletnih strani z drugih izvorov. Če ga želiš odpreti v omrežje, dodaj token: apfel --serve --host 0.0.0.0 --token-auto (vodič za varnost strežnika).

Če ne deluje: Connection refused pomeni, da strežnik ne teče. Embeddingi in stara končna točka /v1/completions vrnejo HTTP 501, ker jih model v napravi ne ponuja.

Naprej: vzdrževalci so dokumentirali nastavitve za VS Code Copilot (samo klepet), opencode, Zed ter Node.js, Ruby, PHP in še šest drugih jezikov. Za to stran jih nismo ponovno preizkusili.

8. Daj mu orodja z MCP

V 2 minutah imaš: model, ki prebere živo spletno stran in jo povzame, prek orodja Model Context Protocol.

Ko je odgovor na spletni strani, želim, da jo model pridobi sam, da lahko dobim povzetek, ne da bi prenašal besedilo sem in tja.

Namesti orodja apfel-mcp, ki so narejena za majhno kontekstno okno:

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

Eno priključi z --mcp in vprašaj. -q skrije surovi izpis orodja:

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.

Isti paket vsebuje še apfel-mcp-ddg-search (spletno iskanje), apfel-mcp-search-and-fetch in apfel-mcp-fs (branje lokalne datoteke). Deluje kateri koli MCP strežnik: pot do lokalne skripte ali URL https://.

Delujejo tudi orodja z več poimenovanimi argumenti. Tu je kalkulator iz repozitorija apfel (mcp/calculator/server.py): model pokliče multiply z obema argumentoma, apfel ga izvede, model pa odgovori z rezultatom:

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.

V vrstici tool: ti apfel pokaže klic, ki ga je izvedel. Pred apfel 1.18.0 model ni videl imen argumentov in jih je ugibal, zato je tak klic spodletel (issue #555, popravljeno v pull requestu #556). Če tukaj vidiš invalid arguments, posodobi z brew upgrade apfel.

9. Klepet za preizkus prompta

V 2 minutah imaš: pogovor v terminalu, ki si zapomni, kaj si rekel prej.

Ko oblikujem prompt za skripto, želim hitro poskusiti nekaj krogov pogovora, da lahko vidim, kako se model odziva, preden ga avtomatiziram.

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.

Persono dodaš z -s, na primer apfel --chat -s "You are a patient Python tutor". Ko dolg klepet preraste kontekstno okno, apfel privzeto izpusti najstarejše kroge; vodič o kontekstu razloži druge strategije. Za okno z gumbi glej apfel-chat.

10. Naj strežnik teče v ozadju

V 2 minutah imaš: strežnik, združljiv z OpenAI, ki se sam zažene ob prijavi in je vedno pripravljen na vratih 11434.

Ko orodja na mojem Macu vsak dan uporabljajo lokalno končno točko, želim, da je vedno vklopljena, da mi je ni treba več zaganjati ročno.

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)

Nastavitve, kot so vrata, token ali MCP strežniki, so okoljske spremenljivke, na primer APFEL_PORT=8080 brew services start apfel. Vse so naštete v vodiču za storitev v ozadju.

11. Aplikacije, zgrajene na apfel

V 2 minutah imaš: isti model v napravi v oknu, v menijski vrstici ali na bližnjični tipki, če imaš raje aplikacije kot terminal.

Prihajajo od istih vzdrževalcev (»apfel tree« v README). 15. novembra 2026 smo preverili, da vsako namestitveno ime obstaja v Homebrew; aplikacij za to stran nismo testirali.

Aplikacija Kaj počne Namestitev
apfel-chat Aplikacija za klepet s sprotnimi odgovori, govorom in analizo slik brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Dejanja nad odložiščem v menijski vrstici: povzemi, prevedi, preoblikuj brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Pritisni tipko, vprašaj, dobi odgovor, zapri brew install Arthur-Ficial/tap/apfel-quick
apfelpad Beležnica, v kateri je AI formula, ki jo vstaviš v celico brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Orodja MCP, prilagojena majhnemu oknu (opravilo 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel s shranjeno konfiguracijo in seznamom MCP strežnikov brew install Arthur-Ficial/tap/apfel-run
apfel-tag Oznake, teme in čustva za vsako besedilo, ki ga pošlješ po cevovodu brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Okno za razhroščevanje: zahteve, sporočila MCP, govor brew install Arthur-Ficial/tap/apfel-gui

Omejitve in iskreni odgovori

apfel ti da Applov model v napravi. README navaja približno 3 milijarde parametrov, kar je precej manj od modelov v oblaku, na katerih temeljita ChatGPT in Claude. Dober je pri kratkih, osredotočenih besedilnih opravilih. To so omejitve, na katere smo naleteli ali ki jih navaja dokumentacija.

Kontekstno okno je majhno. Vprašanje in odgovor morata skupaj zasesti največ 4.096 tokenov na macOS 26 ter na Macih z M1 in M2 ali 8.192 tokenov na Macih z M3 ali novejšim z vsaj 12 GB in macOS 27 (README). apfel --model-info pokaže, koliko ga imaš ti. Že apfelov lastni README je zanj predolg. Preštej, preden pošlješ:

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

3.584 je okno 4.096 minus 512 tokenov, rezerviranih za odgovor. README ima približno 3.000 besed, a Markdown in koda porabita veliko tokenov na besedo. Dolge datoteke pošiljaj po delih (head -c 6000 file), po en razdelek naenkrat.

Ne pozna današnjega datuma. Izmislil si ga je:

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.

Vsako dejstvo, ki ga potrebuje, mu daj v promptu. Interneta nima, razen če priključiš orodje MCP.

Včasih se moti, in to samozavestno. Videl si že zgoraj: napačni shell ukazi v opravilu 4, prevod, ki je obrnil pomen, v opravilu 2. Preveri vse, kar je pomembno.

Applov varnostni filter lahko blokira nedolžno besedilo. apfel se takrat ustavi z izhodno kodo 3 in sporočilom The request was blocked by Apple's safety guardrails. Preoblikuj ali za ustvarjalno pisanje in dokumente dodaj --permissive; dokument o varovalih razloži, kaj to spremeni. V poskusih za to stran nismo naleteli na nobeno blokado.

Odgovori so pri vsakem zagonu drugačni. To so pravi izpisi, vsak iz enega zagona. Tvoji bodo drugače ubesedeni. Za bolj ponovljive odgovore uporabi --temperature 0; apfel ne obljublja enakega izpisa med zagoni ali posodobitvami macOS (pravilnik o stabilnosti).

Hitrost: večina odgovorov je v naših poskusih prišla v 1 do 2 sekundah. Povzetek spletne strani z orodjem MCP je trajal 8 sekund.

Zahteve so stroge: samo Apple Silicon, macOS 26 ali novejši, vklopljen Apple Intelligence in eden od 15 jezikov, ki jih navaja --model-info. Na Macih z Intelom ne teče.

Ko kaj ne deluje

apfel težave sporoči z izhodno kodo, da se lahko skripte nanje odzovejo. Preveri jo z echo $? takoj po ukazu.

Izhodna koda ali napaka Pomen Kaj narediti
2 Napačna zastavica ali možnost Zastavice gredo pred prompt; apfel --help jih našteje
3 Applov varnostni filter je blokiral zahtevo Preoblikuj ali dodaj --permissive
4 Vhod je predolg za kontekstno okno Pošlji manj besedila; preveri z apfel --count-tokens
5 Model ni na voljo Vklopi Apple Intelligence, počakaj na prenos, poenoti jezik Maca in Siri
6 Model je zaseden ali omejen po številu zahtev Počakaj in poskusi znova ali dodaj --retry
Connection refused Na vratih 11434 ni strežnika Zaženi apfel --serve ali brew services start apfel
HTTP 501 Končna točka, ki je model v napravi ne ponuja (embeddingi, /v1/completions) Uporabi /v1/chat/completions
piped input was empty Ukaz je pisal na stderr command 2>&1 \| apfel "..."

Še vedno ne gre? Poišči ali odpri issue na GitHubu.

Kdo je to naredil in kako smo testirali

apfel je brezplačen in odprtokoden (licenca MIT), projekt franzai, ki ga je ustvaril Franz Enzenhofer. Franz ga vzdržuje skupaj s svojim AI asistentom Arthurjem Ficialom, ki je napisal tudi ta vodič. Ker so to stran napisali avtorji apfel, smo navedli vsak neuspeh, ki smo ga videli, namesto da bi ga zamolčali.

Kako smo testirali: 15. novembra 2026 smo vsak ukaz s te strani zagnali na MacBook Air M2 (24 GB) z macOS 27.0.1 (build 26A434). Uporabili smo podpisano binarko apfel 1.18.0 iz izdaje na GitHubu (isto datoteko, ki jo namesti Homebrew tap), v pravi seji terminala, in izpis kopirali nespremenjen. Prva različica te strani (14. novembra 2026, apfel 1.16.0) je pokazala napako z orodji z več argumenti v opravilu 8; 1.18.0 jo odpravi, zato smo za to različico vse ukaze zagnali znova. Kjer je bil prvi izpis napačen, smo napačni izpis pustili na strani in to povedali. Ponovne zagone smo naredili le zato, da bi našli odgovore, ki niso potrebovali urejanja: en povzetek spletne strani je vseboval dolg pomišljaj, ki ga ta stran ne prikazuje, zato smo ga zagnali znova in obdržali tretji zagon. Primer z govorom smo preverili tako, da smo zvok zapisali v datoteko, ker testni Mac ni imel zvočnega izhoda. Predstavitvene skripte je zapisal apfel --demos iz apfel 1.18.0.

Kaj so o apfel napisali drugi: objava Show HN (3. aprila 2026, 743 točk), vodič Better Stack, članek GIGAZINE in praktična recenzija na danilchenko.dev.

Viri: README apfel, referenca CLI, navodila za namestitev, predstavitvene skripte, apfel proti Applovemu fm in sledilnik težav, prebrano 15. novembra 2026.