v1.18.0 · Sıfır ayar · MIT
apfel
Mac'inde zaten olan ücretsiz yapay zeka.
macOS Tahoe, 3B parametreli bir LLM ile geliyor. apfel tek bir brew install ile sana CLI erişimi veriyor. Model indirme yok, API anahtarı yok, ayar gerekmiyor - doğrudan çalışıyor.
$ brew install apfel
github.com/Arthur-Ficial/apfel üzerinde 6.6k+ yıldız
Gereksinimler: Apple Silicon · macOS Tahoe · Apple Intelligence açık
apfel'de yeni misiniz? 60 saniyelik eğitime başlayın (İngilizce)
Her şey kendi cihazında çalışır. Ağ çağrısı yok. Hiçbir veri Mac'inden çıkmaz.
Çalışırken izle.
brew install'dan yapay zeka çıktısına 12 saniyede. Hiçbir ayar gerekmez.
Sıfır ayar. Sıfır LLM indirmesi. Sıfır token maliyeti.
Diğer yerel yapay zeka araçları harika ama model indirmesi ve ayar gerektiriyor. apfel'in hiçbir şeye ihtiyacı yok - model zaten Mac'inde. Tek bir brew install. İşte bu kadar.
Perde arkasındaki model
Apple ML ResearchÜç araç. Tek kurulum.
Bir CLI, OpenAI uyumlu bir sunucu ve etkileşimli bir sohbet. Hepsi tek bir brew install ile. Ekstra indirme yok.
UNIX aracı
Pipe dostu ve birleştirilebilir. jq, xargs ve shell script'lerinle çalışır. stdin, stdout, JSON çıktısı, --schema ile şemaya uygun JSON, --messages ile bir mesaj dosyasından çok turlu sohbet, dosya ekleri, düzgün exit code'lar.
OpenAI sunucusu
localhost:11434 üzerinde, birebir yerine geçen bir sunucu. Herhangi bir OpenAI SDK'sını ona yönlendir, hazırsın. Chat Completions ve Responses API, streaming, tool calling, JSON Schema çıktısı, CORS.
Etkileşimli sohbet
Otomatik context yönetimiyle çok turlu sohbetler. Beş kırpma stratejisi. System prompt desteği. Başlamak için terminale sadece apfel yaz. Hepsi Mac'inde.
Yerleşik MCP desteği.
Apple'ın cihaz içi modeline araçlar ver. Her türlü aracı.
--mcp ile araç sunucuları bağla
apfel, Model Context Protocol dilini konuşur. Onu herhangi bir MCP sunucusuna yönlendir, cihaz içi model araçlara kavuşur - matematik, API'ler, veritabanları, sunucusunu yazabildiğin her şey.
- Üç modun hepsinde çalışır - CLI, sunucu ve sohbet
- Açılışta MCP tools/list ile araçları otomatik keşfeder
- Araç çağrıları algılanır, çalıştırılır ve sonuçlar otomatik olarak geri beslenir
- --mcp flag'i yoksa ek yük de yok - sıfır ekstra token, kod yolunda sıfır değişiklik
- Proof-of-concept olarak bir hesap makinesi MCP sunucusuyla gelir
- URL ile uzak MCP sunucuları -
--mcp https://..., isteğe bağlı Bearer token kimlik doğrulamasıyla
Nasıl çalışır?
Apple her Mac'e bir LLM yerleştirdi. Öylece orada duruyor. apfel ona bir ön kapı açıyor - hiçbir ayar gerektirmeden.
Apple cihaz içi bir LLM sunuyor
macOS 26 (Tahoe) itibarıyla her Apple Silicon Mac, Apple Intelligence'ın bir parçası olarak bir dil modeli içeriyor. Apple bunu FoundationModels framework'ü üzerinden sunuyor - uygulamalara SystemLanguageModel erişimi veren bir Swift API. Tüm inference Neural Engine ve GPU üzerinde çalışır. Ağ çağrısı yok, bulut yok, API anahtarı yok. Model zaten orada.
Ama Apple onu sadece Siri için kullanıyor
Kutudan çıktığı haliyle cihaz içi model Siri'yi, Writing Tools'u ve sistem özelliklerini çalıştırır. Terminal komutu yok, HTTP endpoint'i yok, içinden metin pipe'lamanın bir yolu yok. FoundationModels framework'ü var, ama kullanmak için bir Swift uygulaması yazman gerekir. apfel tam olarak bunu yapıyor.
apfel neler katıyor
apfel, LanguageModelSession'ı saran ve onu üç şekilde sunan bir Swift 6.3 binary'si: stdin/stdout destekli bir UNIX komut satırı aracı, OpenAI uyumlu bir HTTP sunucusu (Hummingbird üzerine kurulu) ve context yönetimli etkileşimli bir sohbet olarak.
Apple'ın ham API'sinin yapmadıklarını halleder: düzgün exit code'lar, JSON çıktısı, dosya ekleri, küçük context window için beş context kırpma stratejisi (4.096 token, macOS 27 çalıştıran M3 ve daha yeni Mac'lerde 8.192), SDK üzerinden gerçek token sayımı ve OpenAI araç şemalarının Apple'ın yerel Transcript.ToolDefinition formatına dönüştürülmesi.
Tasarımı gereği gizlilik odaklı.
apfel kullanırken tek bir HTTP çağrısı bile yapılmaz. Aşağıdaki her iddia, Apple'ın kendi dokümantasyonuna bağlantı veriyor.
Cihaz içinde. Çevrimdışı çalışır.
FoundationModels framework'ü tamamen Apple Silicon'undaki Neural Engine üzerinde çalışır. Sunucu yok, bulut yok, internet bağlantısı gerekmez.
Verin sende kalır.
Apple, cihaz içi inference'tan prompt, yanıt ya da herhangi bir kullanım verisi toplamaz. Hiçbir şey saklanmaz, hiçbir şey gönderilmez.
Asla eğitimde kullanılmaz.
Apple, foundation modellerini yalnızca lisanslı ve herkese açık verilerle eğitir. Senin etkileşimlerin asla eğitim sürecinin parçası olmaz.
apfel hiçbir takip eklemez.
Analitik yok, telemetri yok, otomatik güncelleme kontrolü yok, çökme raporu yok, eve haber yollamak yok. apfel'in yaptığı tek ağ çağrısı, apfel --update komutunu bizzat çalıştırdığında olur. Kod tabanının tamamı açık kaynak.
Güçlü araçlar dahil.
demo/ klasöründeki shell script'leri. Önce apfel'i kur, sonra istediklerini al.
cmd
Doğal dilden shell komutuna. Ne istediğini söyle, komutu al.
oneliner
Sade bir cümleden pipe zincirleri. awk, sed, sort, uniq - senin için üretilir.
mac-narrator
Mac'inin sistem etkinliğini bir doğa belgeseli gibi anlatır.
explain
Herhangi bir komutu, hata mesajını veya kod parçasını sade bir dille açıklar.
wtd
Bu dizin ne? Her kod tabanında anında yönünü bul.
gitsum
Son git commit'lerini birkaç cümlede özetler.
30 faydalı ve havalı tek satırlık komut.
Her komut gerçek bir Mac'te test edildi. apfel'i ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl ve say ile zincirle - bulut yapay zekalarının yetişemeyeceği bir birleştirilebilirlik, çünkü onlar süreçlerini, panonu, git diff'ini göremez. apfel görebilir.
Şu an CPU'mu ne yiyor?
$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"
-> En çok CPU'yu %42,6 ile WindowServer kullanıyor.
Hangi uygulama hangi portu dinliyor?
$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
Hangi disk dolmaya en yakın?
$df -h | apfel "which volume is fullest, one sentence"
-> En dolu olan /dev/disk3s1: 926Gi'nin 263Gi'si dolu.
vm_stat çıktısı sade dille.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k sayfa aktif, 266k wired - ciddi miktarda bellek kullanımda.
Buradaki hangi klasörler en çok disk yiyor?
$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"
-> 36G ile Library ve 604M ile Downloads başı çekiyor.
Bu klasördeki en büyük dosyalar.
$ls -laS | head -10 | apfel "what are the biggest files here, just file names"
-> apfel-quick-preview.png, og.png, translate-preview.png ...
Şu an hangi uygulamalar internetle konuşuyor?
$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 ...
Tek satırda pil sağlığı ve kalan süre.
$pmset -g batt | apfel "battery health and percent, one line"
-> Tam dolu, sağlık %100, şu an kullanımda.
Son commit'lerini sade bir dille özetle.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> v1.2.1 sürümünden v1.3.2 sürümüne güncellemeler, kardeş projeler eklendi ...
Son commit'lerden tek satırlık bir sürüm notu taslağı çıkar.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> v1.3.2 yayınlandı: 5053 yıldız, 783 test, güncellemeler.
Panondaki metnin dilbilgisini düzelt, düzeltilmiş halini panoya geri koy.
$pbpaste | apfel "fix grammar" | pbcopy
-> "i has went" artık "I went" - yeniden panoda.
Panodakini Japoncaya çevir, sonra geri koy.
$pbpaste | apfel "translate to japanese" | pbcopy
-> Panoda artık Japonca çeviri var.
Panondaki uzun metni 3 maddede özetle.
$pbpaste | apfel "summarize in 3 bullets"
-> Terminalinde 3 derli toplu madde.
Panondaki toplantı notlarından net yapılacaklar listesi çıkar.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> "Sarah Q3 bütçe taslağını hazırlar", "tasarım ekibine e-posta", ... yeniden panoda.
Uzun bir iş bittiğinde kendine sesli haber ver (burada 30 dakika sonra).
$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say
-> Mac konuşur: "Uzun işin az önce bitti, eline sağlık!"
Downloads klasörüne bir dosya düşmesini bekle, sonra duyur.
$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say
-> 5 saniyede bir kontrol eder; Report.pdf belirince Mac haberi sesli verir.
Uzun süren bir sürecin bitmesini bekle, sonra duyur.
$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say
-> 5 saniyede bir kontrol eder; ffmpeg sonlanınca Mac haberi sesli verir.
Her 30 dakikada bir, az önce bitirdiklerini sesli özetle.
$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
-> Sen kod yazmaya devam ederken yarım saatte bir sesli okunan otomatik standup.
Her 15 dakikada bir, pil yüzde 20 altına düşerse sesli uyar.
$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
-> Pil düşene kadar sessiz; sonra Mac dostça ama acil bir uyarıyı yüksek sesle verir.
Bir URL 2xx dönene kadar izle, sonra deploy'u sesli kutla.
$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
-> Staging ayağa kalkana kadar 30 saniyede bir kontrol eder; Mac "Deploy yayında, URL yanıt veriyor!" der.
Gündelik bir cümleyi kibar bir dile çevir.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> "Belgeleri en kısa sürede paylaşabilir misiniz ..."
Bir URL'ye istek at ve sadece header'lara bakarak neler olduğunu sor.
$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"
-> GitHub, sıkı önbellekleme ve güvenlik header'larıyla bir HTML sayfası sunuyor.
Bugünün Hacker News'u, tek cümlede özetlenip sesli okunur.
$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say
-> Mac günün öne çıkan haberlerini tek bir derli toplu özetle okur.
Bir JSON yığınını sade bir dille açıkla.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Pro planda, 42 kredisi olan Alice adlı bir kullanıcı.
Hesap makinesi açmadan matematik.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Terminalden çıkmadan regex üret.
$apfel "regex for a valid email address, just the regex"
-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Unuttuğun tek satırlık bash komutunu sor.
$apfel "give me one find command that lists files larger than 100MB, just the bash command"
-> find / -type f -size +100M
Tahmin etmek yerine anlaşılmaz bir komutu açıklat.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> gzip'li bir tarball'ı açıp mevcut dizine çıkarır.
Tam git komutunu mu unuttun? Sor yeter.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Başkasının regex'ini tek cümlede çöz.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> 3 haneli bir önek, bir tire ve 4 haneyle eşleşir - bir ABD telefon formatı.
Gündelik bir tarih ifadesini ISO 8601 formatına çevir.
$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
Koca bir dosyayı 3 maddede özetle.
$apfel -f README.md "summarize in 3 bullets"
-> Kapsam, kurulum ve kullanımı kapsayan 3 madde.
OpenAI uyumlu.
Tek bir URL değiştir. Kodun aynı kalsın.
Birebir yerine geçer
apfel OpenAI API'sini konuşur. OpenAI ile konuşan her client kütüphanesi, her framework, her araç bunun yerine Mac'indeki yapay zekayla konuşabilir. Sadece base URL'yi değiştir.
- ✓ POST /v1/chat/completions
- ✓ POST /v1/responses (Responses API)
- ✓ Streaming (SSE)
- ✓ Tool calling / function calling
- ✓ GET /v1/models
- ✓ response_format: json_object, json_schema
- ✓ data URL olarak image_url parçaları (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ Tarayıcı client'ları için CORS
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)
Apple'ın fm'iyle aynı model. Farklı iş.
macOS 27, cihaz içi model için Apple'ın kendi komut satırı arayüzü olan fm ile geliyor. İkisinin yolları işte burada ayrılıyor.
| apfel | Apple fm | |
|---|---|---|
| Çalıştığı yer | macOS 26 ve 27, tek binary | Sadece macOS 27 |
| Kurulum | brew install apfel | Zaten yüklü (bir kez sudo fm license) |
| OpenAI client'ları değişiklik olmadan çalışır | Evet: varsayılan olarak JSON, usage, max_tokens dikkate alınır, hatalar eşlenir | Aksi istenmedikçe stream eder, max_tokens değerini yok sayar, guardrail'lerde 500 döner |
| Tool calling ve MCP | Yerleşik araç çağrıları, yerel ve uzak MCP sunucuları | Yok (tools yanıta template token'ları sızdırır) |
| Script yazma | --code, -o json, 9 exit code, --count-tokens --strict | Düz metin, exit 0 veya 1 |
| Dosya girdisi | Metin, PDF, görseller: iki işletim sisteminde de OCR metni, macOS 27 üzerinde ayrıca görselin kendisi modele | Görseller modele, ayrıca yerleşik OCR ve barkod araçları |
| Kalıcı sohbet oturumları | Hayır | Adlandırılmış transkriptler, --resume |
| Hız | Aynı Mac'te aynı model, aynı context window (bu M2'de 4.096 token, M3 ve daha yenilerinde 8.192), token sayıları birebir aynı. Tek seferlik prompt: 0,35 sn'ye karşı 0,30 sn. | |
Kısa bir tarihçe. Önce apfel çıktı: ilk commit ve v0.1.0 24 Mart 2026 tarihinde, ilk GitHub sürümü 31 Mart 2026 tarihinde, nisan ayında Hacker News ön sayfası. Apple fm'i 8 Haziran 2026 tarihinde WWDC'de duyurdu ve 14 Eylül 2026 tarihinde macOS 27 ile yayınladı. İkisi de aynı cihaz içi modeli aynı FoundationModels framework'ü üzerinden kullanır; açık kaynak olan ve macOS 26 üzerinde de çalışan apfel'dir.
Her satır 05.10.2026 tarihinde macOS 27.0.1 (Apple M2, 24 GB) üzerinde ölçüldü ve her apfel sürümünde yeniden ölçülüyor. Tam sayfada sunucu testleri, token sayısı eşitlik tablosu ve hepsini yeniden üretmek için gereken her komut var.
GitHub'da popüler.
Sıfırdan 6,610 yıldıza, hâlâ artıyor.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
GitHub'da yıldızlaVeriler:
Hemen başla.
Model indirme yok. Kayıt yok. API anahtarı yok. Sadece bu.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Kaynaktan derle
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
apfel ağacı.
apfel üzerine kurulu, büyüyen bir yerel macOS araçları ailesi - ve diğer Apple framework'lerini terminale taşıyan kardeş projeler.
apfel-chat
Çoklu sohbet destekli macOS sohbet uygulaması. Streaming markdown, sesli giriş/çıkış, görsel analizi - tamamen gizli, API anahtarı yok, bulut yok.
SwiftUI Üretimde
apfelpad
Düşünmek için bir formül not defteri. Markdown'ına =apfel("summarize this") yaz ve yanıtın satır içinde akışını izle. =SUM gibi, ama dil için.
apfel-quick
Anında yapay zeka katmanı. Her yerde Ctrl+Space'e bas, bir soru yaz, yanıt panona aksın. Wi-Fi yok, hesap yok, fatura yok.
SwiftUI Yeni
apfel-gui
Yerel macOS SwiftUI debug arayüzü. Apple Intelligence ile sohbet, istek ve yanıtları inceleme, loglar, konuşmadan metne, metinden konuşmaya - hepsi cihaz içinde.
SwiftUI
apfel-clip
Menü çubuğundan yapay zeka pano eylemleri. Herhangi bir metinde cmd+shift+V'ye bas - dilbilgisini düzelt, çevir, kodu açıkla, özetle. Tamamen cihaz içinde, API anahtarı yok.
SwiftUI Üretimde
apfel-mcp
apfel'e web'i ve dosyalarını aç. Dört küçük MCP aracı - url-fetch, ddg-search, search-and-fetch ve salt okunur bir dosya okuyucu - her biri apfel'in küçük context window'una sığacak şekilde kırpıldı (çoğu Mac'te 4.096 token, macOS 27 ile M3 ve daha yenilerinde 8.192).
Python Yeni
apfel-run
apfel'e kalıcı bir MCP kaydı kazandıran küçük bir UNIX wrapper'ı. MCP sunucularını düz metin bir ayar dosyasından adlarıyla aç ve kapat. Yeniden başlatmalardan etkilenmez, GUI yok, daemon yok.
Shell Yeni
apfel-server-kit
Ekosisteme güç veren ortak Swift paketi. Yerel bir apfel --serve sürecini bul, başlat ve ondan stream al. Her SwiftUI apfel uygulamasının konuştuğu omurga.
Swift Yeni
auge
Kardeş proje. apfel dili, auge görmeyi üstlenir. OCR, görsel sınıflandırma, barkod ve yüz algılama için tek bir CLI - Apple'ın Vision framework'ü sayesinde %100 cihaz içinde. API anahtarı yok, bulut yok.
Swift Kardeş proje
translate
Kardeş proje. Bir UNIX filtresi ve DeepL, LibreTranslate ile Google v2 yerine birebir geçen bir HTTP sunucusu - Apple'ın cihaz içi Translation framework'üyle çalışır. %100 cihaz içinde, NetworkGuard bunu katı biçimde uygular. API anahtarı yok, bulut yok.
Swift Kardeş projeSık sorulanlar.
Sorular Hacker News ve Reddit tartışmalarından derlendi.
Hangi macOS sürümü gerekiyor?
apfel kişisel verilerime erişiyor mu?
Mac'imden herhangi bir veri çıkıyor mu?
Model: Apple'ın FoundationModels framework'ü internet bağlantısı olmadan çalışır ve tamamen Neural Engine üzerinde koşar. Prompt'ların ve yanıtların cihazdan asla çıkmaz. Kullanıcı verisi asla eğitimde kullanılmaz.
Araç: apfel bunu böyle tutar. Analitik yok, telemetri yok, takip yok, otomatik güncelleme kontrolü yok, çökme raporu yok, eve haber yollamak yok. Açık kaynak ve denetlenebilir.
Context window ne kadar?
apfel --model-info Mac'inde gerçekte ne kadar olduğunu gösterir. Shell script'leri, özetler ve metin dönüşümleri için harika. Uzun sohbetler veya büyük belgeler için uygun değil.Model nerede iyi, nerede zorlanıyor?
Sınırlı olduğu işler: matematik, bilgi hatırlama, uzun sohbetler, karmaşık kod üretimi.
Model halüsinasyon görmektense reddetmeyi tercih eder. Apple'ın bilinçli bir tasarım tercihi.
Sunucu modu güvenli mi?
--token), origin kontrolü, yalnızca debug modunda log endpoint'leri. Ayrıntılar server-security.md dosyasında.Apple Intelligence'ı açmam gerekiyor mu?
apfel'i nasıl güncellerim?
apfel --update. Kurulum yöntemini algılar, yeni sürüm var mı bakar, yükseltmeden önce sorar. Elle: brew upgrade apfel veya git pull && make install.Hangi modeli kullanıyor?
apfel'in Ollama veya LM Studio'dan farkı ne?
apfel MCP ve tool calling destekliyor mu?
--mcp <server> ver. Tool calling rehberi.apfel'in, Apple'ın macOS 27 ile gelen kendi fm CLI'ından farkı ne?
fm ile geliyor. apfel bunun üstüne tool calling, MCP, JSON Schema çıktısı, data URL olarak görsel girdisi, dürüst exit code'lar ve macOS 26 desteğiyle OpenAI uyumlu sunucuyu ekliyor. Yan yana ölçüldü: apfel vs fm.apfel'de telemetri ya da eve haber yollayan bir işlev var mı?
apfel --update komutunu bizzat çalıştırdığında olur; bu da Homebrew'da yeni sürüm var mı diye bakar. Açık kaynak ve denetlenebilir.Bunu kim yaptı?
Ortak bakımcısı Arthur Ficial: Anthropic'in Claude Opus modeliyle çalışan bir OpenClaw örneği. Büyük ölçüde Claude Code ve Codex ile geliştirildi. Her zaman high thinking / high effort modunda.
Başlangıç: 24 Mart 2026.