apfel je projekt .

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.

Skutočný záznam terminálu, nič nestrihané: apfel 1.18.0 na macOS 27.0.1, MacBook Air M2.
Na tejto stránke: 15 sekcií
  1. Prvá odpoveď za 60 sekúnd
  2. 1. Nech ti Mac povie o sebe
  3. 2. Oprav akýkoľvek skopírovaný text
  4. 3. Čítaj účtenky, PDF a skripty
  5. 4. Z bežnej vety na príkaz shellu
  6. 5. JSON, na ktorý sa skripty môžu spoľahnúť
  7. 6. Automatizuj si deň: git, hlas a hotové skripty
  8. 7. Spúšťaj svoj OpenAI kód zadarmo
  9. 8. Daj mu nástroje cez MCP
  10. 9. Chatuj a otestuj si prompt
  11. 10. Nechaj server bežať na pozadí
  12. 11. Aplikácie postavené na apfel
  13. Limity a poctivé odpovede
  14. Keď niečo zlyhá
  15. 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:

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

Verzia 26 alebo vyššia a arm64 znamenajú, že môžeš začať. Nainštaluj apfel cez Homebrew. Žiadny Xcode, žiadny účet, žiadny API kľúč:

Terminál
brew install apfel

Polož prvú otázku:

Terminál
apfel "In one sentence: what can a small on-device language model do for me?"
A small on-device language model can help you perform tasks like text translation, summarization, and data analysis directly on your device.

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ý:

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

Ak 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ť:

Terminál
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
Terminál
ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU, one sentence"
`/System/Library/CoreServices/RemoteManagement/screensharingd.bundle/Contents/MacOS/screensharingd` is using the most CPU.

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:

Terminál
printf 'can u send me the slides from yesterdays meeting i lost them' | pbcopy
pbpaste | apfel "Rewrite the text above with correct grammar and spelling. Reply with the rewritten text only." | pbcopy
pbpaste
Can you send me the slides from yesterday’s meeting? I lost them.

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:

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

Funguje 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:

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

A ľubovoľný textový súbor, napríklad shellový skript:

Terminál
apfel -f apfel-demos/gitsum "What does this script do? Two sentences."
This script summarizes recent Git activity by summarizing the last N commits, grouping related changes, and generating a concise report. It uses Apple Intelligence to format the output, and optionally copies the summary to the clipboard.

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:

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

Prepínače sedia, ale priečinok si model vymyslel. Tvoj domovský priečinok je ~ (tu: find ~ -type f -size +100M).

Terminál
apfel --code "a python function that removes duplicates from a list but keeps the order"
def remove_duplicates_preserve_order(lst):
    seen = set()
    result = []
    for item in lst:
        if item not in seen:
            seen.add(item)
            result.append(item)
    return result

Kaž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:

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:

Terminál
echo "Hi, I am Maria Lopez from Vienna, call me on +43 660 1234567" | apfel --schema contact.schema.json "Extract the contact" | jq .
{
  "name": "Maria Lopez",
  "city": "Vienna",
  "phone": "+43 660 1234567"
}

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:

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

Na 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:

Terminál
cat reviews.txt
Love it, works offline and it is fast.
Crashes every time I open a PDF.
It is okay, it does the job.
jq -Rc '{custom_id: (input_line_number|tostring), prompt: ("Classify the sentiment of this review as positive, negative or neutral. Reply with one word. Review: " + .)}' reviews.txt | apfel --batch | jq -r '"\(.custom_id) \(.status) \(.content)"'
1 ok Positive
2 ok Negative
3 ok Neutral
apfel: batch: 3 records, 3 ok, 0 failed

jq -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:

Terminál
git log --oneline -10 | apfel "summarize what I have been working on, two sentences"
I've been updating star counts to 6,608 and refining ISO datetimes with timezone handling in the Article JSON-LD. Additionally, I've implemented the apfel AI tutorial and redesigned the pre-header with a centered line about the project.

Nechaj Mac prehovoriť, keď niečo skončí. Pošli odpoveď rúrou do say a svoj dlhý príkaz daj pred to cez &&:

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

Testovací 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:

Terminál
apfel --demos
apfel: wrote 9 demo files to /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/apfel-demos
  • cmd
  • explain
  • gitsum
  • mac-narrator
  • naming
  • oneliner
  • port
  • wtd

Jeden, ktorý sa nám pri testovaní páčil:

Terminál
./apfel-demos/naming "function that retries HTTP requests with exponential backoff"
retryExponentialBackoff | exponential_retry_backoff | exponential delay retry  
retryWithExponentialBackoff | exponential_retry_http_backoff | HTTP retry with delay  
backoffRetryHTTP | exponential_http_retry | retry with exponential pause

Nie 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:

Terminál
apfel --serve
apfel server v1.18.0
├ endpoint: http://127.0.0.1:11434
├ model:    apple-foundationmodel
├ cors:     disabled
├ origin:   localhost only (http://127.0.0.1, http://localhost, http://[::1])
├ token:    none
├ health:   public
├ max concurrent: 5
├ debug:    off
└ ready

Endpoints:
  POST http://127.0.0.1:11434/v1/chat/completions
  GET  http://127.0.0.1:11434/v1/models
  GET  http://127.0.0.1:11434/health

2026-11-15T13:39:31+0100 info Hummingbird: [HummingbirdCore] Server started and listening on 127.0.0.1:11434

V druhej karte ho zavolaj ako OpenAI:

Terminál
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.

Oficiálne OpenAI SDK pre Python funguje bez zmien. Líši sa len základné URL a názov modelu. Ulož ako 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)
Terminál
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

Server 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:

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

Pripoj jeden cez --mcp a pýtaj sa. -q skryje surový výstup nástroja:

Terminál
apfel -q --mcp $(which apfel-mcp-url-fetch) "Summarize https://apfel.franzai.com/ in 3 bullets"
- **Purpose**: apfel is a Swift 6.3 tool that wraps Apple’s on-device LLM (part of macOS 26’s Apple Intelligence) and exposes it via a CLI, HTTP server, and interactive chat with context management.  
- **Features**: It handles terminal commands, JSON output, file attachments, real token counting, and context trimming (4,096 or 8,192 tokens depending on hardware), while converting OpenAI tool schemas to Apple’s native format.  
- **Technical details**: Built using the FoundationModels framework, it runs on Apple Silicon’s Neural Engine and GPU without network or cloud dependencies, and is open-source under MIT license.

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:

Terminál
apfel --mcp ./server.py "What is 15 times 27?"
mcp: /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/./server.py - add, subtract, multiply, divide, sqrt, power, round_number
tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

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.

Terminál
apfel --chat
Apple Intelligence · on-device LLM · apfel v1.18.0
────────────────────────────────────────────────────────
Type 'quit' to exit.

you› My name is Franz. I live in Vienna.
 ai› Hello, Franz. It's nice to meet you. I'm here to help with any questions or tasks you might have. How can I assist you today?

you› Suggest one thing I could do there this weekend. One sentence.
 ai› You could visit the Kunsthistorisches Museum to explore its impressive collection of art and artifacts.

you› What is my name?
 ai› Your name is Franz.

you› quit

Goodbye.

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.

Terminál
brew services start apfel
==> Successfully started `apfel` (label: sh.brew.apfel)
curl -s http://127.0.0.1:11434/health | jq -c '{status, model_available, context_window}'
{"status":"ok","model_available":true,"context_window":4096}
brew services stop apfel
Stopping `apfel`... (might take a while)
==> Successfully stopped `apfel` (label: sh.brew.apfel)

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:

Terminál
apfel --count-tokens -f README.md "summarize in 3 bullets"
8272/3584 tokens (over budget)
  prompt=7, README.md=8258
apfel -f README.md "summarize in 3 bullets"; echo "exit code: $?"
error: [context overflow] Input exceeds the model's context window: the input is 8264 tokens, the window is 4096 tokens. Shorten the conversation history.
exit code: 4

Tý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:

Terminál
apfel "What is today's date?"
Today's date is October 27, 2024.
apfel -s "Today is $(date '+%B %d, %Y')." "What is today's date? One sentence."
Today's date is November 15, 2026.

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.