v1.18.0 · Nula podešavanja · MIT
apfel
Besplatni AI koji već imaš na Macu.
macOS Tahoe dolazi sa LLM-om od 3 milijarde parametara. apfel ti ga otvara preko CLI-ja jednom komandom brew install. Bez preuzimanja modela, bez API ključeva, bez podešavanja. Jednostavno radi.
$ brew install apfel
6.6k+ zvjezdica 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 radi na tvom uređaju. Nema mrežnih poziva. Nikakvi podaci ne napuštaju 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. apfelu ne treba ništa - model je već na tvom Macu. Jedan brew install. Gotovo.
Model ispod haube
Apple ML ResearchTri alata. Jedna instalacija.
CLI, server kompatibilan sa OpenAI-jem i interaktivni chat. Sve uz jedan brew install. Bez dodatnih preuzimanja.
UNIX alat
Radi s pipeovima i lako se kombinuje. Sarađuje sa jq, xargs i tvojim shell skriptama. stdin, stdout, JSON izlaz, JSON validan prema shemi uz --schema, razgovor u više koraka iz fajla s porukama uz --messages, fajlovi kao prilozi, ispravni exit kodovi.
OpenAI server
Direktna zamjena na localhost:11434. Usmjeri bilo koji OpenAI SDK na njega i kreni. Chat Completions i Responses API, streaming, tool calling, JSON Schema izlaz, CORS.
Interaktivni chat
Razgovori u više koraka s automatskim upravljanjem kontekstom. Pet strategija skraćivanja. Podrška za system prompt. Samo ukucaj apfel u terminal i kreni. Sve na tvom Macu.
Izvorna podrška za MCP.
Daj Appleovom modelu na uređaju alate. Bilo kakve alate.
Poveži servere s alatima uz --mcp
apfel govori Model Context Protocol. Usmjeri ga na bilo koji MCP server i model na uređaju dobija alate - matematiku, API-je, baze podataka, sve za šta možeš napisati server.
- Radi u sva tri načina - CLI, server i chat
- Pri pokretanju sam pronalazi alate preko MCP tools/list
- Pozivi alata se automatski prepoznaju i izvršavaju, a rezultati vraćaju modelu
- Bez zastavice --mcp nema dodatnog opterećenja - nula dodatnih tokena, nula promjena u izvršavanju koda
- Uključen je MCP server s kalkulatorom kao proof of concept
- Udaljeni MCP serveri preko URL-a -
--mcp https://...uz opcionu autentifikaciju Bearer tokenom
Kako radi.
Apple je ugradio LLM u svaki Mac. I tu samo stoji. apfel mu daje ulazna vrata - bez ikakvog podešavanja.
Apple isporučuje LLM na uređaju
Od macOS 26 (Tahoe) svaki Mac sa Apple Siliconom ima jezički model kao dio Apple Intelligencea. Apple ga otvara preko frameworka FoundationModels - Swift API-ja koji aplikacijama daje pristup SystemLanguageModel. Cijela inferencija se odvija na Neural Engineu i GPU-u. Bez mrežnih poziva, bez clouda, bez API ključeva. Model je jednostavno tu.
Ali Apple ga koristi samo za Siri
Model na uređaju standardno pokreće Siri, Writing Tools i sistemske funkcije. Nema komande za terminal, nema HTTP endpointa, nema načina da kroz njega pipeom provučeš tekst. Framework FoundationModels postoji, ali da bi ga koristio, moraš napisati Swift aplikaciju. Upravo to radi apfel.
Šta apfel dodaje
apfel je Swift 6.3 binarni fajl koji omotava LanguageModelSession i nudi ga na tri načina: kao UNIX alat za komandnu liniju sa stdin/stdout, kao HTTP server kompatibilan sa OpenAI-jem (izgrađen na Hummingbirdu) i kao interaktivni chat s upravljanjem kontekstom.
Rješava ono što Appleov goli API ne rješava: ispravne exit kodove, JSON izlaz, fajlove kao priloge, pet strategija skraćivanja konteksta za mali kontekstni prozor (4.096 tokena, 8.192 na Macovima sa M3 i novijim čipom uz macOS 27), stvarno brojanje tokena preko SDK-a i pretvaranje OpenAI shema alata u Appleov izvorni format Transcript.ToolDefinition.
Privatnost je ugrađena.
Nijedan HTTP poziv dok koristiš apfel. Svaka tvrdnja ispod vodi na Appleovu vlastitu dokumentaciju.
Na uređaju. Radi offline.
Framework FoundationModels radi u potpunosti na Neural Engineu tvog Apple Silicona. Bez servera, bez clouda, bez internet konekcije.
Tvoji podaci ostaju tvoji.
Apple ne prikuplja promptove, odgovore ni bilo kakve podatke o korištenju iz inferencije na uređaju. Ništa se ne čuva, ništa se ne šalje.
Nikad za treniranje.
Apple trenira svoje osnovne modele isključivo na licenciranim i javno dostupnim podacima. Tvoje interakcije nikad nisu dio treniranja.
apfel ne dodaje nikakvo praćenje.
Bez analitike, bez telemetrije, bez automatskih provjera ažuriranja, bez crash izvještaja, bez javljanja kući. Jedini mrežni poziv koji apfel ikad napravi je kad izričito pokreneš apfel --update. Cijeli kod je open source.
Moćni alati u paketu.
Shell skripte u folderu demo/. Prvo instaliraj apfel, pa uzmi one koje želiš.
cmd
Od prirodnog jezika do shell komande. Reci šta želiš i dobij komandu.
oneliner
Lanci pipeova iz običnog jezika. awk, sed, sort, uniq - generisani za tebe.
mac-narrator
Prepričava šta tvoj Mac radi, kao dokumentarac o prirodi.
explain
Objašnjava bilo koju komandu, poruku o grešci ili isječak koda jednostavnim riječima.
wtd
Šta je u ovom direktoriju? Brzo snalaženje u bilo kojem projektu.
gitsum
Sažima nedavne git commitove u nekoliko rečenica.
30 korisnih i zgodnih one-linera.
Svaka komanda je testirana na pravom Macu. Ulančaj apfel sa ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - kombinacije kojima cloud AI ne može parirati jer ne vidi tvoje procese, tvoj clipboard ni 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 najpuniji.
$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 - znatan dio memorije je zauzet.
Koji folderi ovdje zauzimaju najviše prostora na disku.
$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 ovom folderu.
$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 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 ...
Stanje baterije i preostalo vrijeme u jednom redu.
$pmset -g batt | apfel "battery health and percent, one line"
-> Potpuno napunjena, stanje 100%, trenutno aktivna.
Sažmi nedavne commitove običnim riječima.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Ažuriranja sa v1.2.1 na v1.3.2, dodani sestrinski projekti ...
Napiši release note u jednom redu iz nedavnih commitova.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Objavljen v1.3.2 sa 5053 zvjezdice, 783 testa, ažuriranja.
Ispravi gramatiku onoga što je u clipboardu i vrati ispravljen tekst nazad.
$pbpaste | apfel "fix grammar" | pbcopy
-> "i has went" postaje "I went" - nazad u clipboardu.
Prevedi sadržaj clipboarda na japanski i vrati ga nazad.
$pbpaste | apfel "translate to japanese" | pbcopy
-> U clipboardu je sada japanski prijevod.
Sažmi zid teksta iz clipboarda u 3 tačke.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 sažete tačke u tvom terminalu.
Izvuci konkretne zadatke iz bilješki sa sastanka koje su u clipboardu.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> "Sarah priprema budžet za Q3", "poslati mail dizajnerima", ... nazad u clipboardu.
Neka ti Mac naglas javi kad dugi zadatak završi (ovdje 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 javi.
$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say
-> Provjerava svakih 5 s; kad se pojavi Report.pdf, Mac naglas javi vijest.
Sačekaj da dugotrajni proces završi, pa to javi.
$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say
-> Provjerava svakih 5 s; kad ffmpeg završi, Mac naglas javi vijest.
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 svakih pola sata, pročitan naglas dok ti i dalje kodiraš.
Svakih 15 minuta naglas upozori ako baterija padne ispod 20 posto.
$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
-> Tišina dok baterija ne padne; onda Mac naglas izgovori prijateljsko, 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
-> Provjerava svakih 30 s dok staging ne proradi; Mac kaže "Tvoj deploy je online, URL odgovara!".
Preformuliši ležernu rečenicu u nešto pristojno.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> "Da li biste mi, molim Vas, mogli što prije poslati dokumente ..."
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 zaglavljima za caching i sigurnost.
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 naglas izgovara glavne vijesti dana u jednom sažetom pregledu.
Objasni JSON običnim riječima.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Korisnica 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 kriptičnu komandu umjesto da pogađaš.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Dekompresuje i raspakuje gzipovani tarball u trenutni direktorij.
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}$"
-> Prepoznaje prefiks od 3 cifre, crticu i 4 cifre - američki format broja telefona.
Pretvori neformalno napisan 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 cijeli fajl u 3 tačke.
$apfel -f README.md "summarize in 3 bullets"
-> 3 tačke o namjeni, instalaciji i korištenju.
Kompatibilan sa OpenAI-jem.
Promijeni jedan URL. Kod ostaje isti.
Direktna zamjena
apfel govori OpenAI API. Svaka klijentska biblioteka, svaki framework i svaki alat koji razgovara sa OpenAI-jem može umjesto toga razgovarati s AI-jem na tvom Macu. Samo promijeni 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 dijelovi kao data URL-ovi (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ CORS za klijente u browseru
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 Appleov fm. Druga namjena.
macOS 27 donosi fm, Appleov vlastiti alat za komandnu liniju koji pokreće model na uređaju. Evo gdje im se 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 izmjena | Da: JSON po defaultu, usage, poštuje max_tokens, mapirane greške | Streama ako mu ne kažeš drugačije, ignoriše max_tokens, greška 500 kad reaguju guardraili |
| 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 idu modelu, uz ugrađene alate za OCR i barkodove |
| Trajne chat sesije | Ne | Imenovani transkripti, --resume |
| Brzina | Isti model na istom Macu, 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 historija. apfel je bio prvi: prvi commit i v0.1.0 stigli su 24. marta 2026., prvo GitHub izdanje 31. marta 2026., a naslovna strana Hacker Newsa u aprilu. Apple je najavio fm na WWDC-u 8. juna 2026., a 14. septembra 2026. isporučio ga je uz macOS 27. Oba pokreću isti model na uređaju preko istog frameworka FoundationModels; apfel je onaj koji je open source i onaj koji radi i na macOS 26.
Svaki red je izmjeren na macOS 27.0.1 (Apple M2, 24 GB) 05. 10. 2026. i ponovo se mjeri za svako izdanje apfela. Na punoj stranici su testovi servera, tabela poređenja broja tokena i sve komande za ponavljanje mjerenja.
Popularan na GitHubu.
Od nule do 6,610 zvjezdica, i sve ih je više.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Daj zvjezdicu na GitHubuPodaci na dan
Počni.
Bez preuzimanja modela. Bez registracije. Bez API ključeva. Samo ovo.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Build iz izvornog koda
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
Drvo apfela.
Porodica izvornih macOS alata izgrađenih na apfelu koja stalno raste - i sestrinski projekti koji druge Appleove frameworke donose u terminal.
apfel-chat
macOS chat klijent za više razgovora. Markdown u streamingu, glasovni unos i izlaz, analiza slika - potpuno privatno, bez API ključeva, bez clouda.
SwiftUI Stabilno
apfelpad
Bilježnica s formulama za razmišljanje. Ukucaj =apfel("summarize this") u svoj markdown i gledaj kako se odgovor ispisuje direktno u tekstu. Kao =SUM, samo za jezik.
apfel-quick
Instant AI overlay. Pritisni Ctrl+Space bilo gdje, ukucaj pitanje i odgovor stiže pravo u clipboard. Bez Wi-Fija, bez naloga, bez naplate.
SwiftUI Novo
apfel-gui
Izvorni macOS SwiftUI GUI za debugovanje. Razgovaraj sa Apple Intelligenceom, pregledaj zahtjeve i odgovore, logove, govor u tekst, tekst u govor - sve na uređaju.
SwiftUI
apfel-clip
AI akcije nad clipboardom iz trake menija. Pritisni cmd+shift+V na bilo kojem tekstu - ispravi gramatiku, prevedi, objasni kod, sažmi. Potpuno na uređaju, bez API ključeva.
SwiftUI Stabilno
apfel-mcp
Daj apfelu web i svoje fajlove. Četiri mala MCP alata - url-fetch, ddg-search, search-and-fetch i čitač fajlova (read-only) - svaki skrojen za apfelov mali kontekstni prozor (4.096 tokena na većini Macova, 8.192 na M3 i novijim uz macOS 27).
Python Novo
apfel-run
Mali UNIX wrapper koji apfelu daje trajni MCP registar. Uključuj i isključuj MCP servere po imenu iz običnog tekstualnog konfiguracijskog fajla. Preživljava restarte, bez GUI-ja, bez daemona.
Shell Novo
apfel-server-kit
Zajednički Swift paket na kojem počiva ekosistem. Pronalazi i pokreće lokalni proces apfel --serve i streama iz njega. Kičma s kojom razgovara svaka SwiftUI apfel aplikacija.
Swift Novo
auge
Sestrinski projekat. apfel radi s jezikom, auge s vidom. Jedan CLI za OCR, klasifikaciju slika, barkodove i prepoznavanje lica - 100% na uređaju preko Appleovog frameworka Vision. Bez API ključeva, bez clouda.
Swift Sestrinski projekat
translate
Sestrinski projekat. UNIX filter i HTTP server koji direktno zamjenjuje DeepL, LibreTranslate i Google v2 - pokreće ga Appleov framework Translation na uređaju. 100% na uređaju, što strogo osigurava NetworkGuard. Bez API ključeva, bez clouda.
Swift Sestrinski projekatČesta pitanja.
Pitanja prikupljena sa Hacker Newsa i Reddita.
Koja mi verzija macOS-a treba?
Da li apfel pristupa mojim ličnim podacima?
Da li ikakvi podaci napuštaju moj Mac?
Model: Appleov framework FoundationModels radi bez internet konekcije i u potpunosti se izvršava na Neural Engineu. Tvoji promptovi i odgovori nikad ne napuštaju uređaj. Podaci korisnika se nikad ne koriste za treniranje.
Alat: apfel to i čuva. Bez analitike, bez telemetrije, bez praćenja, bez automatskih provjera ažuriranja, bez crash izvještaja, bez javljanja kući. Open source i provjerljiv.
Koliki je kontekstni prozor?
apfel --model-info ispisuje prozor koji tvoj Mac zaista ima. Odlično za shell skripte, sažetke i obradu teksta. Nije za duge razgovore ni velike dokumente.U čemu je model dobar? Gdje se muči?
Ograničen u: matematici, prisjećanju činjenica, dugim razgovorima, generisanju složenog koda.
Model radije odbije nego da halucinira. To je Appleov namjeran dizajnerski izbor.
Da li je serverski način rada siguran?
--token), provjera origina, log endpointi samo u debug načinu. Detalji u server-security.md.Da li moram uključiti Apple Intelligence?
Kako da ažuriram apfel?
apfel --update. Prepoznaje način instalacije, provjerava ima li novije verzije i pita prije nadogradnje. Ručno: brew upgrade apfel ili git pull && make install.Koji model koristi?
Po čemu se apfel razlikuje od Ollame ili LM Studija?
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 Appleovog CLI-ja fm na macOS 27?
fm, Appleov alat za komandnu liniju za isti model na uređaju. apfel dodaje server kompatibilan sa OpenAI-jem s tool callingom, MCP, JSON Schema izlaz, slike kao data URL-ove, iskrene exit kodove i podršku za macOS 26. Izmjereno jedno pored drugog: apfel vs fm.Ima li apfel telemetriju ili javljanje kući?
apfel --update, koji na Homebrewu provjerava ima li novije verzije. Open source i provjerljiv.Ko je ovo napravio?
Suodržava ga Arthur Ficial, instanca OpenClawa koja radi na Anthropicovom Claude Opusu. Intenzivno razvijan uz Claude Code i Codex. Uvijek u načinu high thinking / high effort.
Početak: 24. mart 2026.