apfel je projekt .

v1.18.0 · Bez konfigurace · MIT

apfel

AI zdarma, kterou už máš v Macu.

macOS Tahoe obsahuje LLM se 3 miliardami parametrů. apfel ti k němu dá přístup z CLI po jednom brew install. Žádné stahování modelů, žádné API klíče, žádná konfigurace - prostě to funguje.

  • Žádné poplatky za tokeny
  • AI přímo v zařízení
  • Skriptovatelné
$ brew install apfel

6.6k+ hvězd na github.com/Arthur-Ficial/apfel

Vyžaduje: Apple Silicon · macOS Tahoe · zapnutou Apple Intelligence

Poprvé s apfel? Začněte 60sekundovým návodem (anglicky)

Všechno běží v tvém zařízení. Žádná síťová volání. Žádná data neopustí tvůj Mac.

Podívej se na něj v akci.

Od brew install k odpovědi AI za 12 sekund. Bez jakékoli konfigurace.

Terminál - apfel
$
Skutečný záznam terminálu, nic nestříhané: apfel 1.18.0 na macOS 27.0.1, MacBook Air M2.

Žádná konfigurace. Žádné stahování LLM. Žádné poplatky za tokeny.

Jiné lokální AI nástroje jsou skvělé, ale vyžadují stažení modelů a konfiguraci. apfel nepotřebuje nic - model už v tvém Macu je. Jeden brew install. Hotovo.

$0
Cena za tokeny
Žádné API klíče. Žádná předplatná. Žádné účtování za token. Tvůj hardware, tvoje AI.
100%
V zařízení
Každý token vzniká lokálně na tvém Apple Silicon. Nic neopustí tvůj počítač. Nikdy.
0
Kroků konfigurace
Žádný YAML. Žádné proměnné prostředí. Žádný výběr modelu. Jednou nainstaluj, používej navždy.

Model pod kapotou

Apple ML Research
~3BParametry
4,096 / 8,192Kontextové okno (M1/M2 / M3+ na macOS 27)
~3.5 bpwKvantizace
Mixed 2/4-bitPřesnost
Neural EngineBěží na
en, de, es, fr, it, ja, ko, pt, zhJazyky

Tři nástroje. Jedna instalace.

CLI, server kompatibilní s OpenAI a interaktivní chat. Všechno z jediného brew install. Žádné další stahování.

>_

UNIXový nástroj

Funguje v rourách a dá se skládat s dalšími nástroji. Spolupracuje s jq, xargs a tvými shellovými skripty. stdin, stdout, výstup JSON, JSON podle schématu přes --schema, víc kol konverzace ze souboru se zprávami přes --messages, přílohy souborů, správné návratové kódy.

$ apfel "What is the capital of Austria?"
The capital of Austria is Vienna.

$ apfel -o json "Translate to German: Apple" | jq .content
"Apfel"

# --schema: output guaranteed to match your JSON Schema
$ apfel --schema person.json "Alice is 30." | jq .name
"Alice"

# --code: just the command, no prose, no fences
$ apfel --code "flush the dns cache on macos"
sudo /usr/bin/dscacheutil -flushcache
{ }

OpenAI server

Přímá náhrada na localhost:11434. Nasměruj na něj libovolné OpenAI SDK a jedeš. Chat Completions a Responses API, streamování, tool calling, výstup JSON Schema, CORS.

$ apfel --serve
Server running on http://127.0.0.1:11434

# any OpenAI client works
$ curl localhost:11434/v1/chat/completions ...
...

Interaktivní chat

Konverzace o více kolech s automatickou správou kontextu. Pět strategií ořezávání. Podpora systémového promptu. Stačí v terminálu napsat apfel a začneš. Všechno v tvém Macu.

$ apfel --chat -s "You are a coding assistant"
Type 'quit' to exit.
> How do I reverse a list in Python?

Nativní podpora MCP.

Dej lokálnímu modelu Apple nástroje. Jakékoli nástroje.

Připoj servery nástrojů přes --mcp

apfel umí Model Context Protocol. Nasměruj ho na libovolný MCP server a model v zařízení dostane nástroje - matematiku, API, databáze, cokoli, pro co se dá napsat server.

  • Funguje ve všech třech režimech - CLI, server i chat
  • Při startu sám najde nástroje přes MCP tools/list
  • Volání nástrojů se automaticky rozpozná, provede a výsledky se vrátí modelu
  • Bez přepínače --mcp žádná režie - nula tokenů navíc, nula změn v cestě kódu
  • V balíčku je MCP server s kalkulačkou jako proof of concept
  • Vzdálené MCP servery přes URL - --mcp https://... s volitelným ověřením tokenem Bearer
Terminál - apfel + MCP
# give the model a calculator
$ apfel --mcp ./mcp/calculator/server.py \
  "What is 15 times 27?"

tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

# attach multiple servers
$ apfel --mcp ./calc.py --mcp ./weather.py \
  "What is sqrt(2025)?"

tool: sqrt({"n": 2025}) = 45.0
The square root of 2025 is 45.

# remote MCP server over HTTPS
$ apfel --mcp https://mcp.example.com/v1 "query"

# server mode - tools auto-available to all clients
$ apfel --serve --mcp ./calc.py

Jak to funguje.

Apple zabudoval LLM do každého Macu. A ten tam jen tak leží. apfel k němu otevírá dveře - bez jakékoli konfigurace.

Apple dodává LLM přímo v zařízení

Od macOS 26 (Tahoe) má každý Mac s Apple Silicon jazykový model jako součást Apple Intelligence. Apple ho zpřístupňuje přes framework FoundationModels - Swift API, které aplikacím dává přístup k SystemLanguageModel. Veškerá inference běží na Neural Engine a GPU. Žádná síťová volání, žádný cloud, žádné API klíče. Model tam prostě je.

Jenže Apple ho používá jen pro Siri

Ve výchozím stavu model v zařízení pohání Siri, Writing Tools a systémové funkce. Neexistuje žádný příkaz v terminálu, žádný HTTP endpoint, žádný způsob, jak přes něj poslat text rourou. Framework FoundationModels sice existuje, ale abys ho mohl použít, musíš napsat aplikaci ve Swiftu. A přesně to dělá apfel.

Co apfel přidává

apfel je binárka ve Swiftu 6.3, která obaluje LanguageModelSession a zpřístupňuje ji třemi způsoby: jako UNIXový nástroj příkazové řádky se stdin/stdout, jako HTTP server kompatibilní s OpenAI (postavený na Hummingbird) a jako interaktivní chat se správou kontextu.

Řeší to, co holé API od Apple neumí: správné návratové kódy, výstup JSON, přílohy souborů, pět strategií ořezávání kontextu pro malé kontextové okno (4 096 tokenů, 8 192 na Macích s M3 a novějších s macOS 27), skutečné počítání tokenů přes SDK a převod schémat nástrojů OpenAI do nativního formátu Apple Transcript.ToolDefinition.

hardware Apple Silicon (Neural Engine + GPU)
|
model LLM od Apple v zařízení (dodávaný s macOS)
|
sdk FoundationModels.framework (Swift API)
|
apfel CLI + HTTP server + správa kontextu
|
ty Terminál, shellové skripty, OpenAI SDK, curl
4 096 nebo 8 192 tokenů Kontextové okno (vstup + výstup). 4 096 na macOS 26 a na Macích s M1/M2; 8 192 na M3 nebo novějších s 12 GB+ na macOS 27. apfel ho zjišťuje za běhu.
1 model Pevně daný, nelze změnit
Swift 6.3 Striktní souběžnost, bez Xcode
Licence MIT Open source

Soukromí už z principu.

Při používání apfel ani jedno HTTP volání. Každé tvrzení níže odkazuje na dokumentaci přímo od Apple.

V zařízení. Funguje offline.

Framework FoundationModels běží celý na Neural Engine tvého Apple Silicon. Žádný server, žádný cloud, žádné připojení k internetu.

"You can build experiences that are smart, private, and work without internet connectivity." - Apple Developer

Tvoje data zůstanou tvoje.

Apple nesbírá prompty, odpovědi ani žádná data o používání z inference v zařízení. Nic se neukládá, nic se neodesílá.

"The cornerstone of Apple Intelligence is on-device processing." - Apple Privacy

Nikdy se nepoužijí k trénování.

Apple trénuje své základní modely výhradně na licencovaných a veřejných datech. Tvoje interakce se do trénování nikdy nedostanou.

"We do not use our users' private personal data or user interactions when training our foundation models." - Apple ML Research

apfel nepřidává žádné sledování.

Žádná analytika, žádná telemetrie, žádné automatické kontroly aktualizací, žádné hlášení pádů, žádné volání domů. Jediné síťové volání, které apfel kdy udělá, je, když sám spustíš apfel --update. Celý kód je open source.

Výkonné nástroje v balení.

Shellové skripty ve složce demo/. Nejdřív nainstaluj apfel, pak si vezmi ty, které chceš.

>_

cmd

Z běžné řeči na příkaz shellu. Řekni, co chceš, a dostaneš příkaz.

$ cmd "find all .log files modified today"
|>

oneliner

Řetězce rour z obyčejného popisu. awk, sed, sort, uniq - vygenerované za tebe.

$ oneliner "count unique IPs in access.log"
**

mac-narrator

Komentuje dění v systému tvého Macu jako přírodopisný dokument.

$ mac-narrator --watch
?

explain

Vysvětlí jakýkoli příkaz, chybovou hlášku nebo kus kódu srozumitelnou řečí.

$ explain "awk '{print $1}' file | sort -u"
./

wtd

Co je to za adresář? Okamžitá orientace v jakémkoli projektu.

$ wtd
++

gitsum

Shrne poslední commity v gitu do pár vět.

$ gitsum

30 užitečných a skvělých one-linerů.

Každý příkaz otestovaný na skutečném Macu. Spojuj apfel s ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - tohle cloudová AI nedokáže, protože nevidí tvoje procesy, tvou schránku ani tvůj git diff. apfel ano.

Živý systém 8

Co mi právě teď žere CPU.

$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"

-> Nejvíc CPU bere WindowServer: 42,6 %.

Které aplikace poslouchají na kterých portech.

$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"

-> 11434 fichten, 18789 node, 5000 ControlCenter ...

Který svazek je nejblíž zaplnění.

$df -h | apfel "which volume is fullest, one sentence"

-> Nejplnější je /dev/disk3s1: 263Gi z 926Gi.

vm_stat přeložený do lidské řeči.

$vm_stat | apfel "explain my memory usage in plain english, one sentence"

-> 349k stránek aktivních, 266k wired - paměť je dost vytížená.

Které složky tady zabírají nejvíc místa.

$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"

-> Vedou Library (36G) a Downloads (604M).

Největší soubory v této složce.

$ls -laS | head -10 | apfel "what are the biggest files here, just file names"

-> apfel-quick-preview.png, og.png, translate-preview.png ...

Které aplikace právě teď komunikují s internetem.

$lsof -i -nP 2>/dev/null | grep ESTABLISHED | awk '{print $1, $9}' | head -10 | apfel "which apps are talking to the internet right now, short answer"

-> node → 157.240.253.60:443, claude.ex → 160.79.104.10:443, Google → 66.102.1.188:5228 ...

Stav baterie a zbývající čas na jednom řádku.

$pmset -g batt | apfel "battery health and percent, one line"

-> Plně nabito, kondice 100 %, právě aktivní.

Git 2

Shrň poslední commity srozumitelnou řečí.

$git log --oneline -20 | apfel "summarize what I have been working on"

-> Aktualizace z v1.2.1 na v1.3.2, přidány sesterské projekty ...

Napiš jednořádkovou poznámku k vydání z posledních commitů.

$git log --oneline -5 | apfel "write a one-line release note based on these commits"

-> Vydána v1.3.2: 5053 hvězd, 783 testů, aktualizace.

Schránka tam a zpět 4

Oprav gramatiku toho, co máš ve schránce, a vrať opravu zpátky.

$pbpaste | apfel "fix grammar" | pbcopy

-> Z „i has went“ je „I went“ - zpátky ve schránce.

Přelož schránku do japonštiny a vrať ji zpátky.

$pbpaste | apfel "translate to japanese" | pbcopy

-> Ve schránce je teď japonský překlad.

Shrň záplavu textu ze schránky do 3 bodů.

$pbpaste | apfel "summarize in 3 bullets"

-> 3 úderné body přímo v terminálu.

Vytáhni z poznámek ze schůzky ve schránce jasné úkoly.

$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy

-> „Sarah drafts Q3 budget“, „email design team“, ... zpátky ve schránce.

Hlídej a ohlas 6

Nech se nahlas upozornit, až dlouhá úloha skončí (tady za 30 minut).

$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say

-> Mac řekne: „Tvoje dlouhá úloha právě skončila, dobrá práce!“

Počkej, až se soubor objeví v Downloads, a ohlas to.

$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say

-> Kontroluje každých 5 s; jakmile se objeví Report.pdf, Mac to oznámí.

Počkej, až dlouho běžící proces skončí, a ohlas to.

$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say

-> Kontroluje každých 5 s; jakmile ffmpeg skončí, Mac to oznámí.

Každých 30 minut nahlas shrň, co jsi právě dodal.

$while sleep 1800; do git log --since="30 min ago" --oneline | apfel "summarize my last 30 minutes of work in one cheerful sentence" | say; done

-> Automatický stand-up každou půlhodinu, čtený nahlas, zatímco ty dál kóduješ.

Každých 15 minut nahlas varuj, když baterie klesne pod 20 procent.

$while sleep 900; do P=$(pmset -g batt | grep -oE "[0-9]+%" | head -1 | tr -d %); [ "$P" -lt 20 ] && apfel "battery just dropped to $P percent, write one short sentence that is friendly but super urgent telling me to plug in NOW" | say; done

-> Ticho, dokud baterie neklesne; pak Mac nahlas vykřikne přátelské, ale naléhavé varování.

Hlídej URL, dokud nevrátí 2xx, a pak nahlas oslav deploy.

$until curl -sf https://staging.example.com/health >/dev/null; do sleep 30; done; apfel "tell me cheerfully that my deploy is live and the URL is responding, one short sentence" | say

-> Kontroluje každých 30 s, dokud staging nenaběhne; Mac řekne „Tvůj deploy je venku, URL odpovídá!“.

Web a text 4

Přeformuluj ležérní větu na něco zdvořilého.

$echo "hey can u send me docs asap" | apfel "rephrase politely"

-> „Could you please share the documents at your earliest ...“

Zavolej URL a zeptej se, co se děje, jen podle hlaviček.

$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"

-> GitHub vrací HTML stránku s přísným cachováním a bezpečnostními hlavičkami.

Dnešní Hacker News shrnuté do jedné věty a přečtené nahlas.

$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say

-> Mac přečte hlavní zprávy dne v jednom stručném shrnutí.

Vysvětli JSON blob srozumitelnou řečí.

$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"

-> Uživatelka Alice s tarifem pro a 42 kredity.

Rychlé dotazy 8

Počítání bez otevírání kalkulačky.

$apfel "what is 15% tip on 87.50, just the number"

-> 13.13

Vygeneruj regex, aniž bys opustil terminál.

$apfel "regex for a valid email address, just the regex"

-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

Zeptej se na bashový one-liner, který jsi zapomněl.

$apfel "give me one find command that lists files larger than 100MB, just the bash command"

-> find / -type f -size +100M

Nech si vysvětlit záhadný příkaz místo hádání.

$apfel "explain the command tar -xzvf file.tar.gz in one sentence"

-> Rozbalí tar archiv komprimovaný gzipem do aktuálního adresáře.

Nepamatuješ si přesný příkaz gitu? Prostě se zeptej.

$apfel "git command to uncommit but not unedit my last commit, just the command"

-> git reset --soft HEAD~1

Rozlušti cizí regex jednou větou.

$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"

-> Odpovídá 3místné předvolbě, spojovníku a 4 číslicím - formát telefonního čísla v USA.

Převeď volně zapsané datum na ISO 8601.

$apfel "convert 'Sat Apr 27 2026 11:30' to ISO 8601 (YYYY-MM-DDTHH:MM:SS), reply only with the converted string"

-> 2026-04-27T11:30:00+00:00

Shrň celý soubor do 3 bodů.

$apfel -f README.md "summarize in 3 bullets"

-> 3 body: rozsah, instalace, použití.

Kompatibilní s OpenAI.

Změň jedno URL. Kód nech, jak je.

Přímá náhrada

apfel mluví jazykem OpenAI API. Každá klientská knihovna, framework nebo nástroj, který komunikuje s OpenAI, může místo toho komunikovat s AI v tvém Macu. Stačí změnit základní URL.

  • ✓ POST /v1/chat/completions
  • ✓ POST /v1/responses (Responses API)
  • ✓ Streamování (SSE)
  • ✓ Tool calling / function calling
  • ✓ GET /v1/models
  • ✓ response_format: json_object, json_schema
  • ✓ části image_url jako data URL (macOS 27)
  • ✓ temperature, max_tokens, seed
  • ✓ CORS pro klienty v prohlížeči
Python
from openai import OpenAI

# Just change the base_url. That's it.
client = OpenAI(
    base_url="http://localhost:11434/v1",
    api_key="unused"  # no auth needed
)

resp = client.chat.completions.create(
    model="apple-foundationmodel",
    messages=[{
        "role": "user",
        "content": "What is 1+1?"
    }],
)
print(resp.choices[0].message.content)

Stejný model jako fm od Apple. Jiný úkol.

macOS 27 obsahuje fm, vlastní rozhraní příkazové řádky od Apple pro model v zařízení. Tady se cesty obou nástrojů rozcházejí.

 apfelApple fm
Běží namacOS 26 i 27, jedna binárkajen macOS 27
Instalacebrew install apfelUž tam je (jednou sudo fm license)
Klienti OpenAI fungují beze změnAno: výchozí JSON, usage, respektuje max_tokens, namapované chybyStreamuje, pokud ho nepožádáš o opak, ignoruje max_tokens, 500 při guardrails
Tool calling a MCPNativní volání nástrojů, lokální i vzdálené MCP serveryŽádné (s tools unikají tokeny šablony do odpovědi)
Skriptování--code, -o json, 9 návratových kódů, --count-tokens --strictProstý text, návratový kód 0 nebo 1
Soubory na vstupuText, PDF, obrázky: text z OCR na obou systémech, na macOS 27 navíc i samotný obrázek do modeluObrázky do modelu, plus vestavěné nástroje pro OCR a čárové kódy
Trvalé relace chatuNePojmenované přepisy, --resume
RychlostStejný model na stejném Macu, stejné kontextové okno (4 096 tokenů na tomto M2, 8 192 na M3 a novějších), totožné počty tokenů. Jednorázový prompt: 0,35 s vs 0,30 s.

Krátká historie. apfel byl venku první: první commit a v0.1.0 dne 24. března 2026, první vydání na GitHubu 31. března 2026 a v dubnu titulní strana Hacker News. Apple oznámil fm na WWDC 8. června 2026 a vydal ho 14. září 2026 s macOS 27. Oba pohánějí stejný model v zařízení přes stejný framework FoundationModels; apfel je ten s otevřeným kódem a ten, který běží i na macOS 26.

Každý řádek byl změřen na macOS 27.0.1 (Apple M2, 24 GB) dne 2026-10-05 a měří se znovu při každém vydání apfel. Celá stránka obsahuje testy serveru, tabulku shody počtu tokenů a všechny příkazy, kterými to zopakuješ.

Oblíbený na GitHubu.

Od nuly k 6,610 hvězdám. A další přibývají.

6,610
Hvězdy na GitHubu
251 forků
2450 testů
v1.18.0 vydáno

Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.

Dát hvězdu na GitHubu
0 1,000 2,000 3,000 4,000 5,000 6,000 7,000 8,000 5,012 APR 28 6,016 JUL 10 6,610 NOW Mar 24 Apr 3 · HN front page Nov 16

Data k

Pojďme na to.

Žádné stahování modelů. Žádná registrace. Žádné API klíče. Jen tohle.

Homebrew

macOS 26+ s Apple Intelligence
$ brew install apfel
$ apfel "Hello, Mac"

Sestavení ze zdrojáků

vyžaduje CLT + SDK pro macOS 27 (běží na 26 i 27)
$ git clone https://github.com/Arthur-Ficial/apfel.git
$ cd apfel && make install

Strom apfel.

Rostoucí rodina nativních nástrojů pro macOS postavených na apfel - a sesterské projekty, které do terminálu přinášejí další frameworky od Apple.

apfel-chat - soukromý AI chat pro macOS

apfel-chat

Chatovací klient pro macOS s více konverzacemi. Streamovaný markdown, hlasový vstup i výstup, analýza obrázků - plně soukromě, bez API klíčů, bez cloudu.

SwiftUI Produkční
apfelpad - poznámkový blok se vzorci a AI v zařízení

apfelpad

Poznámkový blok se vzorci na přemýšlení. Napiš do svého markdownu =apfel("summarize this") a sleduj, jak se výsledek streamuje přímo do textu. Jako =SUM, jen pro jazyk.

SwiftUI Novinka
apfel-quick - okamžitá AI vrstva pro macOS

apfel-quick

Okamžitá AI vrstva. Kdekoli stiskni Ctrl+Space, napiš otázku a odpověď se streamuje do schránky. Bez Wi-Fi, bez účtu, bez poplatků.

SwiftUI Novinka
Snímek obrazovky apfel-gui

apfel-gui

Nativní ladicí GUI pro macOS ve SwiftUI. Chatuj s Apple Intelligence, prohlížej požadavky a odpovědi, logy, převod řeči na text a textu na řeč - všechno v zařízení.

SwiftUI
apfel-clip - AI akce se schránkou

apfel-clip

AI akce se schránkou z řádku nabídek. Stiskni cmd+shift+V na libovolném textu - oprav gramatiku, přelož, vysvětli kód, shrň. Plně v zařízení, bez API klíčů.

SwiftUI Produkční
apfel-mcp - MCP servery pro apfel

apfel-mcp

Dej apfel přístup k webu a ke svým souborům. Čtyři malé MCP nástroje - url-fetch, ddg-search, search-and-fetch a čtečka souborů jen pro čtení - každý zkrácený tak, aby se vešel do malého kontextového okna apfel (4 096 tokenů na většině Maců, 8 192 na M3 a novějších s macOS 27).

Python Novinka
apfel-run - trvalý registr MCP

apfel-run

Drobný UNIXový wrapper, který dává apfel trvalý registr MCP. Zapínej a vypínej MCP servery podle jména v obyčejném textovém konfiguračním souboru. Přežije restart, bez GUI, bez démona.

Shell Novinka
apfel-server-kit - Swift balíček pro nástroje ekosystému

apfel-server-kit

Sdílený Swift balíček, na kterém stojí celý ekosystém. Najdi a spusť lokální proces apfel --serve a streamuj z něj. Páteř, se kterou mluví každá SwiftUI aplikace apfel.

Swift Novinka
auge - framework Vision od Apple v terminálu

auge

Sesterský projekt. apfel dělá jazyk, auge zrak. Jedno CLI pro OCR, klasifikaci obrázků, čárové kódy a detekci obličejů - na 100 % v zařízení díky frameworku Vision od Apple. Bez API klíčů, bez cloudu.

Swift Sesterský projekt
translate - framework Translation od Apple v terminálu

translate

Sesterský projekt. UNIXový filtr plus HTTP server jako přímá náhrada za DeepL, LibreTranslate a Google v2 - poháněný frameworkem Translation od Apple, který běží v zařízení. Na 100 % v zařízení, natvrdo vynucené přes NetworkGuard. Bez API klíčů, bez cloudu.

Swift Sesterský projekt

Časté dotazy.

Otázky posbírané z Hacker News a Redditu.

Jakou verzi macOS potřebuju?
macOS 26 (Tahoe) nebo novější. Framework FoundationModels je k dispozici až v Tahoe. Na Sequoii a starších nefunguje. Vyžaduje Apple Silicon (M1 nebo novější).
Má apfel přístup k mým osobním datům?
Ne. Framework FoundationModels nemá žádný přístup ke kontaktům, e-mailům, kalendáři, fotkám ani k Semantic Index. Ty jsou vyhrazené vlastním funkcím Apple.
Opouštějí můj Mac nějaká data?
Ne. Chrání tě dvě vrstvy soukromí.

Model: framework FoundationModels od Apple funguje bez připojení k internetu a běží celý na Neural Engine. Tvoje prompty a odpovědi nikdy neopustí zařízení. Uživatelská data se nikdy nepoužívají k trénování.

Nástroj: apfel na tom nic nemění. Žádná analytika, žádná telemetrie, žádné sledování, žádné automatické kontroly aktualizací, žádné hlášení pádů, žádné volání domů. Open source, kdokoli si to může ověřit.
Jak velké je kontextové okno?
4 096 tokenů (~3 000 slov) pro vstup a výstup dohromady na macOS 26 a na Macích s M1/M2. Na macOS 27 dostanou Macy s čipem M3 nebo novějším a aspoň 12 GB větší model Apple v zařízení (AFM 3 Core Advanced) s oknem 8 192 tokenů. apfel tu hodnotu nikdy nemá natvrdo: apfel --model-info vypíše okno, které tvůj Mac skutečně má. Skvělé na shellové skripty, shrnutí a úpravy textu. Nehodí se na dlouhé konverzace ani velké dokumenty.
V čem je model dobrý? S čím má potíže?
Dobrý v: shellových skriptech, úpravách textu, klasifikaci, krátkých shrnutích, přestavbě JSON, překladech.

Slabší v: matematice, vybavování faktů, dlouhých konverzacích, generování složitého kódu.

Model raději odmítne, než aby halucinoval. Je to záměrné rozhodnutí Apple.
Je režim serveru bezpečný?
Ve výchozím stavu vypnutý. Po zapnutí: ověření tokenem Bearer (--token), kontrola origin, logovací endpointy jen v režimu debug. Podrobnosti v server-security.md.
Musím zapnout Apple Intelligence?
Ano. Nastavení systému > Apple Intelligence & Siri > zapnout. Tím se stáhne model. Siri používat nemusíš, stačí ji zapnout. Návod od Apple.
Jak apfel aktualizuju?
apfel --update. Zjistí způsob instalace, zkontroluje novější verzi a před aktualizací se zeptá. Ručně: brew upgrade apfel nebo git pull && make install.
Jaký model používá?
Vlastní AFM od Apple (Apple Foundation Model), zhruba 3 miliardy parametrů se smíšenou 2bitovou a 4bitovou kvantizací. Ne OpenAI. Dodává se s macOS Tahoe a běží celý v zařízení na Neural Engine.
Čím se apfel liší od Ollama nebo LM Studio?
Žádné stahování LLM, okamžitý start, žádné nastavování. apfel používá model, který už v tvém Macu je. Ollama a LM Studio nabízejí víc modelů a větší kontextová okna, ale vyžadují samostatné stahování a konfiguraci. Různé nástroje pro různé potřeby.
Podporuje apfel MCP a tool calling?
Ano. Nativní MCP je vestavěné. Nástroje připojíš přes --mcp <server>. Průvodce tool callingem.
Čím se apfel liší od fm, vlastního CLI od Apple v macOS 27?
Stejný model, jiný úkol. macOS 27 obsahuje fm, rozhraní příkazové řádky od Apple pro stejný model v zařízení. apfel k tomu přidává server kompatibilní s OpenAI s tool callingem, MCP, výstupem JSON Schema, obrázky na vstupu jako data URL, poctivými návratovými kódy a podporou macOS 26. Změřeno vedle sebe: apfel vs fm.
Má apfel telemetrii nebo funkce volání domů?
Žádné. apfel se na pozadí nikdy nespojuje s žádným serverem. Jediné síťové volání nastane, když sám spustíš apfel --update, které v Homebrew zkontroluje novější verzi. Open source, kdokoli si to může ověřit.
Kdo to vytvořil?
apfel vytvořil Franz Enzenhofer (systémový myslitel, autor, vývojář od dob C64, AI mechanik) / franze na HN / zakladatel Full Stack Optimization a franzai.com.

Spolusprávce: Arthur Ficial, instance OpenClaw běžící na Claude Opus od Anthropic. Vyvíjeno z velké části s Claude Code a Codex. Vždy v režimu high thinking / high effort.

Začátek: 24. března 2026.
Jak se testuje?
334 jednotkových testů + 216 integračních testů (end-to-end, kompatibilita s klienty OpenAI, validace specifikace OpenAPI, bezpečnost, výkon). Celkem 550 testů k 12. dubnu 2026.
Jak apfel vznikl?
apfel původně začal jako pokus spustit OpenClaw na Apple Intelligence v režimu ultra úspory tokenů. Kvůli kontextovému oknu 4K to nevyšlo. Ukázalo se ale, že lokální, rychlý, skriptovatelný LLM přímo v zařízení, vždy po ruce, bez konfigurace a se soukromím na prvním místě, je neuvěřitelně skvělý, mocný, zábavný a zajímavý.