Návod · otestované 15. novembra 2026
Návod na AI apfel
Prvá odpoveď od AI, ktorú už máš v Macu, za 60 sekúnd. Potom 11 úloh, ktoré zvláda dobre, každá pripravená na skopírovanie aj so skutočným výstupom, a poctivý zoznam toho, čo nedokáže.
Na tejto stránke: 15 sekcií
- Prvá odpoveď za 60 sekúnd
- 1. Nech ti Mac povie o sebe
- 2. Oprav akýkoľvek skopírovaný text
- 3. Čítaj účtenky, PDF a skripty
- 4. Z bežnej vety na príkaz shellu
- 5. JSON, na ktorý sa skripty môžu spoľahnúť
- 6. Automatizuj si deň: git, hlas a hotové skripty
- 7. Spúšťaj svoj OpenAI kód zadarmo
- 8. Daj mu nástroje cez MCP
- 9. Chatuj a otestuj si prompt
- 10. Nechaj server bežať na pozadí
- 11. Aplikácie postavené na apfel
- Limity a poctivé odpovede
- Keď niečo zlyhá
- Kto to vytvoril a ako sa to testovalo
Prvá odpoveď za 60 sekúnd
Potrebuješ Mac s Apple Silicon (M1 alebo novší) s macOS 26 Tahoe alebo novším a zapnutú Apple Intelligence (Systémové nastavenia > Apple Intelligence & Siri). Prvé dve podmienky overíš jedným riadkom:
sw_vers -productVersion && uname -m
27.0.1
arm64Verzia 26 alebo vyššia a arm64 znamenajú, že môžeš začať. Nainštaluj apfel cez Homebrew. Žiadny Xcode, žiadny účet, žiadny API kľúč:
brew install apfelPolož prvú otázku:
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.Túto odpoveď dal model od Apple priamo v tvojom Macu. Nič neodišlo na server a nestálo to ani cent.
Ak to nefunguje: opýtaj sa apfel, či je model pripravený:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensAk vypíše available: no, zapni Apple Intelligence v Systémových nastaveniach a počkaj, kým sa model celý stiahne (podľa inštalačnej príručky má 3 až 4 GB). Jazyk Macu a jazyk Siri musia byť ten istý podporovaný jazyk. Kým model nie je dostupný, apfel končí s návratovým kódom 5.
Ďalej: úlohy nižšie. Každá začína tým, čo budeš mať po dvoch minútach.
1. Nech ti Mac povie o sebe
Za 2 minúty máš: zrozumiteľné odpovede o disku, CPU a pamäti, priamo z príkazov, ktoré už poznáš.
Keď príkaz v termináli vychrlí stenu čísel, chcem odpoveď na jeden riadok, aby som mohol konať bez čítania man stránky.
Pošli rúrou do apfel výstup ľubovoľného príkazu a povedz, čo chceš vedieť:
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.Vstup drž malý: najprv head, awk a grep, až potom apfel. Model naraz prečíta len pár tisíc slov, pri kóde ešte menej (pozri limity).
Ak to nefunguje: niektoré príkazy píšu na stderr a ten rúra neprenáša. apfel ťa na to upozorní: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.
Ďalej: rovnaký trik funguje s git log, lsof, pmset -g batt, logmi a so všetkým ostatným, čo vypisuje text.
2. Oprav akýkoľvek skopírovaný text
Za 2 minúty máš: príkaz, ktorý opraví gramatiku toho, čo máš v schránke, v ľubovoľnej aplikácii.
Keď narýchlo napíšem správu v Slacku, Maili alebo prehliadači, chcem ju mať učesanú bez otvárania ďalšej aplikácie, aby som ju mohol o pár sekúnd vložiť späť.
Skopíruj nejaký text a spusti prostredný riadok. pbpaste číta schránku, pbcopy do nej zapíše výsledok:
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.Prečo „the text above“: apfel dá text z rúry na začiatok a tvoj pokyn až zaň (zdrojový kód). S krátkym pokynom "fix grammar and spelling, reply with the corrected text only" model na správu odpovedal, namiesto toho, aby ju opravil, a napísal Could you let me know which meeting you're referring to?. V našom teste to vyriešilo, keď sme pomenovali text, s ktorým má pracovať.
Ak to nefunguje: výsledok si pred odoslaním prečítaj. Malý model občas zmení význam; keď sme ho požiadali o preklad tejto vety do nemčiny, z „Can you send me“ urobil „Can I send you“.
Ďalej: daj prostredný riadok do shellového aliasu alebo do akcie „Spustiť skript shellu“ v aplikácii Skratky a priraď mu klávesovú skratku.
3. Čítaj účtenky, PDF a skripty
Za 2 minúty máš: odpovede o obrázku, naskenovanom PDF alebo skripte, prečítanom priamo v Macu rozpoznávaním textu od Apple.
Keď mi do priečinka Stiahnuté pristane účtenka, sken alebo neznámy súbor, chcem z neho ten jeden údaj, ktorý potrebujem, aby som ho mohol založiť bez otvárania.
Súbor pripojíš cez -f. Vyrobili sme testovací obrázok účtenky (receipt.png) s týmito riadkami:
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.20Funguje aj tá istá účtenka uložená ako PDF len s obrázkom, pretože apfel na naskenovaných stranách spúšťa rozpoznávanie textu:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20A ľubovoľný textový súbor, napríklad shellový skript:
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.Tento skript dostaneš v úlohe 6. Viac súborov pripojíš cez -f a.txt -f b.txt.
Ak to nefunguje: návratový kód 4 znamená, že súbor je na model príliš dlhý (pozri limity). Návratový kód 3 znamená, že ho zablokoval bezpečnostný filter Apple; príručka k extrakcii zo súborov pre taký prípad odporúča pridať --permissive.
4. Z bežnej vety na príkaz shellu
Za 2 minúty máš: príkaz, na ktorý si si nevedel spomenúť, vypísaný holý, aby si ho mohol skopírovať.
Keď zabudnem prepínače find, du alebo tar, chcem dostať príkaz z obyčajnej vety, aby som nemusel opustiť terminál.
--code vypíše len kód, bez vysvetľovania:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MPrepínače sedia, ale priečinok si model vymyslel. Tvoj domovský priečinok je ~ (tu: 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 resultKaždý príkaz si pred spustením prečítaj. V našich testoch model vygeneroval aj chybné príkazy. Na požiadavku „the 10 largest files in the current folder“ vypísal ls -lh | head -n 10, čo zobrazí prvých 10 položiek, nie najväčšie. Na „show open ports“ navrhol netstat -tuln | grep LISTEN, ktorý používa linuxové prepínače; na macOS nevypíše vôbec nič. Na Macu ich zobrazí lsof -iTCP -sTCP:LISTEN -n -P.
Ďalej: ukážkový skript cmd z úlohy 6 toto obaľuje a pred spustením sa opýta (-x), prípadne príkaz skopíruje (-c).
5. JSON, na ktorý sa skripty môžu spoľahnúť
Za 2 minúty máš: štruktúrované dáta vytiahnuté z neupraveného textu ako JSON, ktorý vždy zodpovedá tvojej schéme.
Keď potrebujem z e-mailov a poznámok dostať mená, čísla alebo dátumy, chcem polia, nie súvislý text, aby som ich mohol poslať do jq, tabuľky alebo skriptu.
Ulož JSON Schema ako contact.schema.json:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"city": { "type": "string" },
"phone": { "type": "string" }
},
"required": ["name", "city", "phone"]
}Potom pošli text rúrou s prepínačom --schema. apfel model obmedzí tak, aby bol výstup platný JSON podľa tejto schémy:
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"
}Kľúče sa vrátia v poradí, v akom ich deklaruje tvoja schéma.
Ak chceš ľubovoľnú odpoveď ako JSON s metadátami, použi -o json:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelNa celý zoznam použi --batch: na vstupe jeden riadok JSON na záznam, na výstupe jeden riadok s výsledkom na záznam, každý záznam v novej relácii. Tri recenzie produktu v textovom súbore:
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 urobí z každého riadka záznam; posledný riadok je súhrn od apfel na stderr. Záznam, ktorý zlyhá, dostane status: "error" a dávka pokračuje ďalej.
Ak to nefunguje: apfel podporuje podmnožinu JSON Schema (objekty, reťazce, enumy, čísla, booleany, polia, lokálne $ref). Nepodporované kľúčové slovo, napríklad pattern, skončí s návratovým kódom 2 a apfel ho pomenuje; zoznam nájdeš v dokumente o kompatibilite API.
6. Automatizuj si deň: git, hlas a hotové skripty
Za 2 minúty máš: zhrnutie svojej nedávnej práce, Mac, ktorý ti nahlas povie, keď dlhá úloha skončí, a osem hotových AI shellových skriptov.
Keď prepínam medzi úlohami alebo čakám na build, chcem malé automatizácie, ktoré veci vysvetlia a ohlásia, aby som nemusel stále sledovať terminál.
Zhrň, čo si robil, priamo v ľubovoľnom git repozitári:
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.Nechaj Mac prehovoriť, keď niečo skončí. Pošli odpoveď rúrou do say a svoj dlhý príkaz daj pred to cez &&:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayTestovací Mac nemal zvukový výstup, preto sme reč namiesto toho nahrali do súboru (| say -o build-done.aiff, 102 880 bajtov zvuku). Vyslovená veta znela Your build is finished, and I'm glad you asked!.
apfel obsahuje aj osem ukážkových skriptov. Zapíš ich do priečinka:
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
• wtdJeden, ktorý sa nám pri testovaní páčil:
./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 pauseNie každá ukážka v našich behoch dopadla dobre: oneliner "count unique IP addresses in access.log" narazil na limit dĺžky a vypísal pokazený príkaz a explain pridal chybové hlásenie, ktoré neexistovalo. Všetkých osem nájdeš v README k ukážkam.
7. Spúšťaj svoj OpenAI kód zadarmo
Za 2 minúty máš: lokálny server, ktorý hovorí jazykom OpenAI Chat Completions API, takže existujúci kód so SDK beží na tvojom Macu namiesto plateného cloudového modelu.
Keď robím prototyp s OpenAI SDK, chcem lokálny endpoint zadarmo, aby som mohol vyvíjať a testovať bez kľúčov, faktúr a bez posielania dát preč.
Spusti server v jednej karte terminálu:
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 druhej karte ho zavolaj ako 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.Oficiálne OpenAI SDK pre Python funguje bez zmien. Líši sa len základné URL a názov modelu. Ulož ako 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 SipServer počúva len na tvojom vlastnom Macu (127.0.0.1) a odmieta požiadavky z webových stránok z iných originov. Ak ho chceš otvoriť do siete, pridaj token: apfel --serve --host 0.0.0.0 --token-auto (príručka k bezpečnosti servera).
Ak to nefunguje: Connection refused znamená, že server nebeží. Embeddingy a starý endpoint /v1/completions vracajú HTTP 501, pretože model v zariadení ich neponúka.
Ďalej: správcovia majú zdokumentované nastavenie pre VS Code Copilot (len chat), opencode, Zed a Node.js, Ruby, PHP a šesť ďalších jazykov. Pre túto stránku sme ich znova netestovali.
8. Daj mu nástroje cez MCP
Za 2 minúty máš: model, ktorý cez nástroj Model Context Protocol prečíta živú webovú stránku a zhrnie ju.
Keď je odpoveď na webovej stránke, chcem, aby si ju model stiahol sám, aby som dostal zhrnutie bez prekopírovávania textu.
Nainštaluj nástroje apfel-mcp, ktoré sú stavané tak, aby sa zmestili do malého kontextového okna:
brew install Arthur-Ficial/tap/apfel-mcpPripoj jeden cez --mcp a pýtaj sa. -q skryje surový výstup nástroja:
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.V tom istom balíku sú aj apfel-mcp-ddg-search (vyhľadávanie na webe), apfel-mcp-search-and-fetch a apfel-mcp-fs (čítanie lokálneho súboru). Funguje akýkoľvek MCP server: cesta k lokálnemu skriptu alebo URL https://.
Fungujú aj nástroje s viacerými pomenovanými argumentmi. Tu je kalkulačka z repozitára apfel (mcp/calculator/server.py): model zavolá multiply s oboma argumentmi, apfel ho spustí a model odpovie výsledkom:
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.Riadkom tool: ti apfel ukazuje volanie, ktoré vykonal. Pred apfel 1.18.0 model názvy argumentov nevidel a hádal ich, takže takéto volanie zlyhalo (issue #555, opravené v pull requeste #556). Ak tu uvidíš invalid arguments, aktualizuj cez brew upgrade apfel.
9. Chatuj a otestuj si prompt
Za 2 minúty máš: konverzáciu v termináli, ktorá si pamätá, čo si povedal predtým.
Keď ladím prompt pre skript, chcem rýchlo vyskúšať pár kôl, aby som videl, ako model reaguje, skôr než to zautomatizujem.
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.Rolu mu priradíš cez -s, napríklad apfel --chat -s "You are a patient Python tutor". Keď dlhý chat prerastie kontextové okno, apfel predvolene zahodí najstaršie kolá; ostatné stratégie vysvetľuje príručka ku kontextu. Ak chceš okno s tlačidlami, pozri apfel-chat.
10. Nechaj server bežať na pozadí
Za 2 minúty máš: server kompatibilný s OpenAI, ktorý sa sám spustí po prihlásení a je vždy pripravený na porte 11434.
Keď nástroje v mojom Macu používajú lokálny endpoint každý deň, chcem, aby bol stále zapnutý, aby som ho nemusel spúšťať ručne.
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)Nastavenia ako port, token alebo MCP servery sú premenné prostredia, napríklad APFEL_PORT=8080 brew services start apfel. Všetky sú uvedené v príručke k službe na pozadí.
11. Aplikácie postavené na apfel
Za 2 minúty máš: ten istý model v zariadení v okne, v lište menu alebo pod klávesovou skratkou, ak máš radšej aplikácie než terminál.
Pochádzajú od tých istých správcov („strom apfel“ v README). 15. novembra 2026 sme overili, že každý inštalačný názov v Homebrew existuje; samotné aplikácie sme pre túto stránku netestovali.
| Aplikácia | Čo robí | Inštalácia |
|---|---|---|
| apfel-chat | Chatovacia aplikácia so streamovanými odpoveďami, rečou a analýzou obrázkov | brew install Arthur-Ficial/tap/apfel-chat |
| apfel-clip | Akcie so schránkou z lišty menu: zhrnúť, preložiť, preformulovať | brew install Arthur-Ficial/tap/apfel-clip |
| apfel-quick | Stlač kláves, opýtaj sa, dostaň odpoveď, zavri | brew install Arthur-Ficial/tap/apfel-quick |
| apfelpad | Poznámkový blok, v ktorom je AI vzorec vložený do bunky | brew install Arthur-Ficial/tap/apfelpad |
| apfel-mcp | Nástroje MCP dimenzované na malé okno (úloha 8) | brew install Arthur-Ficial/tap/apfel-mcp |
| apfel-run | apfel s uloženou konfiguráciou a zoznamom MCP serverov | brew install Arthur-Ficial/tap/apfel-run |
| apfel-tag | Štítky, témy a emócie pre akýkoľvek text poslaný rúrou | brew install Arthur-Ficial/tap/apfel-tag |
| apfel-gui | Ladiace okno: požiadavky, správy MCP, reč | brew install Arthur-Ficial/tap/apfel-gui |
Limity a poctivé odpovede
apfel ti sprístupní model od Apple v zariadení. Podľa README má okolo 3 miliárd parametrov, teda oveľa menej než cloudové modely, na ktorých bežia ChatGPT alebo Claude. Dobre zvláda krátke, cielené úlohy s textom. Toto sú limity, na ktoré sme narazili alebo ktoré uvádza dokumentácia.
Kontextové okno je malé. Otázka spolu s odpoveďou sa musí zmestiť do 4 096 tokenov na macOS 26 a na Macoch s M1 a M2, alebo do 8 192 tokenov na Macoch s M3 alebo novším čipom, aspoň 12 GB pamäte a macOS 27 (README). apfel --model-info ukáže, koľko máš ty. Vlastné README apfel je naň príliš dlhé. Pred odoslaním si to spočítaj:
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: 4Tých 3 584 je okno 4 096 mínus 512 tokenov rezervovaných na odpoveď. README má okolo 3 000 slov, ale Markdown a kód stoja veľa tokenov na slovo. Dlhé súbory posielaj po častiach (head -c 6000 file), vždy po jednej sekcii.
Nepozná dnešný dátum. Nejaký si vymyslel:
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.Každý fakt, ktorý potrebuje, mu daj v prompte. Na internet sa nedostane, kým nepripojíš nástroj MCP.
Občas sa mýli, a to sebavedome. Videl si to vyššie: chybné príkazy shellu v úlohe 4, preklad, ktorý obrátil význam, v úlohe 2. Všetko, na čom záleží, si over.
Bezpečnostný filter Apple môže zablokovať aj neškodný text. apfel potom skončí s návratovým kódom 3 a hlásením The request was blocked by Apple's safety guardrails. Preformuluj to, alebo pri tvorivom písaní a dokumentoch pridaj --permissive; čo presne mení, vysvetľuje dokument o guardrails. Pri behoch pre túto stránku sme na blokovanie nenarazili.
Odpovede sa pri každom spustení líšia. Toto sú skutočné výstupy, každý z jedného behu. Tvoje budú sformulované inak. Pre opakovateľnejšie odpovede použi --temperature 0; apfel nesľubuje rovnaký výstup naprieč behmi ani aktualizáciami macOS (zásady stability).
Rýchlosť: väčšina odpovedí v našich behoch prišla za 1 až 2 sekundy. Zhrnutie webovej stránky s nástrojom MCP trvalo 8 sekúnd.
Požiadavky sú prísne: len Apple Silicon, macOS 26 alebo novší, zapnutá Apple Intelligence a jeden z 15 jazykov, ktoré vypíše --model-info. Na Macoch s Intelom nebeží.
Keď niečo zlyhá
apfel hlási problémy návratovým kódom, takže skripty môžu reagovať. Over si ho cez echo $? hneď po príkaze.
| Návratový kód alebo chyba | Význam | Čo robiť |
|---|---|---|
2 |
Nesprávny prepínač alebo voľba | Prepínače patria pred prompt; apfel --help ich vypíše |
3 |
Bezpečnostný filter Apple zablokoval požiadavku | Preformuluj, alebo pridaj --permissive |
4 |
Vstup je na kontextové okno príliš dlhý | Pošli menej textu; over cez apfel --count-tokens |
5 |
Model nie je dostupný | Zapni Apple Intelligence, počkaj na stiahnutie, zjednoť jazyk Macu a Siri |
6 |
Model je zaneprázdnený alebo narazil na limit požiadaviek | Počkaj a spusti znova, alebo pridaj --retry |
Connection refused |
Na porte 11434 nebeží žiadny server | Spusti apfel --serve alebo brew services start apfel |
| HTTP 501 | Endpoint, ktorý model v zariadení neponúka (embeddingy, /v1/completions) |
Použi /v1/chat/completions |
piped input was empty |
Príkaz písal na stderr | command 2>&1 \| apfel "..." |
Stále si zaseknutý? Vyhľadaj alebo založ issue na GitHube.
Kto to vytvoril a ako sa to testovalo
apfel je zadarmo a open source (licencia MIT), projekt franzai od Franza Enzenhofera. Spravuje ho spolu s Arthurom Ficialom, Franzovým AI asistentom, ktorý napísal aj tento návod. Keďže túto stránku napísali sami tvorcovia apfel, uviedli sme každé zlyhanie, ktoré sme videli, namiesto toho, aby sme ho vynechali.
Ako sme testovali: 15. novembra 2026 sme každý príkaz z tejto stránky spustili na MacBooku Air M2 (24 GB) s macOS 27.0.1 (build 26A434). Použili sme podpísanú binárku apfel 1.18.0 z vydania na GitHube (ten istý súbor, ktorý inštaluje tap Homebrew), v skutočnej relácii terminálu, a výstup sme skopírovali bez zmien. Prvá verzia tejto stránky (14. novembra 2026, apfel 1.16.0) ukazovala chybu nástrojov s viacerými argumentmi v úlohe 8; 1.18.0 ju opravuje, preto sme pre túto verziu spustili znova každý príkaz. Kde bol prvý výstup chybný, nechali sme chybný výstup na stránke a upozornili sme na to. Jediné opakované behy slúžili na nájdenie odpovedí, ktoré netreba upravovať: jedno zhrnutie webovej stránky obsahovalo dlhú pomlčku, ktorú tento web nezobrazuje, tak sme ho spustili znova a ponechali tretí beh. Príklad s rečou sme overili zapísaním zvuku do súboru, pretože testovací Mac nemal zvukový výstup. Ukážkové skripty zapísal apfel --demos z apfel 1.18.0.
Čo o apfel napísali iní: príspevok Show HN (3. apríla 2026, 743 bodov), príručka od Better Stack, článok od GIGAZINE a praktická recenzia na danilchenko.dev.
Zdroje: README apfel, referencia CLI, inštalačná príručka, ukážkové skripty, apfel vs fm od Apple a issue tracker, prečítané 15. novembra 2026.