v1.18.0 · Bez konfigurácie · MIT
apfel
AI zadarmo, ktorú už máš v Macu.
macOS Tahoe obsahuje LLM s 3 miliardami parametrov. apfel ti k nemu dá prístup z CLI po jednom brew install. Žiadne sťahovanie modelov, žiadne API kľúče, žiadna konfigurácia - jednoducho to funguje.
$ brew install apfel
6.6k+ hviezd na github.com/Arthur-Ficial/apfel
Vyžaduje: Apple Silicon · macOS Tahoe · zapnutú Apple Intelligence
Prvýkrát s apfel? Začnite 60-sekundovým návodom (v angličtine)
Všetko beží v tvojom zariadení. Žiadne sieťové volania. Žiadne dáta neopustia tvoj Mac.
Pozri sa naň v akcii.
Od brew install k odpovedi AI za 12 sekúnd. Bez akejkoľvek konfigurácie.
Žiadna konfigurácia. Žiadne sťahovanie LLM. Žiadne poplatky za tokeny.
Iné lokálne AI nástroje sú skvelé, ale vyžadujú stiahnutie modelov a konfiguráciu. apfel nepotrebuje nič - model už v tvojom Macu je. Jeden brew install. Hotovo.
Model pod kapotou
Apple ML ResearchTri nástroje. Jedna inštalácia.
CLI, server kompatibilný s OpenAI a interaktívny chat. Všetko z jediného brew install. Žiadne ďalšie sťahovanie.
UNIXový nástroj
Funguje v rúrach a dá sa skladať s ďalšími nástrojmi. Spolupracuje s jq, xargs a tvojimi shellovými skriptami. stdin, stdout, výstup JSON, JSON podľa schémy cez --schema, viac kôl konverzácie zo súboru so správami cez --messages, prílohy súborov, správne návratové kódy.
OpenAI server
Priama náhrada na localhost:11434. Nasmeruj naň ľubovoľné OpenAI SDK a ide sa. Chat Completions a Responses API, streamovanie, tool calling, výstup JSON Schema, CORS.
Interaktívny chat
Konverzácie s viacerými kolami a automatickou správou kontextu. Päť stratégií orezávania. Podpora systémového promptu. Stačí v termináli napísať apfel a začneš. Všetko v tvojom Macu.
Natívna podpora MCP.
Daj lokálnemu modelu Apple nástroje. Akékoľvek nástroje.
Pripoj servery nástrojov cez --mcp
apfel ovláda Model Context Protocol. Nasmeruj ho na ľubovoľný MCP server a model v zariadení dostane nástroje - matematiku, API, databázy, čokoľvek, pre čo sa dá napísať server.
- Funguje vo všetkých troch režimoch - CLI, server aj chat
- Pri štarte sám nájde nástroje cez MCP tools/list
- Volania nástrojov sa automaticky rozpoznajú, vykonajú a výsledky sa vrátia modelu
- Bez prepínača --mcp žiadna réžia - nula tokenov navyše, nula zmien v ceste kódu
- V balíku je MCP server s kalkulačkou ako proof of concept
- Vzdialené MCP servery cez URL -
--mcp https://...s voliteľným overením tokenom Bearer
Ako to funguje.
Apple zabudoval LLM do každého Macu. A ten tam len tak leží. apfel k nemu otvára dvere - bez akejkoľvek konfigurácie.
Apple dodáva LLM priamo v zariadení
Od macOS 26 (Tahoe) má každý Mac s Apple Silicon jazykový model ako súčasť Apple Intelligence. Apple ho sprístupňuje cez framework FoundationModels - Swift API, ktoré aplikáciám dáva prístup k SystemLanguageModel. Celá inferencia beží na Neural Engine a GPU. Žiadne sieťové volania, žiadny cloud, žiadne API kľúče. Model tam jednoducho je.
Lenže Apple ho používa len pre Siri
V predvolenom stave model v zariadení poháňa Siri, Writing Tools a systémové funkcie. Neexistuje žiadny príkaz v termináli, žiadny HTTP endpoint, žiadny spôsob, ako cezeň poslať text rúrou. Framework FoundationModels síce existuje, ale aby si ho mohol použiť, musíš napísať aplikáciu vo Swifte. A presne to robí apfel.
Čo apfel pridáva
apfel je binárka vo Swifte 6.3, ktorá obaľuje LanguageModelSession a sprístupňuje ju tromi spôsobmi: ako UNIXový nástroj príkazového riadka so stdin/stdout, ako HTTP server kompatibilný s OpenAI (postavený na Hummingbird) a ako interaktívny chat so správou kontextu.
Rieši to, čo holé API od Apple nevie: správne návratové kódy, výstup JSON, prílohy súborov, päť stratégií orezávania kontextu pre malé kontextové okno (4 096 tokenov, 8 192 na Macoch s M3 a novších s macOS 27), skutočné počítanie tokenov cez SDK a prevod schém nástrojov OpenAI do natívneho formátu Apple Transcript.ToolDefinition.
Súkromie už z princípu.
Pri používaní apfel ani jedno HTTP volanie. Každé tvrdenie nižšie odkazuje na dokumentáciu priamo od Apple.
V zariadení. Funguje offline.
Framework FoundationModels beží celý na Neural Engine tvojho Apple Silicon. Žiadny server, žiadny cloud, žiadne pripojenie na internet.
Tvoje dáta zostanú tvoje.
Apple nezbiera prompty, odpovede ani žiadne údaje o používaní z inferencie v zariadení. Nič sa neukladá, nič sa neodosiela.
Nikdy sa nepoužijú na trénovanie.
Apple trénuje svoje základné modely výhradne na licencovaných a verejných dátach. Tvoje interakcie sa do trénovania nikdy nedostanú.
apfel nepridáva žiadne sledovanie.
Žiadna analytika, žiadna telemetria, žiadne automatické kontroly aktualizácií, žiadne hlásenie pádov, žiadne volanie domov. Jediné sieťové volanie, ktoré apfel kedy urobí, je, keď sám spustíš apfel --update. Celý kód je open source.
Výkonné nástroje v balení.
Shellové skripty v priečinku demo/. Najprv nainštaluj apfel, potom si vezmi tie, ktoré chceš.
cmd
Z bežnej reči na príkaz shellu. Povedz, čo chceš, a dostaneš príkaz.
oneliner
Reťazce rúr z obyčajného popisu. awk, sed, sort, uniq - vygenerované za teba.
mac-narrator
Komentuje dianie v systéme tvojho Macu ako prírodopisný dokument.
explain
Vysvetlí akýkoľvek príkaz, chybové hlásenie alebo kus kódu zrozumiteľnou rečou.
wtd
Čo je to za adresár? Okamžitá orientácia v akomkoľvek projekte.
gitsum
Zhrnie posledné commity v gite do pár viet.
30 užitočných a skvelých one-linerov.
Každý príkaz otestovaný na skutočnom Macu. Spájaj apfel s ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - toto cloudová AI nedokáže, lebo nevidí tvoje procesy, tvoju schránku ani tvoj git diff. apfel áno.
Čo mi práve teraz žerie CPU.
$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"
-> Najviac CPU berie WindowServer: 42,6 %.
Ktoré aplikácie počúvajú na ktorých portoch.
$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
Ktorý zväzok je najbližšie k zaplneniu.
$df -h | apfel "which volume is fullest, one sentence"
-> Najplnší je /dev/disk3s1: 263Gi z 926Gi.
vm_stat preložený do ľudskej reči.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k stránok aktívnych, 266k wired - pamäť je dosť vyťažená.
Ktoré priečinky tu zaberajú najviac miesta.
$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"
-> Vedú Library (36G) a Downloads (604M).
Najväčšie súbory v tomto priečinku.
$ls -laS | head -10 | apfel "what are the biggest files here, just file names"
-> apfel-quick-preview.png, og.png, translate-preview.png ...
Ktoré aplikácie práve teraz komunikujú s internetom.
$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 batérie a zostávajúci čas na jednom riadku.
$pmset -g batt | apfel "battery health and percent, one line"
-> Plne nabitá, kondícia 100 %, práve aktívna.
Zhrň posledné commity zrozumiteľnou rečou.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Aktualizácie z v1.2.1 na v1.3.2, pridané sesterské projekty ...
Napíš jednoriadkovú poznámku k vydaniu z posledných commitov.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Vydaná v1.3.2: 5053 hviezd, 783 testov, aktualizácie.
Oprav gramatiku toho, čo máš v schránke, a vráť opravu späť.
$pbpaste | apfel "fix grammar" | pbcopy
-> Z „i has went“ je „I went“ - späť v schránke.
Prelož schránku do japončiny a vráť ju späť.
$pbpaste | apfel "translate to japanese" | pbcopy
-> V schránke je teraz japonský preklad.
Zhrň záplavu textu zo schránky do 3 bodov.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 úderné body priamo v termináli.
Vytiahni z poznámok zo stretnutia v schránke jasné úlohy.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> „Sarah drafts Q3 budget“, „email design team“, ... späť v schránke.
Nechaj sa nahlas upozorniť, keď dlhá úloha skončí (tu o 30 minút).
$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say
-> Mac povie: „Tvoja dlhá úloha práve skončila, dobrá práca!“
Počkaj, kým sa súbor objaví v Downloads, a ohlás 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; keď sa objaví Report.pdf, Mac to oznámi.
Počkaj, kým dlho bežiaci proces skončí, a ohlás 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; keď ffmpeg skončí, Mac to oznámi.
Každých 30 minút nahlas zhrň, čo si práve 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ždú polhodinu, čítaný nahlas, kým ty ďalej kóduješ.
Každých 15 minút nahlas varuj, keď batéria klesne pod 20 percent.
$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, kým batéria neklesne; potom Mac nahlas vykríkne priateľské, ale naliehavé varovanie.
Sleduj URL, kým nevráti 2xx, a potom nahlas osláv 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, kým staging nenabehne; Mac povie „Tvoj deploy je vonku, URL odpovedá!“.
Preformuluj ležérnu vetu na niečo zdvorilé.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> „Could you please share the documents at your earliest ...“
Zavolaj URL a opýtaj sa, čo sa deje, len podľa hlavičiek.
$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"
-> GitHub vracia HTML stránku s prísnym cachovaním a bezpečnostnými hlavičkami.
Dnešné Hacker News zhrnuté do jednej vety a prečítané nahlas.
$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say
-> Mac prečíta hlavné správy dňa v jednom stručnom zhrnutí.
Vysvetli JSON blob zrozumiteľnou rečou.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Používateľka Alice s plánom pro a 42 kreditmi.
Počítanie bez otvárania kalkulačky.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Vygeneruj regex bez toho, aby si 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,}$
Opýtaj sa na bashový one-liner, ktorý si zabudol.
$apfel "give me one find command that lists files larger than 100MB, just the bash command"
-> find / -type f -size +100M
Nechaj si vysvetliť záhadný príkaz namiesto hádania.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Rozbalí tar archív komprimovaný gzipom do aktuálneho adresára.
Nepamätáš si presný príkaz gitu? Jednoducho sa opýtaj.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Rozlúskni cudzí regex jednou vetou.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> Zodpovedá 3-cifernej predvoľbe, spojovníku a 4 cifrám - formát telefónneho čísla v USA.
Preveď voľne zapísaný dátum 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
Zhrň celý súbor do 3 bodov.
$apfel -f README.md "summarize in 3 bullets"
-> 3 body: rozsah, inštalácia, použitie.
Kompatibilný s OpenAI.
Zmeň jedno URL. Kód nechaj tak.
Priama náhrada
apfel hovorí jazykom OpenAI API. Každá klientska knižnica, framework alebo nástroj, ktorý komunikuje s OpenAI, môže namiesto toho komunikovať s AI v tvojom Macu. Stačí zmeniť základné URL.
- ✓ POST /v1/chat/completions
- ✓ POST /v1/responses (Responses API)
- ✓ Streamovanie (SSE)
- ✓ Tool calling / function calling
- ✓ GET /v1/models
- ✓ response_format: json_object, json_schema
- ✓ časti image_url ako data URL (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ CORS pre klientov v prehliadač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)
Rovnaký model ako fm od Apple. Iná úloha.
macOS 27 obsahuje fm, vlastné rozhranie príkazového riadka od Apple pre model v zariadení. Tu sa cesty oboch nástrojov rozchádzajú.
| apfel | Apple fm | |
|---|---|---|
| Beží na | macOS 26 aj 27, jedna binárka | len macOS 27 |
| Inštalácia | brew install apfel | Už tam je (raz sudo fm license) |
| Klienti OpenAI fungujú bez zmien | Áno: predvolene JSON, usage, rešpektuje max_tokens, namapované chyby | Streamuje, ak ho nepožiadaš o opak, ignoruje max_tokens, 500 pri guardrails |
| Tool calling a MCP | Natívne volania nástrojov, lokálne aj vzdialené MCP servery | Žiadne (pri tools unikajú tokeny šablóny do odpovede) |
| Skriptovanie | --code, -o json, 9 návratových kódov, --count-tokens --strict | Čistý text, návratový kód 0 alebo 1 |
| Súbory na vstupe | Text, PDF, obrázky: text z OCR na oboch systémoch, na macOS 27 navyše aj samotný obrázok do modelu | Obrázky do modelu, plus vstavané nástroje na OCR a čiarové kódy |
| Trvalé relácie chatu | Nie | Pomenované prepisy, --resume |
| Rýchlosť | Rovnaký model na rovnakom Macu, rovnaké kontextové okno (4 096 tokenov na tomto M2, 8 192 na M3 a novších), totožné počty tokenov. Jednorazový prompt: 0,35 s vs 0,30 s. | |
Krátka história. apfel bol vonku prvý: prvý commit a v0.1.0 dňa 24. marca 2026, prvé vydanie na GitHube 31. marca 2026 a v apríli titulná strana Hacker News. Apple oznámil fm na WWDC 8. júna 2026 a vydal ho 14. septembra 2026 s macOS 27. Oba poháňajú rovnaký model v zariadení cez rovnaký framework FoundationModels; apfel je ten s otvoreným kódom a ten, ktorý beží aj na macOS 26.
Každý riadok bol zmeraný na macOS 27.0.1 (Apple M2, 24 GB) dňa 2026-10-05 a meria sa znova pri každom vydaní apfel. Celá stránka obsahuje testy servera, tabuľku zhody počtu tokenov a všetky príkazy, ktorými to zopakuješ.
Obľúbený na GitHube.
Od nuly k 6,610 hviezdam. A ďalšie pribúdajú.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Dať hviezdu na GitHubeÚdaje k
Poďme na to.
Žiadne sťahovanie modelov. Žiadna registrácia. Žiadne API kľúče. Len toto.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Zostavenie zo zdrojákov
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
Strom apfel.
Rastúca rodina natívnych nástrojov pre macOS postavených na apfel - a sesterské projekty, ktoré do terminálu prinášajú ďalšie frameworky od Apple.
apfel-chat
Chatovací klient pre macOS s viacerými konverzáciami. Streamovaný markdown, hlasový vstup aj výstup, analýza obrázkov - plne súkromne, bez API kľúčov, bez cloudu.
SwiftUI Produkčný
apfelpad
Poznámkový blok so vzorcami na premýšľanie. Napíš do svojho markdownu =apfel("summarize this") a sleduj, ako sa výsledok streamuje priamo do textu. Ako =SUM, len pre jazyk.
apfel-quick
Okamžitá AI vrstva. Kdekoľvek stlač Ctrl+Space, napíš otázku a odpoveď sa streamuje do schránky. Bez Wi-Fi, bez účtu, bez faktúry.
SwiftUI Novinka
apfel-gui
Natívne ladiace GUI pre macOS vo SwiftUI. Chatuj s Apple Intelligence, prezeraj požiadavky a odpovede, logy, prevod reči na text a textu na reč - všetko v zariadení.
SwiftUI
apfel-clip
AI akcie so schránkou z lišty menu. Stlač cmd+shift+V na ľubovoľnom texte - oprav gramatiku, prelož, vysvetli kód, zhrň. Plne v zariadení, bez API kľúčov.
SwiftUI Produkčný
apfel-mcp
Daj apfel prístup k webu a k svojim súborom. Štyri malé MCP nástroje - url-fetch, ddg-search, search-and-fetch a čítačka súborov len na čítanie - každý skrátený tak, aby sa zmestil do malého kontextového okna apfel (4 096 tokenov na väčšine Macov, 8 192 na M3 a novších s macOS 27).
Python Novinka
apfel-run
Drobný UNIXový wrapper, ktorý dáva apfel trvalý register MCP. Zapínaj a vypínaj MCP servery podľa mena v obyčajnom textovom konfiguračnom súbore. Prežije reštart, bez GUI, bez démona.
Shell Novinka
apfel-server-kit
Zdieľaný Swift balík, na ktorom stojí celý ekosystém. Nájdi a spusti lokálny proces apfel --serve a streamuj z neho. Chrbtica, s ktorou hovorí každá SwiftUI aplikácia apfel.
Swift Novinka
auge
Sesterský projekt. apfel robí jazyk, auge zrak. Jedno CLI na OCR, klasifikáciu obrázkov, čiarové kódy a detekciu tvárí - na 100 % v zariadení vďaka frameworku Vision od Apple. Bez API kľúčov, bez cloudu.
Swift Sesterský projekt
translate
Sesterský projekt. UNIXový filter plus HTTP server ako priama náhrada za DeepL, LibreTranslate a Google v2 - poháňaný frameworkom Translation od Apple, ktorý beží v zariadení. Na 100 % v zariadení, natvrdo vynútené cez NetworkGuard. Bez API kľúčov, bez cloudu.
Swift Sesterský projektČasté otázky.
Otázky pozbierané z Hacker News a Redditu.
Akú verziu macOS potrebujem?
Má apfel prístup k mojim osobným údajom?
Opúšťajú môj Mac nejaké dáta?
Model: framework FoundationModels od Apple funguje bez pripojenia na internet a beží celý na Neural Engine. Tvoje prompty a odpovede nikdy neopustia zariadenie. Používateľské dáta sa nikdy nepoužívajú na trénovanie.
Nástroj: apfel na tom nič nemení. Žiadna analytika, žiadna telemetria, žiadne sledovanie, žiadne automatické kontroly aktualizácií, žiadne hlásenie pádov, žiadne volanie domov. Open source, ktokoľvek si to môže overiť.
Aké veľké je kontextové okno?
apfel --model-info vypíše okno, ktoré tvoj Mac skutočne má. Skvelé na shellové skripty, zhrnutia a úpravy textu. Nehodí sa na dlhé konverzácie ani veľké dokumenty.V čom je model dobrý? S čím má problémy?
Slabší v: matematike, vybavovaní faktov, dlhých konverzáciách, generovaní zložitého kódu.
Model radšej odmietne, než by halucinoval. Je to zámerné rozhodnutie Apple.
Je režim servera bezpečný?
--token), kontrola origin, logovacie endpointy len v režime debug. Podrobnosti v server-security.md.Musím zapnúť Apple Intelligence?
Ako aktualizujem apfel?
apfel --update. Zistí spôsob inštalácie, skontroluje novšiu verziu a pred aktualizáciou sa opýta. Ručne: brew upgrade apfel alebo git pull && make install.Aký model používa?
Čím sa apfel líši od Ollama alebo LM Studio?
Podporuje apfel MCP a tool calling?
--mcp <server>. Sprievodca tool callingom.Čím sa apfel líši od fm, vlastného CLI od Apple v macOS 27?
fm, rozhranie príkazového riadka od Apple pre rovnaký model v zariadení. apfel k tomu pridáva server kompatibilný s OpenAI s tool callingom, MCP, výstupom JSON Schema, obrázkami na vstupe ako data URL, poctivými návratovými kódmi a podporou macOS 26. Zmerané vedľa seba: apfel vs fm.Má apfel telemetriu alebo funkcie volania domov?
apfel --update, ktorý v Homebrew skontroluje novšiu verziu. Open source, ktokoľvek si to môže overiť.Kto to vytvoril?
Spolusprávca: Arthur Ficial, inštancia OpenClaw bežiaca na Claude Opus od Anthropic. Vyvíjané z veľkej časti s Claude Code a Codex. Vždy v režime high thinking / high effort.
Začiatok: 24. marca 2026.