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.
$ 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.
Žá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.
Model pod kapotou
Apple ML ResearchTř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.
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.
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.
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
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.
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.
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á.
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.
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.
oneliner
Řetězce rour z obyčejného popisu. awk, sed, sort, uniq - vygenerované za tebe.
mac-narrator
Komentuje dění v systému tvého Macu jako přírodopisný dokument.
explain
Vysvětlí jakýkoli příkaz, chybovou hlášku nebo kus kódu srozumitelnou řečí.
wtd
Co je to za adresář? Okamžitá orientace v jakémkoli projektu.
gitsum
Shrne poslední commity v gitu do pár vět.
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.
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í.
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.
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.
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á!“.
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.
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
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í.
| apfel | Apple fm | |
|---|---|---|
| Běží na | macOS 26 i 27, jedna binárka | jen macOS 27 |
| Instalace | brew install apfel | Už tam je (jednou sudo fm license) |
| Klienti OpenAI fungují beze změn | Ano: výchozí JSON, usage, respektuje max_tokens, namapované chyby | Streamuje, pokud ho nepožádáš o opak, ignoruje max_tokens, 500 při guardrails |
| Tool calling a MCP | Nativní 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 --strict | Prostý text, návratový kód 0 nebo 1 |
| Soubory na vstupu | Text, PDF, obrázky: text z OCR na obou systémech, na macOS 27 navíc i samotný obrázek do modelu | Obrázky do modelu, plus vestavěné nástroje pro OCR a čárové kódy |
| Trvalé relace chatu | Ne | Pojmenované přepisy, --resume |
| Rychlost | Stejný 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í.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Dát hvězdu na GitHubuData k
Pojďme na to.
Žádné stahování modelů. Žádná registrace. Žádné API klíče. Jen tohle.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Sestavení ze zdrojáků
$ 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
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 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.
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
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 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
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
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
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
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
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?
Má apfel přístup k mým osobním datům?
Opouštějí můj Mac nějaká data?
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?
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?
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ý?
--token), kontrola origin, logovací endpointy jen v režimu debug. Podrobnosti v server-security.md.Musím zapnout Apple Intelligence?
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á?
Čím se apfel liší od Ollama nebo LM Studio?
Podporuje apfel MCP a tool calling?
--mcp <server>. Průvodce tool callingem.Čím se apfel liší od fm, vlastního CLI od Apple v macOS 27?
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ů?
apfel --update, které v Homebrew zkontroluje novější verzi. Open source, kdokoli si to může ověřit.Kdo to vytvořil?
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.