apfel je projekt .

Návod · otestováno 15. listopadu 2026

Návod na apfel AI

Za 60 sekund tvoje první odpověď od AI, kterou už máš v Macu. Pak 11 úloh, které zvládá dobře, každá připravená ke zkopírování i se skutečným výstupem, a upřímný seznam toho, co neumí.

Skutečný záznam terminálu, nic nestříhané: apfel 1.18.0 na macOS 27.0.1, MacBook Air M2.
Na této stránce: 15 sekcí
  1. Tvoje první odpověď za 60 sekund
  2. 1. Zeptej se Macu na něj samotného
  3. 2. Oprav jakýkoli zkopírovaný text
  4. 3. Čti účtenky, PDF a skripty
  5. 4. Z obyčejné věty shellový příkaz
  6. 5. JSON, na který se skripty můžou spolehnout
  7. 6. Automatizuj svůj den: git, hlas a hotové skripty
  8. 7. Spouštěj svůj OpenAI kód zdarma
  9. 8. Dej mu nástroje přes MCP
  10. 9. Vyzkoušej prompt v chatu
  11. 10. Nech server běžet na pozadí
  12. 11. Aplikace postavené na apfel
  13. Limity a upřímné odpovědi
  14. Když něco selže
  15. Kdo to napsal a jak jsme testovali

Tvoje první odpověď za 60 sekund

Potřebuješ Mac s Apple Silicon (M1 nebo novější) s macOS 26 Tahoe nebo novějším a zapnutou Apple Intelligence v Nastavení systému > Apple Intelligence a Siri. První dvě podmínky ověříš jedním řádkem:

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

Verze 26 nebo vyšší a arm64 znamenají, že můžeš začít. Nainstaluj apfel přes Homebrew. Žádný Xcode, žádný účet, žádný API klíč:

Terminál
brew install apfel

Polož první 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.

Tu odpověď dal model od Apple přímo ve tvém Macu. Nic se neposlalo na žádný server a nestálo to ani korunu.

Když to nefunguje: zeptej se apfel, jestli je model připravený:

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

Pokud vypíše available: no, zapni Apple Intelligence v Nastavení systému a počkej, až se model stáhne (podle instalační příručky má 3 až 4 GB). Jazyk Macu a jazyk Siri musí být stejný podporovaný jazyk. Dokud model není k dispozici, apfel končí s návratovým kódem 5.

Dál: úlohy níže. Každá začíná tím, co budeš mít za dvě minuty.

1. Zeptej se Macu na něj samotného

Za 2 minuty budeš mít: srozumitelné odpovědi o disku, CPU a paměti, přímo z příkazů, které už znáš.

Když příkaz v terminálu vychrlí stěnu čísel, chci odpověď na jeden řádek, abych mohl jednat bez čtení manuálových stránek.

Pošli rourou do apfel výstup libovolného příkazu a řekni, co chceš vědět:

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ý: nejdřív head, awk a grep, pak teprve apfel. Model najednou přečte jen pár tisíc slov, u kódu ještě méně (viz limity).

Když to nefunguje: některé příkazy píšou na stderr a ten roura nepřenáší. apfel ti to řekne: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Dál: stejný trik funguje pro git log, lsof, pmset -g batt, logy a cokoli dalšího, co vypisuje text.

2. Oprav jakýkoli zkopírovaný text

Za 2 minuty budeš mít: příkaz, který opraví gramatiku čehokoli ve schránce, v jakékoli aplikaci.

Když píšu rychlou zprávu ve Slacku, v Mailu nebo v prohlížeči, chci ji učesat bez otevírání další aplikace, abych ji mohl během pár sekund vložit zpátky.

Zkopíruj nějaký text a spusť prostřední řádek. pbpaste čte schránku, pbcopy do ní zapíše výsledek:

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.

Proč „the text above“: apfel dává text z roury na začátek a tvůj pokyn za něj (zdroj). S krátkým pokynem "fix grammar and spelling, reply with the corrected text only" model na zprávu odpověděl, místo aby ji opravil, a napsal Could you let me know which meeting you're referring to?. Když jsme výslovně pojmenovali text, se kterým má pracovat, v našem testu to problém vyřešilo.

Když to nefunguje: než výsledek odešleš, přečti si ho. Malý model občas změní význam; když jsme ho požádali o překlad této věty do němčiny, udělal z „Can you send me“ „Can I send you“.

Dál: dej prostřední řádek do shellového aliasu nebo do akce „Spustit shellový skript“ ve Zkratkách a přiřaď mu klávesovou zkratku.

3. Čti účtenky, PDF a skripty

Za 2 minuty budeš mít: odpovědi o obrázku, naskenovaném PDF nebo skriptu, přečtené přímo v Macu pomocí rozpoznávání textu od Apple.

Když mi do Stažených dorazí účtenka, sken nebo neznámý soubor, chci z něj jen ten jeden údaj, který potřebuju, abych ho mohl založit bez otevírání.

Soubor připojíš pomocí -f. Vyrobili jsme testovací obrázek účtenky (receipt.png) s těmito řádky:

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

Stejná účtenka uložená jako PDF jen s obrázkem funguje také, protože apfel na naskenovaných stránkách spouští rozpoznávání textu:

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

A jakýkoli textový soubor, třeba 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.

Ten skript získáš v úloze 6. Více souborů připojíš takto: -f a.txt -f b.txt.

Když to nefunguje: návratový kód 4 znamená, že je soubor pro model příliš dlouhý (viz limity). Návratový kód 3 znamená, že ho zablokoval bezpečnostní filtr Apple; příručka k extrakci souborů pro ten případ radí přidat --permissive.

4. Z obyčejné věty shellový příkaz

Za 2 minuty budeš mít: příkaz, který sis nemohl vybavit, vypsaný bez omáčky, takže ho rovnou zkopíruješ.

Když zapomenu přepínače find, du nebo tar, chci dostat příkaz z obyčejné věty, abych mohl zůstat v terminálu.

--code vypíše jen kód, bez vysvětlování:

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

Přepínače sedí, ale složku si model vymyslel. Tvoje domovská složka je ~ (tady tedy: 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ý příkaz si před spuštěním přečti. V našich testech model vyrobil i chybné příkazy. Na „10 největších souborů v aktuální složce“ vypsal ls -lh | head -n 10, což ukáže prvních 10 položek, ne ty největší. Na „zobraz otevřené porty“ navrhl netstat -tuln | grep LISTEN s linuxovými přepínači; na macOS to nevypíše vůbec nic. Na Macu je vypíše lsof -iTCP -sTCP:LISTEN -n -P.

Dál: ukázkový skript cmd z úlohy 6 tohle obaluje a před spuštěním se zeptá (-x), případně příkaz zkopíruje (-c).

5. JSON, na který se skripty můžou spolehnout

Za 2 minuty budeš mít: strukturovaná data vytažená z neuspořádaného textu, jako JSON, který vždy odpovídá tvému schématu.

Když potřebuju z e-mailů a poznámek dostat jména, čísla nebo data, chci pole, ne souvislý text, abych je mohl předat jq, tabulce nebo skriptu.

Ulož JSON Schema jako contact.schema.json:

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

Pak text pošli rourou s přepínačem --schema. apfel model omezí tak, aby výstup byl platný JSON podle tohoto schématu:

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

Klíče se vrátí v pořadí, v jakém je deklaruje tvoje schéma.

Pro jakoukoli odpověď ve formátu JSON i s metadaty použij -o json:

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

Na celý seznam je tu --batch: na vstupu jeden řádek JSON na záznam, na výstupu jeden řádek s výsledkem na záznam, každý záznam v nové relaci. Tři recenze produktu v textovém souboru:

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 udělá z každého řádku záznam; poslední řádek je souhrn od apfel na stderr. Záznam, který selže, dostane status: "error" a dávka pokračuje dál.

Když to nefunguje: apfel podporuje podmnožinu JSON Schema (objekty, řetězce, výčty, čísla, booleany, pole, lokální $ref). Nepodporované klíčové slovo, třeba pattern, skončí s návratovým kódem 2 a apfel ho pojmenuje; seznam najdeš v dokumentu o kompatibilitě API.

6. Automatizuj svůj den: git, hlas a hotové skripty

Za 2 minuty budeš mít: shrnutí své nedávné práce, Mac, který ti nahlas oznámí dokončení dlouhé úlohy, a osm hotových AI skriptů pro shell.

Když přepínám mezi úkoly nebo čekám na build, chci malé automatizace, které věci vysvětlí a ohlásí, abych mohl přestat hlídat terminál.

Shrň, co jsi dělal, přímo z libovolného git repozitáře:

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.

Nech Mac promluvit, když něco doběhne. Pošli odpověď rourou do say a před celé volání dej svůj dlouhý příkaz spojený přes &&:

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

Testovací Mac neměl zvukový výstup, takže jsme řeč místo toho nahráli do souboru (| say -o build-done.aiff, 102 880 bajtů zvuku). Vyslovená věta zněla Your build is finished, and I'm glad you asked!.

apfel obsahuje i osm ukázkových skriptů. Zapiš je do složky:

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, který se nám při testech líbil:

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

V našich bězích nebyla každá ukázka dobrá: oneliner "count unique IP addresses in access.log" narazil na limit délky a vypsal rozbitý příkaz a explain přidal chybovou hlášku, která neexistovala. README k ukázkám uvádí všech osm.

7. Spouštěj svůj OpenAI kód zdarma

Za 2 minuty budeš mít: lokální server, který mluví OpenAI Chat Completions API, takže existující kód s SDK poběží proti tvému Macu místo placeného cloudového modelu.

Když prototypuju s OpenAI SDK, chci lokální endpoint zdarma, abych mohl vyvíjet a testovat bez klíčů, faktur a bez posílání dat ven.

Spusť server v jedné záložce 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

Ve druhé záložce ho zavolej jako 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ální OpenAI SDK pro Python funguje beze změn. Liší se jen základní URL a název modelu. Ulož jako 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 poslouchá jen na tvém vlastním Macu (127.0.0.1) a odmítá požadavky z webových stránek z jiných originů. Pokud ho chceš otevřít do sítě, přidej token: apfel --serve --host 0.0.0.0 --token-auto (příručka k zabezpečení serveru).

Když to nefunguje: Connection refused znamená, že server neběží. Embeddingy a starý endpoint /v1/completions vracejí HTTP 501, protože je model v zařízení nenabízí.

Dál: správci dokumentují nastavení pro VS Code Copilot (jen chat), opencode, Zed a Node.js, Ruby, PHP a šest dalších jazyků. Pro tuto stránku jsme je znovu netestovali.

8. Dej mu nástroje přes MCP

Za 2 minuty budeš mít: model, který si přes nástroj Model Context Protocol přečte živou webovou stránku a shrne ji.

Když je odpověď na webové stránce, chci, aby si ji model stáhl sám, abych mohl dostat shrnutí bez kopírování textu sem a tam.

Nainstaluj nástroje apfel-mcp, které jsou dělané tak, aby se vešly do malého kontextového okna:

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

Jeden připoj přes --mcp a ptej se. -q skryje surový výstup nástroje:

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.

Stejný balíček obsahuje apfel-mcp-ddg-search (vyhledávání na webu), apfel-mcp-search-and-fetch a apfel-mcp-fs (čtení lokálního souboru). Funguje jakýkoli MCP server: cesta k lokálnímu skriptu nebo URL https://.

Fungují i nástroje s několika pojmenovanými argumenty. Tady je kalkulačka z repozitáře apfel (mcp/calculator/server.py): model zavolá multiply s oběma argumenty, apfel volání provede a model odpoví výsledkem:

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.

Řádkem tool: ti apfel ukazuje volání, které provedl. Před apfel 1.18.0 model názvy argumentů neviděl a hádal je, takže takové volání selhalo (issue #555, opraveno v pull requestu #556). Pokud tu uvidíš invalid arguments, aktualizuj pomocí brew upgrade apfel.

9. Vyzkoušej prompt v chatu

Za 2 minuty budeš mít: konverzaci v terminálu, která si pamatuje, co jsi říkal předtím.

Když ladím prompt pro skript, chci rychle vyzkoušet pár kol, abych mohl vidět, jak model reaguje, než to zautomatizuju.

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.

Personu přidáš přes -s, například apfel --chat -s "You are a patient Python tutor". Když dlouhý chat přeroste kontextové okno, apfel ve výchozím stavu zahodí nejstarší kola; příručka ke kontextu vysvětluje další strategie. Okno s tlačítky nabízí apfel-chat.

10. Nech server běžet na pozadí

Za 2 minuty budeš mít: server kompatibilní s OpenAI, který se sám spustí po přihlášení a je vždy připravený na portu 11434.

Když nástroje v mém Macu používají lokální endpoint každý den, chci, aby běžel pořád, abych ho nemusel spouštět ručně.

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)

Nastavení jako port, token nebo MCP servery jsou proměnné prostředí, například APFEL_PORT=8080 brew services start apfel. Všechny najdeš v příručce ke službě na pozadí.

11. Aplikace postavené na apfel

Za 2 minuty budeš mít: stejný model v zařízení v okně, v řádku nabídek nebo pod klávesovou zkratkou, pokud máš radši aplikace než terminál.

Pocházejí od stejných správců („apfel tree“ v README). 15. listopadu 2026 jsme ověřili, že každý instalační název v Homebrew existuje; samotné aplikace jsme pro tuto stránku netestovali.

Aplikace Co dělá Instalace
apfel-chat Chatovací aplikace se streamovanými odpověďmi, řečí a analýzou obrázků brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Akce se schránkou v řádku nabídek: shrnutí, překlad, přepsání brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Stiskni klávesu, zeptej se, dostaň odpověď, zavři brew install Arthur-Ficial/tap/apfel-quick
apfelpad Poznámkový blok, kde je AI vzorec, který vložíš do buňky brew install Arthur-Ficial/tap/apfelpad
apfel-mcp MCP nástroje dimenzované na malé okno (úloha 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel s uloženou konfigurací a seznamem MCP serverů brew install Arthur-Ficial/tap/apfel-run
apfel-tag Štítky, témata a emoce pro jakýkoli text poslaný rourou brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Ladicí okno: požadavky, MCP zprávy, řeč brew install Arthur-Ficial/tap/apfel-gui

Limity a upřímné odpovědi

apfel ti zpřístupní model od Apple přímo v zařízení. README uvádí zhruba 3 miliardy parametrů, tedy mnohem menší než cloudové modely, na kterých běží ChatGPT nebo Claude. Je dobrý na krátké, jasně vymezené textové úlohy. Tohle jsou limity, na které jsme narazili nebo které uvádí dokumentace.

Kontextové okno je malé. Otázka i odpověď se musí vejít do 4 096 tokenů na macOS 26 a na Macích s M1 a M2, nebo do 8 192 tokenů na Macích s M3 a novějších s 12 GB a víc a s macOS 27 (README). Jaké máš ty, ukáže apfel --model-info. Vlastní README apfel je na něj příliš dlouhé. Než něco pošleš, spočítej si to:

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 minus 512 tokenů vyhrazených pro odpověď. README má asi 3 000 slov, jenže Markdown a kód stojí na jedno slovo hodně tokenů. Dlouhé soubory posílej po částech (head -c 6000 file), vždy jednu sekci.

Nezná dnešní datum. Nějaké 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, který potřebuje, mu dej do promptu. Internet nemá, pokud mu nepřipojíš MCP nástroj.

Občas se mýlí, a to sebejistě. Viděl jsi to výše: chybné shellové příkazy v úloze 4, překlad s obráceným významem v úloze 2. Cokoli důležitého si ověř.

Bezpečnostní filtr Apple může zablokovat i neškodný text. apfel pak skončí s návratovým kódem 3 a hláškou The request was blocked by Apple's safety guardrails. Přeformuluj to, nebo u tvůrčího psaní a dokumentů přidej --permissive; dokument o guardrails vysvětluje, co to mění. V bězích pro tuto stránku jsme na žádné zablokování nenarazili.

Odpovědi se liší při každém spuštění. Tohle jsou skutečné výstupy, každý z jednoho běhu. Ty tvoje budou formulované jinak. Pro opakovatelnější odpovědi použij --temperature 0; apfel neslibuje stejný výstup napříč běhy ani aktualizacemi macOS (zásady stability).

Rychlost: většina odpovědí v našich bězích přišla za 1 až 2 sekundy. Shrnutí webové stránky přes MCP nástroj trvalo 8 sekund.

Požadavky jsou striktní: jen Apple Silicon, macOS 26 nebo novější, zapnutá Apple Intelligence a jeden z 15 jazyků, které vypíše --model-info. Na Macích s Intelem to nepoběží.

Když něco selže

apfel hlásí problémy návratovým kódem, takže skripty můžou reagovat. Zkontroluješ ho pomocí echo $? hned po příkazu.

Návratový kód nebo chyba Význam Co dělat
2 Chybný přepínač nebo volba Přepínače patří před prompt; vypíše je apfel --help
3 Bezpečnostní filtr Apple požadavek zablokoval Přeformuluj, nebo přidej --permissive
4 Vstup je na kontextové okno příliš dlouhý Pošli méně textu; ověř přes apfel --count-tokens
5 Model není k dispozici Zapni Apple Intelligence, počkej na stažení, sjednoť jazyk Macu a Siri
6 Model je vytížený nebo narazil na limit požadavků Počkej a spusť znovu, nebo přidej --retry
Connection refused Na portu 11434 neběží žádný server Spusť apfel --serve nebo brew services start apfel
HTTP 501 Endpoint, který model v zařízení nenabízí (embeddingy, /v1/completions) Použij /v1/chat/completions
piped input was empty Příkaz psal na stderr command 2>&1 \| apfel "..."

Pořád se nedaří? Prohledej issues nebo založ nové na GitHubu.

Kdo to napsal a jak jsme testovali

apfel je svobodný a open source software (licence MIT), projekt franzai od Franze Enzenhofera. Spravuje ho spolu s Arthurem Ficialem, Franzovým AI asistentem, který napsal i tento návod. Protože tuto stránku napsali tvůrci apfel, uvedli jsme každé selhání, které jsme viděli, místo abychom ho vynechali.

Jak jsme testovali: 15. listopadu 2026 jsme spustili každý příkaz z této stránky na MacBooku Air M2 (24 GB) s macOS 27.0.1 (build 26A434). Použili jsme podepsanou binárku apfel 1.18.0 z vydání na GitHubu (stejný soubor, jaký instaluje tap pro Homebrew), ve skutečné relaci terminálu, a výstup jsme zkopírovali beze změn. První verze této stránky (14. listopadu 2026, apfel 1.16.0) ukazovala chybu s nástroji s více argumenty v úloze 8; 1.18.0 ji opravuje, takže jsme pro tuto verzi spustili znovu všechny příkazy. Kde byl první výstup chybný, nechali jsme ho na stránce a napsali jsme to. Jediná opakovaná spuštění sloužila k nalezení odpovědí, které nebylo nutné upravovat: jedno shrnutí webové stránky obsahovalo dlouhou pomlčku, kterou tento web netiskne, tak jsme ho spustili znovu a ponechali třetí běh. Příklad s řečí jsme ověřili zápisem zvuku do souboru, protože testovací Mac neměl zvukový výstup. Ukázkové skripty zapsal příkaz apfel --demos z apfel 1.18.0.

Co o apfel napsali jiní: příspěvek na Show HN (3. dubna 2026, 743 bodů), průvodce od Better Stack, článek od GIGAZINE a praktická recenze na danilchenko.dev.

Zdroje: README apfel, referenční příručka CLI, instalační příručka, ukázkové skripty, apfel vs fm od Apple a issue tracker, přečteno 15. listopadu 2026.