v1.18.0 · Brez nastavljanja · MIT
apfel
Brezplačna AI, ki je že na tvojem Macu.
macOS Tahoe ima vgrajen LLM s 3 milijardami parametrov. apfel ti z enim ukazom brew install odpre dostop prek CLI. Brez prenašanja modelov, brez API ključev, brez nastavljanja. Preprosto deluje.
$ brew install apfel
6.6k+ zvezdic na github.com/Arthur-Ficial/apfel
Zahteve: Apple Silicon · macOS Tahoe · vklopljen Apple Intelligence
Ste novi pri apfel? Začnite 60-sekundni vodič (v angleščini)
Vse teče na tvoji napravi. Brez omrežnih klicev. Noben podatek ne zapusti tvojega Maca.
Poglej, kako deluje.
Od ukaza brew install do odgovora AI v 12 sekundah. Brez nastavljanja.
Nič nastavljanja. Nič prenašanja LLM. Nič stroškov za tokene.
Druga lokalna AI orodja so odlična, vendar zahtevajo prenos modelov in nastavljanje. apfel ne potrebuje ničesar: model je že na tvojem Macu. En brew install in končano.
Model pod pokrovom
Apple ML ResearchTri orodja. Ena namestitev.
CLI, strežnik, združljiv z OpenAI, in interaktivni klepet. Vse z enim samim brew install. Brez dodatnih prenosov.
UNIX orodje
Prijazen do cevovodov in sestavljiv. Sodeluje z jq, xargs in tvojimi shell skriptami. stdin, stdout, izhod JSON, JSON v skladu s shemo z --schema, pogovor v več korakih iz datoteke sporočil z --messages, priloge datotek, pravilne izhodne kode.
OpenAI strežnik
Neposredna zamenjava na localhost:11434. Usmeri katerikoli OpenAI SDK nanj in začni. Chat Completions in Responses API, streaming, tool calling, izhod po JSON Schema, CORS.
Interaktivni klepet
Pogovori v več korakih s samodejnim upravljanjem konteksta. Pet strategij krajšanja. Podpora za sistemski prompt. Za začetek v terminal vpiši apfel. Vse na tvojem Macu.
Vgrajena podpora za MCP.
Daj Applovemu modelu v napravi orodja. Katerakoli orodja.
Priključi strežnike orodij z --mcp
apfel govori Model Context Protocol. Usmeri ga na katerikoli MCP strežnik in model v napravi dobi orodja: matematiko, API-je, baze podatkov, karkoli, za kar lahko napišeš strežnik.
- Deluje v vseh treh načinih: CLI, strežnik in klepet
- Ob zagonu samodejno najde orodja prek MCP tools/list
- Klice orodij samodejno zazna, izvede in rezultate vrne modelu
- Brez zastavice --mcp ni nobene obremenitve: nič dodatnih tokenov, nič sprememb v poteku kode
- Priložen je MCP strežnik za kalkulator kot dokaz koncepta
- Oddaljeni MCP strežniki prek URL:
--mcp https://...z neobvezno avtentikacijo z Bearer tokenom
Kako deluje.
Apple je v vsak Mac vgradil LLM. In ta kar čaka, neizkoriščen. apfel mu odpre vhodna vrata, brez kakršnegakoli nastavljanja.
Apple priloži LLM v napravi
Od macOS 26 (Tahoe) naprej ima vsak Mac z Apple Silicon jezikovni model kot del Apple Intelligence. Apple ga ponuja prek ogrodja FoundationModels, Swift API-ja, ki aplikacijam omogoča dostop do SystemLanguageModel. Vse sklepanje teče na Neural Engine in grafičnem procesorju. Brez omrežnih klicev, brez oblaka, brez API ključev. Model je preprosto tam.
Toda Apple ga uporablja le za Siri
Privzeto model v napravi poganja Siri, Writing Tools in sistemske funkcije. Ni ukaza v terminalu, ni HTTP končne točke, besedila ni mogoče spustiti skozenj prek cevovoda. Ogrodje FoundationModels obstaja, a za uporabo moraš napisati aplikacijo v Swiftu. Prav to naredi apfel.
Kaj doda apfel
apfel je binarka v Swift 6.3, ki ovije LanguageModelSession in jo ponudi na tri načine: kot UNIX orodje za ukazno vrstico s stdin/stdout, kot HTTP strežnik, združljiv z OpenAI (zgrajen na Hummingbird), in kot interaktivni klepet z upravljanjem konteksta.
Poskrbi za tisto, česar Applov surovi API ne: pravilne izhodne kode, izhod JSON, priloge datotek, pet strategij krajšanja konteksta za majhno kontekstno okno (4.096 tokenov, 8.192 na Macih z M3 ali novejšim in macOS 27), pravo štetje tokenov prek SDK ter pretvorbo OpenAI shem orodij v Applov izvorni format Transcript.ToolDefinition.
Zasebnost že v zasnovi.
Med uporabo apfel ni niti enega HTTP klica. Vsaka trditev spodaj vodi do Applove lastne dokumentacije.
V napravi. Deluje brez povezave.
Ogrodje FoundationModels teče v celoti na Neural Engine tvojega Apple Silicon. Ne potrebuješ strežnika, oblaka ali internetne povezave.
Tvoji podatki ostanejo tvoji.
Apple pri sklepanju v napravi ne zbira promptov, odgovorov ali kakršnihkoli podatkov o uporabi. Nič se ne shrani, nič se ne pošlje.
Nikoli se ne uporablja za učenje.
Apple svoje temeljne modele uči samo na licenciranih in javnih podatkih. Tvoja uporaba nikoli ne postane del učnih podatkov.
apfel ne doda nobenega sledenja.
Brez analitike, brez telemetrije, brez samodejnega preverjanja posodobitev, brez poročil o sesutjih, brez javljanja domov. Edini omrežni klic, ki ga apfel kdaj naredi, je, ko izrecno zaženeš apfel --update. Celotna koda je odprtokodna.
Zmogljiva orodja so priložena.
Shell skripte v mapi demo/. Najprej namesti apfel, nato si vzemi tiste, ki jih želiš.
cmd
Iz naravnega jezika v shell ukaz. Povej, kaj želiš, in dobiš ukaz.
oneliner
Cevovodi iz navadnega jezika. awk, sed, sort, uniq: ustvarjeni zate.
mac-narrator
Pripoveduje o sistemskem dogajanju na tvojem Macu kot v naravoslovnem dokumentarcu.
explain
Razloži katerikoli ukaz, sporočilo o napaki ali delček kode v preprostem jeziku.
wtd
Kaj je v tej mapi? Takojšnja orientacija v katerikoli kodni bazi.
gitsum
Povzame zadnje git commite v nekaj stavkih.
30 uporabnih in kul enovrstičnikov.
Vsak ukaz je preizkušen na pravem Macu. Poveži apfel s ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say: takšne sestavljivosti AI v oblaku ne zmore, ker ne vidi tvojih procesov, tvojega odložišča, tvojega git diffa. apfel jih vidi.
Kaj mi ta hip žre procesor.
$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"
-> WindowServer porabi največ procesorja, 42,6 %.
Katere aplikacije poslušajo na katerih vratih.
$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
Kateri nosilec je najbolj poln.
$df -h | apfel "which volume is fullest, one sentence"
-> /dev/disk3s1 je najbolj poln, 263Gi od 926Gi.
vm_stat, preveden v razumljiv jezik.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k aktivnih strani, 266k zaklenjenih: v uporabi je precej pomnilnika.
Katere mape tukaj pojedo največ diska.
$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"
-> Prevladujeta Library s 36G in Downloads s 604M.
Največje datoteke v tej mapi.
$ls -laS | head -10 | apfel "what are the biggest files here, just file names"
-> apfel-quick-preview.png, og.png, translate-preview.png ...
Katere aplikacije ta hip komunicirajo z 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 in preostali čas v eni vrstici.
$pmset -g batt | apfel "battery health and percent, one line"
-> Povsem napolnjena, stanje 100 %, trenutno aktivna.
Povzemi zadnje commite v preprostem jeziku.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Posodobitve z v1.2.1 na v1.3.2, dodani sestrski projekti ...
Iz zadnjih commitov sestavi enovrstično opombo ob izdaji.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Izdana v1.3.2: 5053 zvezdice, 783 testi, posodobitve.
Popravi slovnico v tem, kar je v odložišču, in popravek vrni nazaj.
$pbpaste | apfel "fix grammar" | pbcopy
-> »i has went« postane »I went«, spet v odložišču.
Prevedi vsebino odložišča v japonščino in jo vrni nazaj.
$pbpaste | apfel "translate to japanese" | pbcopy
-> V odložišču je zdaj japonski prevod.
Povzemi steno besedila iz odložišča v 3 alinejah.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 jedrnate alineje v tvojem terminalu.
Iz zapiskov sestanka v odložišču izlušči jasne naloge.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> »Sarah pripravi osnutek proračuna za Q3«, »pošlji e-pošto oblikovalcem«, ... spet v odložišču.
Naj te Mac na glas obvesti, ko se dolgo opravilo konča (tukaj v 30 minutah).
$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say
-> Mac reče: »Tvoje dolgo opravilo se je pravkar končalo, bravo!«
Počakaj, da se datoteka pojavi v Downloads, nato to sporoči.
$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say
-> Preverja vsakih 5 s; ko se pojavi Report.pdf, Mac na glas sporoči novico.
Počakaj, da se dolgotrajen proces konča, nato to sporoči.
$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say
-> Preverja vsakih 5 s; ko se ffmpeg konča, Mac na glas sporoči novico.
Vsakih 30 minut na glas povzemi, kaj si pravkar naredil.
$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
-> Samodejni standup vsake pol ure, prebran na glas, medtem ko programiraš naprej.
Vsakih 15 minut na glas opozori, če baterija pade pod 20 odstotkov.
$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
-> Tiho, dokler baterija ne pade; potem Mac na glas zakliče prijazno, a nujno opozorilo.
Spremljaj URL, dokler ne vrne 2xx, nato na glas 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
-> Preverja vsakih 30 s, dokler staging ne zaživi; Mac reče »Tvoj deploy je objavljen, URL se odziva!«.
Preoblikuj sproščen stavek v nekaj vljudnega.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> »Ali bi mi lahko čim prej posredovali dokumente ...«
Pokliči URL in vprašaj, kaj se dogaja, samo na podlagi glav.
$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"
-> GitHub streže stran HTML s strogim predpomnjenjem in varnostnimi glavami.
Današnji Hacker News, povzet v enem stavku in prebran na glas.
$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say
-> Mac v enem jedrnatem povzetku prebere glavne novice dneva.
Razloži JSON v preprostem jeziku.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Uporabnica Alice s paketom pro in 42 krediti.
Računanje brez odpiranja kalkulatorja.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Ustvari regex, ne da bi zapustil terminal.
$apfel "regex for a valid email address, just the regex"
-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Vprašaj za bash enovrstičnik, ki si ga pozabil.
$apfel "give me one find command that lists files larger than 100MB, just the bash command"
-> find / -type f -size +100M
Razloži nejasen ukaz, namesto da ugibaš.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Razpakira tarball, stisnjen z gzip, v trenutno mapo.
Si pozabil točen git ukaz? Kar vprašaj.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Razvozlaj tuj regex v enem stavku.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> Ujema se s 3-mestno predpono, vezajem in 4 števkami: ameriška oblika telefonske številke.
Pretvori ohlapno zapisan datum v 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
Povzemi celotno datoteko v 3 alinejah.
$apfel -f README.md "summarize in 3 bullets"
-> 3 alineje o namenu, namestitvi in uporabi.
Združljiv z OpenAI.
Spremeni en URL. Kodo obdrži.
Neposredna zamenjava
apfel govori OpenAI API. Vsaka odjemalska knjižnica, vsako ogrodje, vsako orodje, ki se pogovarja z OpenAI, se lahko namesto tega pogovarja z AI na tvojem Macu. Samo spremeni osnovni URL.
- ✓ POST /v1/chat/completions
- ✓ POST /v1/responses (Responses API)
- ✓ Streaming (SSE)
- ✓ Tool calling / klicanje funkcij
- ✓ GET /v1/models
- ✓ response_format: json_object, json_schema
- ✓ Deli image_url kot data URL-ji (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ CORS za odjemalce v brskalniku
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 kot Applov fm. Druga naloga.
macOS 27 prinaša fm, Applov lasten vmesnik za ukazno vrstico do modela v napravi. Tukaj se njuni poti ločita.
| apfel | Apple fm | |
|---|---|---|
| Teče na | macOS 26 in 27, ena binarka | Samo macOS 27 |
| Namestitev | brew install apfel | Že na voljo (enkrat sudo fm license) |
| Odjemalci OpenAI delujejo brez sprememb | Da: privzeto JSON, usage, upošteva max_tokens, napake preslikane | Pretaka, razen če zahtevaš drugače, ignorira max_tokens, 500 pri varovalkah |
| Tool calling in MCP | Izvorni klici orodij, lokalni in oddaljeni MCP strežniki | Ni (tools v odgovor spušča tokene predloge) |
| Skriptiranje | --code, -o json, 9 izhodnih kod, --count-tokens --strict | Navadno besedilo, izhod 0 ali 1 |
| Vhodne datoteke | Besedilo, PDF, slike: besedilo z OCR na obeh sistemih, na macOS 27 pa modelu tudi sama slika | Slike modelu ter vgrajena orodja za OCR in črtne kode |
| Trajne seje klepeta | Ne | Poimenovani prepisi, --resume |
| Hitrost | Isti model na istem Macu, isto kontekstno okno (4.096 tokenov na tem M2, 8.192 na M3 in novejših), enako število tokenov. Enkratni prompt: 0,35 s proti 0,30 s. | |
Kratka zgodovina. apfel je bil prvi: prvi commit in v0.1.0 24. marca 2026, prva izdaja na GitHubu 31. marca 2026, naslovnica Hacker News aprila. Apple je fm napovedal na WWDC 8. junija 2026 in ga izdal z macOS 27 14. septembra 2026. Oba poganjata isti model v napravi prek istega ogrodja FoundationModels; apfel je odprtokoden in edini, ki teče tudi na macOS 26.
Vsaka vrstica je bila izmerjena na macOS 27.0.1 (Apple M2, 24 GB) dne 2026-10-05 in se ponovno izmeri ob vsaki izdaji apfel. Na celotni strani so preizkusi strežnika, tabela ujemanja števila tokenov in vsi ukazi za ponovitev meritev.
Priljubljen na GitHubu.
Od nič do 6,610 zvezdic in številka še raste.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Daj zvezdico na GitHubuPodatki na dan
Začni zdaj.
Brez prenašanja modelov. Brez registracije. Brez API ključev. Samo to.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Gradnja iz izvorne kode
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
Drevo apfel.
Rastoča družina izvornih orodij za macOS, zgrajenih na apfel, in sestrski projekti, ki druga Applova ogrodja prinašajo v terminal.
apfel-chat
Odjemalec za klepet na macOS z več pogovori. Sproten markdown, govorni vhod in izhod, analiza slik: povsem zasebno, brez API ključev, brez oblaka.
SwiftUI Stabilno
apfelpad
Beležnica s formulami za razmišljanje. V markdown vpiši =apfel("summarize this") in glej, kako se odgovor izpisuje kar v vrstici. Kot =SUM, le za jezik.
apfel-quick
Takojšen AI sloj. Kjerkoli pritisni Ctrl+Space, vpiši vprašanje in odgovor steče v odložišče. Brez Wi-Fi, brez računa, brez plačila.
SwiftUI Novo
apfel-gui
Izvorni SwiftUI grafični vmesnik za razhroščevanje na macOS. Klepetaj z Apple Intelligence, preglej zahteve in odgovore, dnevnike, govor v besedilo, besedilo v govor: vse v napravi.
SwiftUI
apfel-clip
AI dejanja z odložiščem iz menijske vrstice. Na kateremkoli besedilu pritisni cmd+shift+V: popravi slovnico, prevedi, razloži kodo, povzemi. Povsem v napravi, brez API ključev.
SwiftUI Stabilno
apfel-mcp
Daj apfel dostop do spleta in svojih datotek. Štiri majhna MCP orodja, url-fetch, ddg-search, search-and-fetch in bralnik datotek samo za branje, vsako skrčeno, da se prilega majhnemu kontekstnemu oknu apfel (4.096 tokenov na večini Macov, 8.192 na M3 in novejših z macOS 27).
Python Novo
apfel-run
Drobna UNIX ovojnica, ki apfel da trajen register MCP. MCP strežnike vklapljaš in izklapljaš po imenu iz navadne besedilne konfiguracijske datoteke. Preživi ponovne zagone, brez GUI, brez daemona.
Shell Novo
apfel-server-kit
Skupni Swift paket, ki poganja ekosistem. Poišče in zažene lokalni proces apfel --serve ter pretaka iz njega. Hrbtenica, s katero se pogovarja vsaka SwiftUI aplikacija apfel.
Swift Novo
auge
Sestrski projekt. apfel skrbi za jezik, auge za vid. En CLI za OCR, razvrščanje slik, črtne kode in zaznavanje obrazov, 100 % v napravi prek Applovega ogrodja Vision. Brez API ključev, brez oblaka.
Swift Sestrski projekt
translate
Sestrski projekt. UNIX filter in HTTP strežnik kot neposredna zamenjava za DeepL, LibreTranslate in Google v2, ki ga poganja Applovo ogrodje Translation v napravi. 100 % v napravi, kar strogo zagotavlja NetworkGuard. Brez API ključev, brez oblaka.
Swift Sestrski projektPogosta vprašanja.
Vprašanja, zbrana na Hacker News in Redditu.
Katero različico macOS potrebujem?
Ali apfel dostopa do mojih osebnih podatkov?
Ali kakšen podatek zapusti moj Mac?
Model: Applovo ogrodje FoundationModels deluje brez internetne povezave in teče v celoti na Neural Engine. Tvoji prompti in odgovori nikoli ne zapustijo naprave. Podatki uporabnikov se nikoli ne uporabijo za učenje.
Orodje: apfel poskrbi, da tako tudi ostane. Brez analitike, brez telemetrije, brez sledenja, brez samodejnega preverjanja posodobitev, brez poročil o sesutjih, brez javljanja domov. Odprta koda, ki jo lahko pregleda vsak.
Kako veliko je kontekstno okno?
apfel --model-info izpiše okno, ki ga tvoj Mac dejansko ima. Odlično za shell skripte, povzetke in preoblikovanje besedila. Ni primerno za dolge pogovore ali velike dokumente.V čem je model dober? Kje se mu zatakne?
Omejen pri: matematiki, priklicu dejstev, dolgih pogovorih, zahtevnem generiranju kode.
Model raje zavrne, kot da bi si izmišljeval. To je Applova namerna odločitev.
Ali je strežniški način varen?
--token), preverjanje izvora, končne točke za dnevnike samo v načinu za razhroščevanje. Podrobnosti v server-security.md.Ali moram vklopiti Apple Intelligence?
Kako posodobim apfel?
apfel --update. Zazna način namestitve, preveri, ali obstaja novejša različica, in te pred nadgradnjo vpraša. Ročno: brew upgrade apfel ali git pull && make install.Kateri model uporablja?
V čem se apfel razlikuje od Ollama ali LM Studio?
Ali apfel podpira MCP in tool calling?
--mcp <server>. Vodnik za tool calling.V čem se apfel razlikuje od Applovega CLI fm na macOS 27?
fm, Applov vmesnik za ukazno vrstico do istega modela v napravi. apfel doda strežnik, združljiv z OpenAI, s tool calling, MCP, izhodom po JSON Schema, vhodom slik kot data URL-jev, poštenimi izhodnimi kodami in podporo za macOS 26. Izmerjeno drug ob drugem: apfel proti fm.Ali ima apfel kakšno telemetrijo ali funkcije za javljanje domov?
apfel --update, ki na Homebrew preveri, ali obstaja novejša različica. Odprta koda, ki jo lahko pregleda vsak.Kdo je to ustvaril?
Soskrbnik je Arthur Ficial, instanca OpenClaw, ki teče na Claude Opus podjetja Anthropic. Razvit v veliki meri s Claude Code in Codex. Vedno v načinu high thinking / high effort.
Začetek: 24. marca 2026.