apfel bir projesidir.

Eğitim · 15 Kasım 2026'da test edildi

apfel yapay zeka eğitimi

Mac'inde zaten olan yapay zekadan ilk yanıtın 60 saniyede. Ardından iyi yaptığı 11 iş, her biri gerçek çıktısıyla kopyala-yapıştır hazır, bir de neleri yapamadığının dürüst bir listesi.

Hiç kurgulanmamış gerçek terminal kaydı: macOS 27.0.1 üzerinde apfel 1.18.0, MacBook Air M2.
Bu sayfada: 15 bölüm
  1. 60 saniyede ilk yanıtın
  2. 1. Mac'ine kendisini sor
  3. 2. Kopyaladığın her metni düzelt
  4. 3. Fişleri, PDF'leri ve script'leri oku
  5. 4. Düz bir cümleyi shell komutuna çevir
  6. 5. Script'lerinin güvenebileceği JSON al
  7. 6. Gününü otomatikleştir: git, ses ve hazır script'ler
  8. 7. OpenAI kodunu ücretsiz çalıştır
  9. 8. MCP ile modele araç ver
  10. 9. Bir prompt'u denemek için sohbet et
  11. 10. Sunucuyu arka planda çalışır tut
  12. 11. apfel üzerine kurulu uygulamalar
  13. Sınırlar ve dürüst yanıtlar
  14. Bir şey ters giderse
  15. Bunu kim yaptı ve nasıl test edildi

60 saniyede ilk yanıtın

macOS 26 Tahoe veya daha yeni bir sürüm çalıştıran bir Apple Silicon Mac'e (M1 veya daha yeni) ihtiyacın var; ayrıca Sistem Ayarları > Apple Intelligence ve Siri altında Apple Intelligence açık olmalı. İlk iki koşulu tek satırda kontrol et:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Sürüm 26 veya üstüyse ve arm64 görüyorsan hazırsın. apfel'i Homebrew ile kur. Xcode yok, hesap yok, API anahtarı yok:

Terminal
brew install apfel

İlk sorunu sor:

Terminal
apfel "In one sentence: what can a small on-device language model do for me?"
A small on-device language model can help you perform tasks like text translation, summarization, and data analysis directly on your device.

Bu yanıt, Mac'indeki Apple modelinden geldi. Hiçbir şey bir sunucuya gönderilmedi ve hiçbir maliyeti olmadı.

Çalışmazsa: modelin hazır olup olmadığını apfel'e sor:

Terminal
apfel --model-info | grep -E 'available|context'
├ available:  yes
├ context:    4096 tokens

available: no yazıyorsa Sistem Ayarları'nda Apple Intelligence'ı aç ve modelin indirilmesi bitene kadar bekle (kurulum rehberine göre 3 ila 4 GB). Mac'inin dili ile Siri'nin dili aynı ve desteklenen bir dil olmalı. Model kullanılamadığı sürece apfel 5 exit code'uyla çıkar.

Sırada: aşağıdaki işler. Her biri, iki dakika sonra elinde ne olacağıyla başlıyor.

1. Mac'ine kendisini sor

2 dakika sonra elinde: zaten bildiğin komutlardan doğrudan gelen, diskin, CPU'n ve belleğin hakkında anlaşılır yanıtlar.

Bir terminal komutu ekrana sayı yığını döktüğünde, tek satırlık bir yanıt istiyorum, böylece man sayfası okumadan harekete geçebilirim.

Herhangi bir komutu apfel'e pipe'la ve ne öğrenmek istediğini söyle:

Terminal
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
Terminal
ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU, one sentence"
`/System/Library/CoreServices/RemoteManagement/screensharingd.bundle/Contents/MacOS/screensharingd` is using the most CPU.

Girdiyi küçük tut: önce head, awk ve grep, sonra apfel. Model aynı anda yalnızca birkaç bin kelime okuyabilir, kodda daha da az (sınırlar bölümüne bak).

Çalışmazsa: bazı komutlar stderr'e yazar ve pipe bunu taşımaz. apfel bunu sana söyler: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Sırada: aynı numara git log, lsof, pmset -g batt, log dosyaları ve metin basan her şeyle çalışır.

2. Kopyaladığın her metni düzelt

2 dakika sonra elinde: hangi uygulamada olursan ol, panondaki metnin dil bilgisini düzelten bir komut.

Slack'te, Mail'de ya da tarayıcıda hızlıca bir mesaj yazdığımda, başka bir uygulama açmadan düzeltilmesini istiyorum, böylece saniyeler içinde geri yapıştırabilirim.

Bir metin kopyala, sonra ortadaki satırı çalıştır. pbpaste panoyu okur, pbcopy sonucu geri yazar:

Terminal
printf 'can u send me the slides from yesterdays meeting i lost them' | pbcopy
pbpaste | apfel "Rewrite the text above with correct grammar and spelling. Reply with the rewritten text only." | pbcopy
pbpaste
Can you send me the slides from yesterday’s meeting? I lost them.

Neden "the text above" (yukarıdaki metin): apfel pipe ile gelen metni başa, senin talimatını onun arkasına koyar (kaynak). Kısa talimat "fix grammar and spelling, reply with the corrected text only" ile model mesajı düzeltmek yerine ona yanıt verdi ve Could you let me know which meeting you're referring to? dedi. Üzerinde çalışacağı metni açıkça belirtmek testimizde bu sorunu çözdü.

Çalışmazsa: sonucu göndermeden önce oku. Küçük bir model bazen anlamı değiştirir; bu cümleyi Almancaya çevirmesini istediğimizde "Can you send me" (bana gönderir misin) ifadesini "Can I send you" (sana göndereyim mi) haline getirdi.

Sırada: ortadaki satırı bir shell alias'ına ya da bir Kestirmeler "Kabuk Betiğini Çalıştır" eylemine koy ve ona bir klavye kısayolu ata.

3. Fişleri, PDF'leri ve script'leri oku

2 dakika sonra elinde: bir görsel, taranmış bir PDF ya da bir script hakkında yanıtlar; hepsi Apple'ın metin tanıma özelliğiyle doğrudan Mac'inde okunuyor.

İndirilenler klasörüme bir fiş, tarama ya da bilinmeyen bir dosya düştüğünde, içinden yalnızca ihtiyacım olan bilgiyi istiyorum, böylece dosyayı açmadan arşivleyebilirim.

Bir dosyayı -f ile ekle. Şu satırları içeren bir test fişi görseli (receipt.png) hazırladık:

Çıktı
CAFE APFEL
2x Melange          9.80
1x Sachertorte      7.90
1x Apfelstrudel     6.50
TOTAL EUR          24.20
14.11.2026  21:14
Terminal
apfel -f receipt.png "What is the total? Just the amount."
24.20

Aynı fişi yalnızca görsel içeren bir PDF olarak kaydettiğinde de çalışır, çünkü apfel taranmış sayfalarda metin tanıma çalıştırır:

Terminal
apfel -f receipt.pdf "What is the total? Just the amount."
24.20

Her türlü metin dosyası da olur, örneğin bir shell script'i:

Terminal
apfel -f apfel-demos/gitsum "What does this script do? Two sentences."
This script summarizes recent Git activity by summarizing the last N commits, grouping related changes, and generating a concise report. It uses Apple Intelligence to format the output, and optionally copies the summary to the clipboard.

Bu script'i 6. işte alacaksın. Birden fazla dosyayı -f a.txt -f b.txt ile ekleyebilirsin.

Çalışmazsa: 4 exit code'u, dosyanın model için fazla uzun olduğu anlamına gelir (sınırlar bölümüne bak). 3 exit code'u, Apple'ın güvenlik filtresinin onu engellediği anlamına gelir; dosya çıkarma rehberi bu durumda --permissive eklemeyi öneriyor.

4. Düz bir cümleyi shell komutuna çevir

2 dakika sonra elinde: hatırlayamadığın komut, kopyalayabilmen için yalın haliyle ekranda.

find, du ya da tar flag'lerini unuttuğumda, komutu düz bir cümleden almak istiyorum, böylece terminalden çıkmam gerekmez.

--code açıklama olmadan yalnızca kodu basar:

Terminal
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100M

Flag'ler doğru, ama model bir klasör uydurdu. Ev klasörün ~ (yani: find ~ -type f -size +100M).

Terminal
apfel --code "a python function that removes duplicates from a list but keeps the order"
def remove_duplicates_preserve_order(lst):
    seen = set()
    result = []
    for item in lst:
        if item not in seen:
            seen.add(item)
            result.append(item)
    return result

Her komutu çalıştırmadan önce oku. Testlerimizde model yanlış komutlar da üretti. "Geçerli klasördeki en büyük 10 dosya" istendiğinde ls -lh | head -n 10 bastı; bu en büyükleri değil, ilk 10 girdiyi listeler. "Açık portları göster" istendiğinde Linux flag'leri kullanan netstat -tuln | grep LISTEN önerdi; macOS'te bu hiçbir şey basmaz. Mac'te onları lsof -iTCP -sTCP:LISTEN -n -P listeler.

Sırada: 6. iş içindeki cmd demo script'i bunu sarmalar ve bir şey çalıştırmadan (-x) ya da komutu kopyalamadan (-c) önce sorar.

5. Script'lerinin güvenebileceği JSON al

2 dakika sonra elinde: dağınık metinden çekilmiş, her zaman şemana uyan JSON biçiminde yapılandırılmış veri.

E-postalardan ve notlardan isim, sayı ya da tarih çekmem gerektiğinde, düz yazı değil alanlar istiyorum, böylece onları jq'ya, bir tabloya ya da bir script'e verebilirim.

Bir JSON Schema dosyasını contact.schema.json olarak kaydet:

JSON
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "city": { "type": "string" },
    "phone": { "type": "string" }
  },
  "required": ["name", "city", "phone"]
}

Ardından metni --schema ile pipe'la. apfel modeli kısıtlar, böylece çıktı o şemaya uygun geçerli bir JSON olur:

Terminal
echo "Hi, I am Maria Lopez from Vienna, call me on +43 660 1234567" | apfel --schema contact.schema.json "Extract the contact" | jq .
{
  "name": "Maria Lopez",
  "city": "Vienna",
  "phone": "+43 660 1234567"
}

Anahtarlar, şemanda tanımladığın sırayla geri gelir.

Herhangi bir yanıtı meta verilerle birlikte JSON olarak almak için -o json kullan:

Terminal
apfel -o json "Translate to German: apple" | jq -r .content
Apfel

Bütün bir liste için --batch kullan: kayıt başına bir JSON satırı girer, kayıt başına bir sonuç satırı çıkar ve her kayıt yeni bir oturumda işlenir. Bir metin dosyasında üç ürün yorumu:

Terminal
cat reviews.txt
Love it, works offline and it is fast.
Crashes every time I open a PDF.
It is okay, it does the job.
jq -Rc '{custom_id: (input_line_number|tostring), prompt: ("Classify the sentiment of this review as positive, negative or neutral. Reply with one word. Review: " + .)}' reviews.txt | apfel --batch | jq -r '"\(.custom_id) \(.status) \(.content)"'
1 ok Positive
2 ok Negative
3 ok Neutral
apfel: batch: 3 records, 3 ok, 0 failed

jq -R her satırı bir kayda dönüştürür; son satır apfel'in stderr'e yazdığı özettir. Başarısız olan bir kayıt status: "error" alır ve batch devam eder.

Çalışmazsa: apfel JSON Schema'nın bir alt kümesini destekler (nesneler, string'ler, enum'lar, sayılar, boolean'lar, diziler, yerel $ref). pattern gibi desteklenmeyen bir anahtar kelime 2 exit code'uyla durur ve adını söyler; liste API uyumluluk belgesinde.

6. Gününü otomatikleştir: git, ses ve hazır script'ler

2 dakika sonra elinde: son çalışmalarının bir özeti, uzun bir iş bittiğinde bunu sesli söyleyen bir Mac ve sekiz hazır yapay zeka shell script'i.

Görev değiştirdiğimde ya da bir build'i beklerken, bir şeyleri açıklayan ve haber veren küçük otomasyonlar istiyorum, böylece terminali izlemeyi bırakabilirim.

Herhangi bir git deposunun içinden, neler yaptığını özetle:

Terminal
git log --oneline -10 | apfel "summarize what I have been working on, two sentences"
I've been updating star counts to 6,608 and refining ISO datetimes with timezone handling in the Article JSON-LD. Additionally, I've implemented the apfel AI tutorial and redesigned the pre-header with a centered line about the project.

Bir şey bittiğinde Mac'in konuşsun. Yanıtı say komutuna pipe'la ve uzun komutunu && ile önüne koy:

Terminal
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | say

Test Mac'inde ses çıkışı yoktu, bu yüzden konuşmayı bir dosyaya kaydettik (| say -o build-done.aiff, 102.880 bayt ses). Söylediği cümle şuydu: Your build is finished, and I'm glad you asked!.

apfel ayrıca sekiz demo script'iyle geliyor. Bunları bir klasöre yazdır:

Terminal
apfel --demos
apfel: wrote 9 demo files to /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/apfel-demos
  • cmd
  • explain
  • gitsum
  • mac-narrator
  • naming
  • oneliner
  • port
  • wtd

Testte beğendiğimiz bir tanesi:

Terminal
./apfel-demos/naming "function that retries HTTP requests with exponential backoff"
retryExponentialBackoff | exponential_retry_backoff | exponential delay retry  
retryWithExponentialBackoff | exponential_retry_http_backoff | HTTP retry with delay  
backoffRetryHTTP | exponential_http_retry | retry with exponential pause

Denemelerimizde her demo iyi sonuç vermedi: oneliner "count unique IP addresses in access.log" uzunluk sınırına takıldı ve bozuk bir komut bastı, explain ise var olmayan bir hata mesajı ekledi. Demo README'si sekizinin hepsini listeliyor.

7. OpenAI kodunu ücretsiz çalıştır

2 dakika sonra elinde: OpenAI Chat Completions API'sini konuşan yerel bir sunucu; böylece mevcut SDK kodun ücretli bir bulut modeli yerine Mac'inde çalışır.

OpenAI SDK'sıyla prototip geliştirirken, ücretsiz bir yerel endpoint istiyorum, böylece anahtarsız, faturasız ve veriyi dışarı göndermeden geliştirip test edebilirim.

Sunucuyu bir terminal sekmesinde başlat:

Terminal
apfel --serve
apfel server v1.18.0
├ endpoint: http://127.0.0.1:11434
├ model:    apple-foundationmodel
├ cors:     disabled
├ origin:   localhost only (http://127.0.0.1, http://localhost, http://[::1])
├ token:    none
├ health:   public
├ max concurrent: 5
├ debug:    off
└ ready

Endpoints:
  POST http://127.0.0.1:11434/v1/chat/completions
  GET  http://127.0.0.1:11434/v1/models
  GET  http://127.0.0.1:11434/health

2026-11-15T13:39:31+0100 info Hummingbird: [HummingbirdCore] Server started and listening on 127.0.0.1:11434

İkinci bir sekmede onu OpenAI gibi çağır:

Terminal
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.

Resmi OpenAI Python SDK'sı hiç değişiklik yapmadan çalışır. Yalnızca base URL ve model adı farklıdır. hello.py olarak kaydet:

Python
from openai import OpenAI

client = OpenAI(base_url="http://localhost:11434/v1", api_key="unused")
reply = client.chat.completions.create(
    model="apple-foundationmodel",
    messages=[{"role": "user", "content": "Give me three names for a coffee shop run by robots."}],
)
print(reply.choices[0].message.content)
Terminal
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

Sunucu yalnızca kendi Mac'inde (127.0.0.1) dinler ve başka origin'lerdeki web sayfalarından gelen istekleri reddeder. Onu ağına açmak için bir token ekle: apfel --serve --host 0.0.0.0 --token-auto (sunucu güvenliği rehberi).

Çalışmazsa: Connection refused, sunucunun çalışmadığı anlamına gelir. Embedding'ler ve eski /v1/completions endpoint'i HTTP 501 döndürür, çünkü cihaz içi model bunları sunmuyor.

Sırada: geliştiriciler VS Code Copilot (yalnızca sohbet), opencode, Zed ve Node.js, Ruby, PHP ile altı dil daha için kurulumları belgeliyor. Bunları bu sayfa için yeniden test etmedik.

8. MCP ile modele araç ver

2 dakika sonra elinde: bir Model Context Protocol aracı üzerinden canlı bir web sayfasını okuyup özetleyen bir model.

Yanıt bir web sayfasında olduğunda, modelin sayfayı kendisinin getirmesini istiyorum, böylece metni oraya buraya kopyalamadan bir özet alabilirim.

Küçük context window'a sığacak şekilde tasarlanmış apfel-mcp araçlarını kur:

Terminal
brew install Arthur-Ficial/tap/apfel-mcp

Birini --mcp ile bağla ve sor. -q aracın ham çıktısını gizler:

Terminal
apfel -q --mcp $(which apfel-mcp-url-fetch) "Summarize https://apfel.franzai.com/ in 3 bullets"
- **Purpose**: apfel is a Swift 6.3 tool that wraps Apple’s on-device LLM (part of macOS 26’s Apple Intelligence) and exposes it via a CLI, HTTP server, and interactive chat with context management.  
- **Features**: It handles terminal commands, JSON output, file attachments, real token counting, and context trimming (4,096 or 8,192 tokens depending on hardware), while converting OpenAI tool schemas to Apple’s native format.  
- **Technical details**: Built using the FoundationModels framework, it runs on Apple Silicon’s Neural Engine and GPU without network or cloud dependencies, and is open-source under MIT license.

Aynı pakette apfel-mcp-ddg-search (web araması), apfel-mcp-search-and-fetch ve apfel-mcp-fs (yerel bir dosyayı okur) da var. Her MCP sunucusu çalışır: yerel bir script yolu ya da bir https:// URL'si.

Birden fazla adlandırılmış argüman alan araçlar da çalışır. İşte apfel deposundaki hesap makinesi (mcp/calculator/server.py): model multiply aracını iki argümanla çağırır, apfel onu çalıştırır ve model sonucu yanıt olarak verir:

Terminal
apfel --mcp ./server.py "What is 15 times 27?"
mcp: /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/./server.py - add, subtract, multiply, divide, sqrt, power, round_number
tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

tool: satırı, apfel'in çalıştırdığı çağrıyı sana göstermesidir. apfel 1.18.0'dan önce model argüman adlarını görmüyor ve tahmin ediyordu, bu yüzden böyle bir çağrı başarısız oluyordu (issue #555, pull request #556 ile düzeltildi). Burada invalid arguments görüyorsan brew upgrade apfel ile güncelle.

9. Bir prompt'u denemek için sohbet et

2 dakika sonra elinde: daha önce söylediklerini hatırlayan bir terminal sohbeti.

Bir script için prompt hazırlarken, birkaç turu hızlıca denemek istiyorum, böylece otomatikleştirmeden önce modelin nasıl tepki verdiğini görebilirim.

Terminal
apfel --chat
Apple Intelligence · on-device LLM · apfel v1.18.0
────────────────────────────────────────────────────────
Type 'quit' to exit.

you› My name is Franz. I live in Vienna.
 ai› Hello, Franz. It's nice to meet you. I'm here to help with any questions or tasks you might have. How can I assist you today?

you› Suggest one thing I could do there this weekend. One sentence.
 ai› You could visit the Kunsthistorisches Museum to explore its impressive collection of art and artifacts.

you› What is my name?
 ai› Your name is Franz.

you› quit

Goodbye.

-s ile bir persona ekle, örneğin apfel --chat -s "You are a patient Python tutor". Uzun bir sohbet context window'u aştığında apfel varsayılan olarak en eski turları atar; diğer stratejileri context rehberi anlatıyor. Düğmeleri olan bir pencere istersen apfel-chat uygulamasına bak.

10. Sunucuyu arka planda çalışır tut

2 dakika sonra elinde: oturum açtığında kendiliğinden başlayan, 11434 portunda her zaman hazır OpenAI uyumlu sunucu.

Mac'imdeki araçlar yerel endpoint'i her gün kullandığında, onun hep açık olmasını istiyorum, böylece elle başlatmaktan kurtulurum.

Terminal
brew services start apfel
==> Successfully started `apfel` (label: sh.brew.apfel)
curl -s http://127.0.0.1:11434/health | jq -c '{status, model_available, context_window}'
{"status":"ok","model_available":true,"context_window":4096}
brew services stop apfel
Stopping `apfel`... (might take a while)
==> Successfully stopped `apfel` (label: sh.brew.apfel)

Port, token ya da MCP sunucuları gibi ayarlar ortam değişkenleridir, örneğin APFEL_PORT=8080 brew services start apfel. Hepsi arka plan servisi rehberinde listeleniyor.

11. apfel üzerine kurulu uygulamalar

2 dakika sonra elinde: terminal yerine uygulamaları tercih ediyorsan, aynı cihaz içi model bir pencerede, menü çubuğunda ya da bir kısayol tuşunda.

Bunlar aynı geliştiricilerden geliyor (README içindeki "apfel tree"). 15 Kasım 2026'da her kurulum adının Homebrew'da var olduğunu kontrol ettik; uygulamaları bu sayfa için test etmedik.

Uygulama Ne yapar Kurulum
apfel-chat Streaming yanıtlar, konuşma ve görsel analizi sunan sohbet uygulaması brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Panodaki metin için menü çubuğu eylemleri: özetle, çevir, yeniden yaz brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Bir tuşa bas, sor, yanıtı al, kapat brew install Arthur-Ficial/tap/apfel-quick
apfelpad Yapay zekanın bir hücreye yazdığın formül olduğu not defteri brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Küçük context window'a göre boyutlandırılmış MCP araçları (8. iş) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run Kayıtlı bir yapılandırma ve MCP sunucuları listesiyle apfel brew install Arthur-Ficial/tap/apfel-run
apfel-tag Pipe ile verdiğin her metin için etiketler, konular ve duygular brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Hata ayıklama penceresi: istekler, MCP mesajları, konuşma brew install Arthur-Ficial/tap/apfel-gui

Sınırlar ve dürüst yanıtlar

apfel sana Apple'ın cihaz içi modelini verir. README'ye göre model yaklaşık 3 milyar parametreli; ChatGPT ya da Claude'un arkasındaki bulut modellerinden çok daha küçük. Kısa, odaklı metin işlerinde iyidir. Aşağıdakiler, karşılaştığımız ya da dokümantasyonun belirttiği sınırlar.

Context window küçük. Soru ve yanıt birlikte macOS 26 üzerinde ve M1 ile M2 Mac'lerde 4.096 token'a, macOS 27 çalıştıran 12 GB veya daha fazla belleğe sahip M3 ve daha yeni Mac'lerde 8.192 token'a sığmalı (README). Seninkini apfel --model-info gösterir. apfel'in kendi README'si bile bunun için fazla uzun. Göndermeden önce say:

Terminal
apfel --count-tokens -f README.md "summarize in 3 bullets"
8272/3584 tokens (over budget)
  prompt=7, README.md=8258
apfel -f README.md "summarize in 3 bullets"; echo "exit code: $?"
error: [context overflow] Input exceeds the model's context window: the input is 8264 tokens, the window is 4096 tokens. Shorten the conversation history.
exit code: 4

3.584, 4.096'lık pencereden yanıt için boş bırakılan 512 token çıkarılınca kalan değer. README yaklaşık 3.000 kelime, ama Markdown ve kod kelime başına çok sayıda token tüketir. Uzun dosyaları parça parça ver (head -c 6000 file), her seferinde bir bölüm.

Bugünün tarihini bilmiyor. Bir tarih uydurdu:

Terminal
apfel "What is today's date?"
Today's date is October 27, 2024.
apfel -s "Today is $(date '+%B %d, %Y')." "What is today's date? One sentence."
Today's date is November 15, 2026.

İhtiyaç duyduğu her bilgiyi prompt'ta ver. Bir MCP aracı bağlamadığın sürece internete erişimi yok.

Bazen yanılır, hem de kendinden emin bir şekilde. Yukarıda gördün: 4. işte yanlış shell komutları, 2. işte anlamı tersine çeviren bir çeviri. Önemli olan her şeyi kontrol et.

Apple'ın güvenlik filtresi zararsız metinleri de engelleyebilir. Bu durumda apfel 3 exit code'u ve The request was blocked by Apple's safety guardrails mesajıyla durur. Farklı ifade et ya da yaratıcı yazı ve belgeler için --permissive ekle; neyi değiştirdiğini guardrails belgesi açıklıyor. Bu sayfa için yaptığımız denemelerde hiç engelle karşılaşmadık.

Yanıtlar her çalıştırmada farklı. Buradakiler, her biri tek bir çalıştırmadan gelen gerçek çıktılar. Senin alacağın yanıtlar farklı ifadelerle gelecek. Daha tekrarlanabilir yanıtlar için --temperature 0 kullan; apfel, çalıştırmalar ya da macOS güncellemeleri arasında aynı çıktıyı vaat etmiyor (kararlılık politikası).

Hız: denemelerimizde yanıtların çoğu 1 ila 2 saniyede geldi. MCP aracıyla web sayfası özeti 8 saniye sürdü.

Gereksinimler katı: yalnızca Apple Silicon, macOS 26 veya daha yenisi, Apple Intelligence açık ve --model-info komutunun listelediği 15 dilden biri. Intel Mac'lerde çalışmaz.

Bir şey ters giderse

apfel sorunları bir exit code ile bildirir, böylece script'ler buna tepki verebilir. Komutun hemen ardından echo $? ile kontrol et.

Exit code veya hata Anlamı Ne yapmalı
2 Yanlış flag veya seçenek Flag'ler prompt'tan önce gelir; apfel --help hepsini listeler
3 Apple'ın güvenlik filtresi isteği engelledi Farklı ifade et ya da --permissive ekle
4 Girdi context window için fazla uzun Daha az metin gönder; apfel --count-tokens ile kontrol et
5 Model kullanılamıyor Apple Intelligence'ı aç, indirmeyi bekle, Mac ve Siri dilini eşleştir
6 Model meşgul ya da istek sınırına takıldı Bekleyip yeniden çalıştır ya da --retry ekle
Connection refused 11434 portunda sunucu yok apfel --serve ya da brew services start apfel ile başlat
HTTP 501 Cihaz içi modelin sunmadığı endpoint (embedding'ler, /v1/completions) /v1/chat/completions kullan
piped input was empty Komut stderr'e yazdı command 2>&1 \| apfel "..."

Hâlâ takıldın mı? GitHub üzerinde ara ya da bir issue aç.

Bunu kim yaptı ve nasıl test edildi

apfel ücretsiz ve açık kaynaklıdır (MIT lisansı); Franz Enzenhofer'in bir franzai projesidir. Proje, Franz'ın yapay zeka asistanı Arthur Ficial ile birlikte sürdürülüyor; bu eğitimi de Arthur Ficial yazdı. Bu sayfayı apfel'in yapımcıları yazdığı için, gördüğümüz hiçbir hatayı saklamadık, hepsini listeledik.

Nasıl test ettik: 15 Kasım 2026'da bu sayfadaki her komutu macOS 27.0.1 (build 26A434) çalıştıran bir MacBook Air M2 (24 GB) üzerinde çalıştırdık. GitHub sürümündeki imzalı apfel 1.18.0 binary'sini (Homebrew tap'inin kurduğu dosyanın aynısı) gerçek bir terminal oturumunda kullandık ve çıktıyı değiştirmeden kopyaladık. Bu sayfanın ilk sürümü (14 Kasım 2026, apfel 1.16.0) 8. işteki çoklu argümanlı araç hatasını gösteriyordu; 1.18.0 bunu düzeltiyor, bu yüzden bu sürüm için her komutu yeniden çalıştırdık. İlk çıktının yanlış olduğu yerlerde yanlış çıktıyı sayfada bıraktık ve bunu belirttik. Yeniden çalıştırmalar yalnızca düzenleme gerektirmeyen yanıtlar bulmak içindi: bir web sayfası özetinde bu sitenin basmadığı uzun bir tire vardı, bu yüzden tekrar çalıştırıp üçüncü denemeyi tuttuk. Test Mac'inde ses çıkışı olmadığından ses örneği, sesi bir dosyaya yazarak kontrol edildi. Demo script'leri apfel 1.18.0'daki apfel --demos tarafından yazıldı.

Başkalarının apfel hakkında yazdıkları: Show HN gönderisi (3 Nisan 2026, 743 puan), Better Stack'in rehberi, GIGAZINE'in makalesi ve danilchenko.dev'deki uygulamalı inceleme.

Kaynaklar: apfel README'si, CLI referansı, kurulum rehberi, demo script'leri, apfel ile Apple'ın fm aracının karşılaştırması ve issue takipçisi; 15 Kasım 2026'da okundu.