v1.18.0 · Nula konfiguracije · MIT
apfel
Besplatni AI koji već imaš na Macu.
macOS Tahoe dolazi s LLM-om od 3 milijarde parametara. apfel ti daje pristup preko CLI-ja jednom naredbom brew install. Bez preuzimanja modela, bez API ključeva, bez konfiguracije. 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? Započ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 ikakve konfiguracije.
Nula konfiguracije. Nula preuzimanja LLM-a. Nula troškova za tokene.
Drugi lokalni AI alati su odlični, ali traže preuzimanje modela i konfiguraciju. 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 s OpenAI-jem i interaktivni chat. Sve uz jedan brew install. Bez dodatnih preuzimanja.
UNIX alat
Radi s pipeovima i lako se kombinira. Surađuje s jq, xargs i tvojim shell skriptama. stdin, stdout, JSON izlaz, JSON valjan prema shemi uz --schema, razgovor u više koraka iz datoteke s porukama uz --messages, privitci datoteka, ispravni exit kodovi.
OpenAI server
Izravna 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 upiši apfel u terminal i kreni. Sve na tvom Macu.
Izvorna podrška za MCP.
Daj Appleovu modelu na uređaju alate. Bilo kakve alate.
Spoji servere s alatima uz --mcp
apfel govori Model Context Protocol. Usmjeri ga na bilo koji MCP server i model na uređaju dobiva alate - matematiku, API-je, baze podataka, sve za što 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 automatski se prepoznaju i izvršavaju, a rezultati vraćaju modelu
- Bez zastavice --mcp nema dodatnog opterećenja - nula dodatnih tokena, nula promjena u kodu
- Uključen je MCP server s kalkulatorom kao dokaz koncepta
- Udaljeni MCP serveri preko URL-a -
--mcp https://...s opcionalnom autentikacijom Bearer tokenom
Kako radi.
Apple je ugradio LLM u svaki Mac. I tamo samo stoji. apfel mu daje ulazna vrata - bez ikakve konfiguracije.
Apple isporučuje LLM na uređaju
Od macOS 26 (Tahoe) svaki Mac s Apple Siliconom ima jezični model kao dio Apple Intelligencea. Apple ga otvara preko frameworka FoundationModels - Swift API-ja koji aplikacijama daje pristup SystemLanguageModel. Inferencija se u cijelosti 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 funkcije sustava. Nema naredbe za terminal, nema HTTP endpointa, nema načina da kroz njega provučeš tekst pipeom. Framework FoundationModels postoji, ali za njegovo korištenje moraš napisati Swift aplikaciju. Upravo to radi apfel.
Što apfel dodaje
apfel je Swift 6.3 binarna datoteka koja omata LanguageModelSession i nudi ga na tri načina: kao UNIX alat za naredbeni redak sa stdin/stdout, kao HTTP server kompatibilan s 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, privitke datoteka, pet strategija skraćivanja konteksta za mali kontekstni prozor (4.096 tokena, 8.192 na Macovima s M3 i novijim čipom uz macOS 27), stvarno brojanje tokena preko SDK-a i pretvorbu OpenAI shema alata u Appleov izvorni format Transcript.ToolDefinition.
Privatnost po dizajnu.
Ni jedan jedini HTTP poziv dok koristiš apfel. Svaka tvrdnja u nastavku vodi na Appleovu dokumentaciju.
Na uređaju. Radi offline.
Framework FoundationModels radi u potpunosti na Neural Engineu tvog Apple Silicona. Bez servera, bez clouda, bez internetske veze.
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 sprema, ništa se ne šalje.
Nikad se ne koristi za treniranje.
Apple trenira svoje temeljne modele isključivo na licenciranim i javnim podacima. Tvoje interakcije nikad nisu dio procesa treniranja.
apfel ne dodaje nikakvo praćenje.
Bez analitike, bez telemetrije, bez automatskih provjera ažuriranja, bez izvještaja o rušenju, 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 uključeni.
Shell skripte u mapi demo/. Prvo instaliraj apfel, a onda uzmi one koje želiš.
cmd
Iz prirodnog jezika u shell naredbu. Reci što želiš i dobij naredbu.
oneliner
Lanci pipeova iz običnog jezika. awk, sed, sort, uniq - generirani za tebe.
mac-narrator
Prepričava aktivnost tvog Maca kao dokumentarac o prirodi.
explain
Objašnjava bilo koju naredbu, poruku o pogrešci ili isječak koda jednostavnim riječima.
wtd
Što je u ovom direktoriju? Trenutačna orijentacija u bilo kojem projektu.
gitsum
Sažima nedavne git commitove u nekoliko rečenica.
30 korisnih i zgodnih one-linera.
Svaka naredba testirana na stvarnom Macu. Spoji apfel s ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - kombiniranje kojem cloud AI ne može parirati jer ne vidi tvoje procese, tvoj međuspremnik ni tvoj git diff. apfel vidi.
Što 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 punom.
$df -h | apfel "which volume is fullest, one sentence"
-> /dev/disk3s1 je najpuniji, 263Gi od 926Gi.
vm_stat preveden u običan jezik.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k aktivnih stranica, 266k wired - znatan dio memorije je u upotrebi.
Koje mape ovdje 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 s 36G i Downloads s 604M.
Najveće datoteke u ovoj mapi.
$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 retku.
$pmset -g batt | apfel "battery health and percent, one line"
-> Potpuno napunjena, stanje 100%, trenutačno aktivna.
Sažmi nedavne commitove običnim riječima.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Ažuriranja s v1.2.1 na v1.3.2, dodani sestrinski projekti ...
Napiši release note u jednom retku iz nedavnih commitova.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Objavljen v1.3.2 s 5053 zvjezdice, 783 testa, ažuriranja.
Ispravi gramatiku onoga što je u međuspremniku i vrati ispravak natrag.
$pbpaste | apfel "fix grammar" | pbcopy
-> "i has went" postaje "I went" - natrag u međuspremniku.
Prevedi međuspremnik na japanski i vrati ga natrag.
$pbpaste | apfel "translate to japanese" | pbcopy
-> Međuspremnik sada sadrži japanski prijevod.
Sažmi zid teksta iz međuspremnika u 3 natuknice.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 sažete natuknice u tvom terminalu.
Izvuci jasne zadatke iz bilješki sa sastanka u međuspremniku.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> "Sarah priprema proračun za Q3", "poslati mail dizajnerima", ... natrag u međuspremniku.
Neka ti Mac naglas javi kad se 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 upravo je završen, bravo!"
Pričekaj da datoteka stigne u Downloads, pa to javi naglas.
$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.
Pričekaj da dugotrajni proces završi, pa to javi naglas.
$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 što 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 uzvikne 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!".
Preoblikuj ležernu rečenicu u nešto pristojno.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> "Biste li mi, molim Vas, što prije mogli poslati dokumente ..."
Pozovi URL i pitaj što se događa, samo na temelju 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 s 42 kredita.
Matematika bez otvaranja kalkulatora.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Generiraj 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 naredbu umjesto da pogađaš.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Dekomprimira i raspakira gzipani tarball u trenutačni direktorij.
Zaboravio si točnu git naredbu? Samo pitaj.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Dešifriraj tuđi regex u jednoj rečenici.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> Prepoznaje prefiks od 3 znamenke, crticu i 4 znamenke - američki format telefonskog broja.
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 cijelu datoteku u 3 natuknice.
$apfel -f README.md "summarize in 3 bullets"
-> 3 natuknice o opsegu, instalaciji i korištenju.
Kompatibilan s OpenAI-jem.
Promijeni jedan URL. Kod ostaje isti.
Izravna zamjena
apfel govori OpenAI API. Svaka klijentska biblioteka, svaki framework i svaki alat koji razgovara s 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 pregledniku
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, Appleovo vlastito sučelje za naredbeni redak za model na uređaju. Evo gdje se njihovi putovi razilaze.
| apfel | Apple fm | |
|---|---|---|
| Radi na | macOS 26 i 27, jedna binarna datoteka | Samo macOS 27 |
| Instalacija | brew install apfel | Već je tu (jednom sudo fm license) |
| OpenAI klijenti rade bez izmjena | Da: zadano JSON, usage, poštuje max_tokens, mapirane pogreške | Streama ako mu ne kažeš drukčije, ignorira max_tokens, 500 kod guardraila |
| Tool calling i MCP | Izvorni pozivi alata, lokalni i udaljeni MCP serveri | Nema (tools propušta tokene predloška u odgovor) |
| Skriptiranje | --code, -o json, 9 exit kodova, --count-tokens --strict | Običan tekst, exit 0 ili 1 |
| Ulazne datoteke | Tekst, PDF, slike: OCR tekst na oba sustava, 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 novijima), identičan broj tokena. Jednokratni prompt: 0,35 s naspram 0,30 s. | |
Kratka povijest. apfel je bio prvi: prvi commit i v0.1.0 24. ožujka 2026., prvo GitHub izdanje 31. ožujka 2026., naslovnica Hacker Newsa u travnju. Apple je najavio fm na WWDC-u 8. lipnja 2026. i isporučio ga s macOS 27 14. rujna 2026. Oba pokreću isti model na uređaju preko istog frameworka FoundationModels; apfel je onaj open source i onaj koji radi i na macOS 26.
Svaki redak izmjeren je na macOS 27.0.1 (Apple M2, 24 GB) dana 2026-10-05 i ponovno se mjeri za svako izdanje apfela. Na punoj stranici su testovi servera, tablica usporedbe broja tokena i sve naredbe za ponavljanje mjerenja.
Popularan na GitHubu.
Od nule do 6,610 zvjezdica, i broj raste.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Daj zvjezdicu na GitHubuPodaci 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
Stablo apfela.
Rastuća obitelj izvornih macOS alata izgrađenih na apfelu - i sestrinski projekti koji druge Appleove frameworke donose u terminal.
apfel-chat
macOS chat klijent za više razgovora. Markdown u streamingu, govorni ulaz i izlaz, analiza slika - potpuno privatno, bez API ključeva, bez clouda.
SwiftUI Stabilno
apfelpad
Bilježnica s formulama za razmišljanje. Upiši =apfel("summarize this") u svoj markdown i gledaj kako se odgovor ispisuje na licu mjesta. Kao =SUM, samo za jezik.
apfel-quick
Trenutačni AI overlay. Pritisni Ctrl+Space bilo gdje, upiši pitanje i odgovor stiže ravno u međuspremnik. Bez Wi-Fija, bez računa, bez naplate.
SwiftUI Novo
apfel-gui
Izvorni macOS SwiftUI GUI za debugiranje. Razgovaraj s Apple Intelligenceom, pregledaj zahtjeve i odgovore, logove, govor u tekst, tekst u govor - sve na uređaju.
SwiftUI
apfel-clip
AI akcije nad međuspremnikom iz trake izbornika. 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 datoteke. Četiri mala MCP alata - url-fetch, ddg-search, search-and-fetch i čitač datoteka samo za čitanje - svaki skrojen za apfelov mali kontekstni prozor (4.096 tokena na većini Macova, 8.192 na M3 i novijima s 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čne tekstualne konfiguracijske datoteke. Preživljava ponovna pokretanja, bez GUI-ja, bez daemona.
Shell Novo
apfel-server-kit
Zajednički Swift paket na kojem počiva ekosustav. Pronalazi i pokreće lokalni proces apfel --serve te streama iz njega. Kralježnica s kojom razgovara svaka SwiftUI apfel aplikacija.
Swift Novo
auge
Sestrinski projekt. apfel radi s jezikom, auge s vidom. Jedan CLI za OCR, klasifikaciju slika, barkodove i prepoznavanje lica - 100% na uređaju preko Appleova frameworka Vision. Bez API ključeva, bez clouda.
Swift Sestrinski projekt
translate
Sestrinski projekt. UNIX filtar i HTTP server koji izravno 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 projektČesta pitanja.
Pitanja prikupljena s Hacker Newsa i Reddita.
Koja mi verzija macOS-a treba?
Pristupa li apfel mojim osobnim podacima?
Napuštaju li ikakvi podaci moj Mac?
Model: Appleov framework FoundationModels radi bez internetske veze i u potpunosti se izvodi na Neural Engineu. Tvoji promptovi i odgovori nikad ne napuštaju uređaj. Korisnički podaci nikad se ne koriste za treniranje.
Alat: apfel to i čuva. Bez analitike, bez telemetrije, bez praćenja, bez automatskih provjera ažuriranja, bez izvještaja o rušenju, bez javljanja kući. Open source i provjerljiv.
Koliki je kontekstni prozor?
apfel --model-info ispisuje prozor koji tvoj Mac stvarno ima. Odlično za shell skripte, sažetke i obradu teksta. Nije prikladno za duge razgovore ni velike dokumente.U čemu je model dobar? Gdje se muči?
Ograničen u: matematici, prisjećanju činjenica, dugim razgovorima, generiranju složenog koda.
Model radije odbije nego da halucinira. To je Appleov namjeran dizajnerski izbor.
Je li serverski način rada siguran?
--token), provjera origina, log endpointi samo u debug načinu. Detalji u server-security.md.Moram li uključiti Apple Intelligence?
Kako ažurirati 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?
Podržava li apfel MCP i tool calling?
--mcp <server> za spajanje alata. Vodič za tool calling.Po čemu se apfel razlikuje od Appleova CLI-ja fm na macOS 27?
fm, Appleovo sučelje za naredbeni redak za isti model na uređaju. apfel dodaje server kompatibilan s OpenAI-jem s tool callingom, MCP, JSON Schema izlaz, slike kao data URL-ove, iskrene exit kodove i podršku za macOS 26. Izmjereno jedan uz drugoga: 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.Tko je ovo napravio?
Suodržavatelj je Arthur Ficial, instanca OpenClawa koja radi na Anthropicovu Claude Opusu. Intenzivno razvijan uz Claude Code i Codex. Uvijek u načinu high thinking / high effort.
Početak: 24. ožujka 2026.