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.
Na tej strani: 15 razdelkov
- Prvi odgovor v 60 sekundah
- 1. Vprašaj Mac o njem samem
- 2. Popravi besedilo, ki si ga kopiral
- 3. Beri račune, PDF-je in skripte
- 4. Iz navadnega stavka v shell ukaz
- 5. JSON, ki mu tvoje skripte lahko zaupajo
- 6. Avtomatiziraj dan: git, glas in pripravljene skripte
- 7. Poganjaj svojo OpenAI kodo zastonj
- 8. Daj mu orodja z MCP
- 9. Klepet za preizkus prompta
- 10. Naj strežnik teče v ozadju
- 11. Aplikacije, zgrajene na apfel
- Omejitve in iskreni odgovori
- Ko kaj ne deluje
- 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:
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:
brew install apfelPostavi prvo vprašanje:
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:
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:
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.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:
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:
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.20Deluje tudi isti račun, shranjen kot PDF, ki vsebuje samo sliko, ker apfel na skeniranih straneh zažene prepoznavanje besedila:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20In katera koli besedilna datoteka, na primer shell skripta:
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:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MZastavice so pravilne, mapo pa si je model izmislil. Tvoja domača mapa je ~ (torej: 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 resultVsak 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:
{
"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:
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:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelZa 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:
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 failedjq -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:
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 &&:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayTestni 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:
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
• wtdEna, ki nam je bila med testiranjem všeč:
./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 pauseVse 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:
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:11434V drugem zavihku ga pokliči kot OpenAI:
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.Uradni OpenAI SDK za Python deluje brez sprememb. Razlikujeta se le osnovni URL in ime modela. Shrani kot hello.py:
from openai import OpenAI
client = OpenAI(base_url="http://localhost:11434/v1", api_key="unused")
reply = client.chat.completions.create(
model="apple-foundationmodel",
messages=[{"role": "user", "content": "Give me three names for a coffee shop run by robots."}],
)
print(reply.choices[0].message.content)python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew
2. CogCafé
3. Circuit SipStrež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:
brew install Arthur-Ficial/tap/apfel-mcpEno priključi z --mcp in vprašaj. -q skrije surovi izpis orodja:
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:
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.
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.
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š:
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: 43.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:
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.