v1.18.0 · Nula podešavanja · MIT
apfel
Besplatni AI koji već imaš na Mac-u.
macOS Tahoe dolazi sa LLM-om od 3 milijarde parametara. apfel ti daje CLI pristup jednom komandom brew install. Bez preuzimanja modela, bez API ključeva, bez podešavanja. Jednostavno radi.
$ brew install apfel
6.6k+ zvezdica na github.com/Arthur-Ficial/apfel
Potrebno: Apple Silicon · macOS Tahoe · uključen Apple Intelligence
Novi ste u apfelu? Počnite vodič od 60 sekundi (na engleskom)
Sve se izvršava na tvom uređaju. Bez mrežnih poziva. Nijedan podatak ne napušta tvoj Mac.
Pogledaj kako radi.
Od brew install do AI odgovora za 12 sekundi. Bez ikakvog podešavanja.
Nula podešavanja. Nula preuzimanja LLM-a. Nula troškova za tokene.
Drugi lokalni AI alati su odlični, ali traže preuzimanje modela i podešavanje. apfel-u ne treba ništa - model je već na tvom Mac-u. Jedan brew install. Gotovo.
Model ispod haube
Apple ML ResearchTri alata. Jedna instalacija.
CLI, server kompatibilan sa OpenAI i interaktivni čet. Sve uz jedan brew install. Bez dodatnih preuzimanja.
UNIX alat
Radi sa pipe-ovima i lako se kombinuje. Sarađuje sa jq, xargs i tvojim shell skriptama. stdin, stdout, JSON izlaz, JSON usklađen sa šemom preko --schema, razgovor u više koraka iz fajla poruka preko --messages, prilozi fajlova, ispravni exit kodovi.
OpenAI server
Direktna zamena na localhost:11434. Usmeri bilo koji OpenAI SDK na njega i kreni. Chat Completions i Responses API, streaming, tool calling, JSON Schema izlaz, CORS.
Interaktivni čet
Razgovori u više koraka sa automatskim upravljanjem kontekstom. Pet strategija skraćivanja. Podrška za system prompt. Samo otkucaj apfel u terminalu i počni. Sve na tvom Mac-u.
Izvorna podrška za MCP.
Daj Apple-ovom modelu na uređaju alate. Bilo kakve alate.
Poveži servere alata preko --mcp
apfel govori Model Context Protocol. Usmeri ga na bilo koji MCP server i model na uređaju dobija alate - matematiku, API-je, baze podataka, sve za šta možeš da napišeš server.
- Radi u sva tri režima - CLI, server i čet
- Pri pokretanju sam pronalazi alate preko MCP tools/list
- Pozivi alata se automatski prepoznaju, izvršavaju, a rezultati vraćaju modelu
- Bez --mcp zastavice nema opterećenja - nula dodatnih tokena, nula izmena u putanji koda
- Dolazi sa MCP serverom za kalkulator kao dokazom koncepta
- Udaljeni MCP serveri preko URL-a -
--mcp https://...sa opcionom Bearer token autentifikacijom
Kako radi.
Apple je ugradio LLM u svaki Mac. I samo stoji neiskorišćen. apfel mu daje ulazna vrata - bez ikakvog podešavanja.
Apple isporučuje LLM na uređaju
Od macOS 26 (Tahoe), svaki Mac sa Apple Silicon-om ima jezički model kao deo Apple Intelligence. Apple ga izlaže kroz FoundationModels framework - Swift API koji aplikacijama daje pristup SystemLanguageModel. Ceo inference se izvršava na Neural Engine-u i GPU-u. Bez mrežnih poziva, bez oblaka, bez API ključeva. Model je jednostavno tu.
Ali Apple ga koristi samo za Siri
Podrazumevano model na uređaju pokreće Siri, Writing Tools i sistemske funkcije. Nema komande za terminal, nema HTTP endpoint-a, nema načina da kroz njega propustiš tekst pipe-om. FoundationModels framework postoji, ali da bi ga koristio, moraš da napišeš Swift aplikaciju. Upravo to radi apfel.
Šta apfel dodaje
apfel je Swift 6.3 binarni fajl koji obmotava LanguageModelSession i izlaže ga na tri načina: kao UNIX alat za komandnu liniju sa stdin/stdout, kao HTTP server kompatibilan sa OpenAI (izgrađen na Hummingbird-u) i kao interaktivni čet sa upravljanjem kontekstom.
Rešava ono što Apple-ov sirovi API ne rešava: ispravne exit kodove, JSON izlaz, priloge fajlova, pet strategija skraćivanja konteksta za mali kontekstni prozor (4.096 tokena, 8.192 na M3 i novijim Mac računarima sa macOS 27), pravo brojanje tokena preko SDK-a i pretvaranje OpenAI šema alata u Apple-ov izvorni format Transcript.ToolDefinition.
Privatnost po dizajnu.
Nijedan HTTP poziv dok koristiš apfel. Svaka tvrdnja ispod vodi na Apple-ovu dokumentaciju.
Na uređaju. Radi i oflajn.
FoundationModels framework radi u potpunosti na Neural Engine-u tvog Apple Silicon-a. Ne treba ti server, oblak ni internet veza.
Tvoji podaci ostaju tvoji.
Apple ne prikuplja prompt-ove, odgovore niti bilo kakve podatke o korišćenju iz inference-a na uređaju. Ništa se ne čuva, ništa se ne šalje.
Nikad se ne koristi za treniranje.
Apple trenira svoje foundation modele isključivo na licenciranim i javnim podacima. Tvoje interakcije nikada ne ulaze u proces treniranja.
apfel ne dodaje nikakvo praćenje.
Bez analitike, bez telemetrije, bez automatskih provera ažuriranja, bez izveštaja o padovima, bez javljanja kući. Jedini mrežni poziv koji apfel ikada uputi je kada izričito pokreneš apfel --update. Ceo kod je open source.
Moćni alati u paketu.
Shell skripte u fascikli demo/. Prvo instaliraj apfel, pa uzmi one koje ti trebaju.
cmd
Od prirodnog jezika do shell komande. Reci šta hoćeš, dobij komandu.
oneliner
Pipe lanci iz običnog jezika. awk, sed, sort, uniq - generisano za tebe.
mac-narrator
Prepričava šta radi tvoj Mac kao dokumentarac o prirodi.
explain
Objašnjava bilo koju komandu, poruku o grešci ili delić koda običnim jezikom.
wtd
Šta je u ovom direktorijumu? Trenutna orijentacija u bilo kom projektu.
gitsum
Sažima nedavne git commit-ove u nekoliko rečenica.
30 korisnih i kul one-linera.
Svaka komanda je testirana na pravom Mac-u. Poveži apfel sa ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - to ne može nijedan AI u oblaku, jer ne vidi tvoje procese, tvoj clipboard, tvoj git diff. apfel vidi.
Šta mi upravo jede CPU.
$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"
-> WindowServer najviše troši CPU, 42,6%.
Koje aplikacije slušaju na kojim portovima.
$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
Koji je volumen najbliže tome da se napuni.
$df -h | apfel "which volume is fullest, one sentence"
-> /dev/disk3s1 je najpuniji, 263Gi od 926Gi.
vm_stat preveden na običan jezik.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k aktivnih stranica, 266k wired - dosta memorije je zauzeto.
Koje fascikle ovde zauzimaju najviše diska.
$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"
-> Prednjače Library sa 36G i Downloads sa 604M.
Najveći fajlovi u ovoj fascikli.
$ls -laS | head -10 | apfel "what are the biggest files here, just file names"
-> apfel-quick-preview.png, og.png, translate-preview.png ...
Koje aplikacije upravo komuniciraju sa 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 ...
Stanje baterije i preostalo vreme u jednom redu.
$pmset -g batt | apfel "battery health and percent, one line"
-> Potpuno napunjena, stanje 100%, trenutno aktivna.
Sažmi nedavne commit-ove običnim jezikom.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Ažuriranje sa v1.2.1 na v1.3.2, dodati sestrinski projekti ...
Napiši belešku o izdanju u jednom redu iz nedavnih commit-ova.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Izdat v1.3.2 sa 5053 zvezdice, 783 testa, ažuriranja.
Ispravi gramatiku svega što je u clipboard-u i vrati ispravku nazad.
$pbpaste | apfel "fix grammar" | pbcopy
-> "i has went" postaje "I went" - nazad u clipboard-u.
Prevedi clipboard na japanski i vrati ga nazad.
$pbpaste | apfel "translate to japanese" | pbcopy
-> Clipboard sada sadrži japanski prevod.
Sažmi zid teksta iz clipboard-a u 3 tačke.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 jezgrovite tačke u tvom terminalu.
Izvuci jasne zadatke iz beleški sa sastanka u clipboard-u.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> "Sara pravi nacrt budžeta za Q3", "mejl dizajn timu", ... nazad u clipboard-u.
Neka te Mac naglas obavesti kad se dugačak zadatak završi (ovde za 30 minuta).
$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say
-> Mac kaže: "Tvoj dugi zadatak je upravo završen, bravo!"
Sačekaj da fajl stigne u Downloads, pa to objavi.
$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say
-> Proverava na svakih 5s; kad se pojavi Report.pdf, Mac naglas javi vest.
Sačekaj da se dugotrajan proces završi, pa to objavi.
$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say
-> Proverava na svakih 5s; kad ffmpeg stane, Mac naglas javi vest.
Na svakih 30 minuta naglas sažmi šta si upravo isporučio.
$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
-> Automatski standup na pola sata, pročitan naglas dok ti i dalje kodiraš.
Na svakih 15 minuta naglas upozori ako baterija padne ispod 20 procenata.
$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
-> Ćuti dok baterija ne opadne; onda Mac naglas vikne ljubazno, ali hitno upozorenje.
Prati URL dok ne vrati 2xx, pa naglas proslavi 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
-> Proverava na svakih 30s dok staging ne proradi; Mac kaže "Deploy je online, URL odgovara!".
Preformuliši opuštenu rečenicu u nešto učtivo.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> "Da li biste mogli da prosledite dokumenta čim budete u ..."
Pozovi URL i pitaj šta se dešava, samo na osnovu zaglavlja.
$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"
-> GitHub vraća HTML stranicu sa strogim keširanjem i bezbednosnim zaglavljima.
Današnji Hacker News, sažet u jednu rečenicu i pročitan naglas.
$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say
-> Mac izgovara glavne vesti dana u jednom jezgrovitom sažetku.
Objasni JSON običnim jezikom.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Korisnica po imenu Alice na pro planu sa 42 kredita.
Matematika bez otvaranja kalkulatora.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Generiši regex bez napuštanja terminala.
$apfel "regex for a valid email address, just the regex"
-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Pitaj za bash one-liner koji si zaboravio.
$apfel "give me one find command that lists files larger than 100MB, just the bash command"
-> find / -type f -size +100M
Objasni zagonetnu komandu umesto da pogađaš.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Raspakuje gzip tarball u trenutni direktorijum.
Zaboravio si tačnu git komandu? Samo pitaj.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Dešifruj tuđi regex u jednoj rečenici.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> Poklapa prefiks od 3 cifre, crticu i 4 cifre - američki format telefona.
Pretvori neformalno zapisan datum u 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
Sažmi ceo fajl u 3 tačke.
$apfel -f README.md "summarize in 3 bullets"
-> 3 tačke: obim, instalacija, upotreba.
Kompatibilan sa OpenAI.
Promeni jedan URL. Zadrži svoj kod.
Direktna zamena
apfel govori OpenAI API. Svaka klijentska biblioteka, svaki framework, svaki alat koji razgovara sa OpenAI može umesto toga da razgovara sa AI-jem na tvom Mac-u. Samo promeni base URL.
- ✓ POST /v1/chat/completions
- ✓ POST /v1/responses (Responses API)
- ✓ Streaming (SSE)
- ✓ Tool calling / pozivanje funkcija
- ✓ GET /v1/models
- ✓ response_format: json_object, json_schema
- ✓ image_url delovi kao data URL-ovi (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ CORS za klijente u pregledaču
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)
Isti model kao Apple-ov fm. Druga namena.
macOS 27 donosi fm, Apple-ov sopstveni interfejs za komandnu liniju za model na uređaju. Evo gde se njihovi putevi razilaze.
| apfel | Apple fm | |
|---|---|---|
| Radi na | macOS 26 i 27, jedan binarni fajl | Samo macOS 27 |
| Instalacija | brew install apfel | Već je tu (jednom sudo fm license) |
| OpenAI klijenti rade bez izmena | Da: podrazumevano JSON, usage, poštuje max_tokens, mapirane greške | Strimuje ako se ne zatraži drugačije, ignoriše max_tokens, 500 kod guardrail-a |
| Tool calling i MCP | Izvorni pozivi alata, lokalni i udaljeni MCP serveri | Nema (tools propušta tokene šablona u odgovor) |
| Skriptovanje | --code, -o json, 9 exit kodova, --count-tokens --strict | Običan tekst, exit 0 ili 1 |
| Ulazni fajlovi | Tekst, PDF, slike: OCR tekst na oba sistema, a na macOS 27 i sama slika ide modelu | Slike modelu, plus ugrađeni alati za OCR i bar-kodove |
| Trajne čet sesije | Ne | Imenovani transkripti, --resume |
| Brzina | Isti model na istom Mac-u, isti kontekstni prozor (4.096 tokena na ovom M2, 8.192 na M3 i novijim), identičan broj tokena. Jednokratni prompt: 0,35 s naspram 0,30 s. | |
Kratka istorija. apfel je bio prvi: prvi commit i v0.1.0 24. marta 2026, prvo GitHub izdanje 31. marta 2026, naslovna strana Hacker News-a u aprilu. Apple je najavio fm na WWDC-u 8. juna 2026, a isporučio ga uz macOS 27 14. septembra 2026. Oba pokreću isti model na uređaju preko istog FoundationModels framework-a; apfel je onaj open source i onaj koji radi i na macOS 26.
Svaki red je izmeren na macOS 27.0.1 (Apple M2, 24 GB) dana 2026-10-05 i meri se ponovo za svako apfel izdanje. Na celoj stranici su testovi servera, tabela poklapanja broja tokena i svaka komanda za ponavljanje merenja.
Popularan na GitHub-u.
Od nule do 6,610 zvezdica, i broj raste.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Daj zvezdicu na GitHub-uPodaci na dan
Kreni.
Bez preuzimanja modela. Bez registracije. Bez API ključeva. Samo ovo.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Izgradnja iz izvornog koda
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
Drvo apfel-a.
Rastuća porodica izvornih macOS alata izgrađenih na apfel-u - i sestrinski projekti koji donose druge Apple framework-e u terminal.
apfel-chat
macOS čet klijent za više razgovora. Streaming markdown, govorni ulaz i izlaz, analiza slika - potpuno privatno, bez API ključeva, bez oblaka.
SwiftUI Stabilno
apfelpad
Beležnica sa formulama za razmišljanje. Otkucaj =apfel("summarize this") u svoj markdown i gledaj kako se odgovor ispisuje direktno u tekstu. Kao =SUM, ali za jezik.
apfel-quick
Trenutni AI overlay. Pritisni Ctrl+Space bilo gde, otkucaj pitanje i odgovor stiže u tvoj clipboard. Bez Wi-Fi-ja, bez naloga, bez računa.
SwiftUI Novo
apfel-gui
Izvorni macOS SwiftUI GUI za debagovanje. Četuj sa Apple Intelligence, pregledaj zahteve i odgovore, logove, govor u tekst, tekst u govor - sve na uređaju.
SwiftUI
apfel-clip
AI radnje za clipboard iz trake menija. Pritisni cmd+shift+V na bilo kom tekstu - ispravi gramatiku, prevedi, objasni kod, sažmi. Potpuno na uređaju, bez API ključeva.
SwiftUI Stabilno
apfel-mcp
Daj apfel-u veb i svoje fajlove. Četiri mala MCP alata - url-fetch, ddg-search, search-and-fetch i čitač fajlova samo za čitanje - svaki skraćen da stane u apfel-ov mali kontekstni prozor (4.096 tokena na većini Mac računara, 8.192 na M3 i novijim sa macOS 27).
Python Novo
apfel-run
Mali UNIX wrapper koji apfel-u daje trajni MCP registar. Uključuj i isključuj MCP servere po imenu iz običnog tekstualnog konfiguracionog fajla. Preživljava restart, bez GUI-ja, bez demona.
Shell Novo
apfel-server-kit
Zajednički Swift paket na kome počiva ekosistem. Pronalazi i pokreće lokalni apfel --serve proces i strimuje iz njega. Kičma sa kojom razgovara svaka SwiftUI apfel aplikacija.
Swift Novo
auge
Sestrinski projekat. apfel se bavi jezikom, auge vidom. Jedan CLI za OCR, klasifikaciju slika, bar-kodove i prepoznavanje lica - 100% na uređaju preko Apple-ovog Vision framework-a. Bez API ključeva, bez oblaka.
Swift Sestrinski projekat
translate
Sestrinski projekat. UNIX filter i HTTP server kao direktna zamena za DeepL, LibreTranslate i Google v2 - pokreće ga Apple-ov Translation framework na uređaju. 100% na uređaju, strogo obezbeđeno pomoću NetworkGuard-a. Bez API ključeva, bez oblaka.
Swift Sestrinski projekatČesta pitanja.
Pitanja prikupljena sa Hacker News-a i Reddit-a.
Koja verzija macOS-a mi treba?
Da li apfel pristupa mojim ličnim podacima?
Da li bilo kakvi podaci napuštaju moj Mac?
Model: Apple-ov FoundationModels framework radi bez internet veze i izvršava se u potpunosti na Neural Engine-u. Tvoji prompt-ovi i odgovori nikada ne napuštaju uređaj. Korisnički podaci se nikada ne koriste za treniranje.
Alat: apfel to tako i čuva. Bez analitike, bez telemetrije, bez praćenja, bez automatskih provera ažuriranja, bez izveštaja o padovima, bez javljanja kući. Open source i može da se proveri.
Koliki je kontekstni prozor?
apfel --model-info ispisuje prozor koji tvoj Mac zaista ima. Odlično za shell skripte, sažetke i transformacije teksta. Nije za duge razgovore ni velike dokumente.U čemu je model dobar? Gde se muči?
Ograničen u: matematici, prisećanju činjenica, dugim razgovorima, generisanju složenog koda.
Model radije odbije nego što halucinira. To je namerna odluka Apple-a.
Da li je serverski režim bezbedan?
--token), provera origin-a, log endpoint-i samo u debug režimu. Detalji u server-security.md.Da li moram da uključim Apple Intelligence?
Kako da ažuriram apfel?
apfel --update. Prepoznaje način instalacije, proverava da li postoji novija verzija i pita pre nadogradnje. Ručno: brew upgrade apfel ili git pull && make install.Koji model koristi?
Po čemu se apfel razlikuje od Ollama ili LM Studio?
Da li apfel podržava MCP i tool calling?
--mcp <server> da povežeš alate. Vodič za tool calling.Po čemu se apfel razlikuje od Apple-ovog fm CLI-ja na macOS 27?
fm, Apple-ov interfejs za komandnu liniju za isti model na uređaju. apfel dodaje server kompatibilan sa OpenAI sa tool calling-om, MCP, JSON Schema izlaz, slike kao data URL-ove, poštene exit kodove i podršku za macOS 26. Izmereno jedno pored drugog: apfel naspram fm.Da li apfel ima telemetriju ili se javlja kući?
apfel --update, koji na Homebrew-u proverava da li postoji novija verzija. Open source i može da se proveri.Ko je ovo napravio?
Suodržavalac je Arthur Ficial, instanca OpenClaw-a koja radi na Anthropic-ovom Claude Opus-u. Intenzivno razvijan uz Claude Code i Codex. Uvek u režimu high thinking / high effort.
Početak: 24. marta 2026.