apfel एक प्रोजेक्ट है।

ट्यूटोरियल · 15 नवंबर 2026 को test किया गया

apfel AI ट्यूटोरियल

आपके Mac में पहले से मौजूद AI से पहला जवाब, 60 सेकंड में। फिर 11 काम जो यह अच्छे से करता है - हर एक copy-paste के लिए तैयार, असली output के साथ - और उन चीज़ों की ईमानदार list जो यह नहीं कर सकता।

असली terminal recording, कुछ भी edit नहीं किया गया: macOS 27.0.1 पर apfel 1.18.0, MacBook Air M2।
इस पेज पर: 15 सेक्शन
  1. 60 सेकंड में आपका पहला जवाब
  2. 1. अपने Mac से उसी के बारे में पूछें
  3. 2. Copy किया कोई भी text ठीक करें
  4. 3. Receipts, PDFs और scripts पढ़ें
  5. 4. आम अंग्रेज़ी को shell command में बदलें
  6. 5. ऐसा JSON पाएँ जिस पर आपकी scripts भरोसा कर सकें
  7. 6. अपना दिन automate करें: git, आवाज़ और तैयार scripts
  8. 7. अपना OpenAI code मुफ़्त में चलाएँ
  9. 8. MCP से इसे tools दें
  10. 9. Prompt test करने के लिए chat करें
  11. 10. Server को background में चलता रखें
  12. 11. apfel पर बनी apps
  13. सीमाएँ और ईमानदार जवाब
  14. जब कुछ fail हो
  15. इसे किसने बनाया और कैसे test किया गया

60 सेकंड में आपका पहला जवाब

आपको एक Apple Silicon Mac (M1 या नया) चाहिए, जिसमें macOS 26 Tahoe या उसके बाद का version हो, और System Settings > Apple Intelligence & Siri में Apple Intelligence चालू हो। पहली दो चीज़ें एक line में जाँचें:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Version 26 या उससे ऊपर हो और arm64 दिखे, तो आप तैयार हैं। Homebrew से apfel install करें। न Xcode, न account, न API key:

Terminal
brew install apfel

अपना पहला सवाल पूछें:

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.

यह जवाब आपके Mac पर चल रहे Apple के model से आया। किसी server को कुछ नहीं भेजा गया, और इसका कोई खर्च नहीं हुआ।

अगर न चले: apfel से पूछें कि model तैयार है या नहीं:

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

अगर available: no दिखे, तो System Settings में Apple Intelligence चालू करें और model का download पूरा होने तक रुकें (install guide के मुताबिक यह 3 से 4 GB का है)। आपके Mac की भाषा और Siri की भाषा एक ही होनी चाहिए, और वह supported भाषा होनी चाहिए। जब तक model उपलब्ध नहीं है, apfel code 5 के साथ exit करता है।

आगे: नीचे दिए गए काम। हर एक की शुरुआत में लिखा है कि दो मिनट बाद आपके पास क्या होगा।

1. अपने Mac से उसी के बारे में पूछें

2 मिनट में आपके पास होंगे: आपकी disk, CPU और memory के बारे में सीधी भाषा में जवाब, उन्हीं commands से जिन्हें आप पहले से जानते हैं।

जब कोई terminal command ढेर सारे numbers छाप दे, तो मुझे एक line का जवाब चाहिए, ताकि मैं man page पढ़े बिना काम कर सकूँ।

कोई भी command apfel में pipe करें और बताएँ कि आपको क्या जानना है:

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.

Input छोटा रखें: पहले head, awk और grep, फिर apfel। Model एक बार में बस कुछ हज़ार शब्द पढ़ता है, code के मामले में और भी कम (सीमाएँ देखें)।

अगर न चले: कुछ commands stderr पर लिखती हैं, जिसे pipe आगे नहीं ले जाता। apfel आपको यह बता देता है: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel।

आगे: यही तरीका git log, lsof, pmset -g batt, log files और text छापने वाली किसी भी चीज़ के साथ चलता है।

2. Copy किया कोई भी text ठीक करें

2 मिनट में आपके पास होगी: एक command जो आपके clipboard पर जो भी है उसकी grammar ठीक कर देती है, किसी भी app में।

जब मैं Slack, Mail या browser में जल्दी से कोई message लिखता हूँ, तो मैं चाहता हूँ कि वह कोई दूसरी app खोले बिना साफ़ हो जाए, ताकि मैं उसे सेकंडों में वापस paste कर सकूँ।

कोई text copy करें, फिर बीच वाली line चलाएँ। pbpaste clipboard पढ़ता है, pbcopy result वापस लिख देता है:

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.

"the text above" क्यों: apfel pipe से आया text पहले रखता है और आपका instruction उसके बाद (source)। छोटे instruction "fix grammar and spelling, reply with the corrected text only" के साथ model ने message ठीक करने के बजाय उसका जवाब दे दिया और लिखा Could you let me know which meeting you're referring to?। हमारे test में, जिस text पर काम करना है उसका नाम लेने से यह ठीक हो गया।

अगर न चले: भेजने से पहले result पढ़ लें। छोटा model कभी-कभी मतलब बदल देता है; जब हमने इस वाक्य का German में अनुवाद करवाया, तो उसने "Can you send me" को "Can I send you" बना दिया।

आगे: बीच वाली line को shell alias में या Shortcuts के "Run Shell Script" action में डालें और उसे एक keyboard shortcut दे दें।

3. Receipts, PDFs और scripts पढ़ें

2 मिनट में आपके पास होंगे: किसी image, scan की गई PDF या script के बारे में जवाब, जिसे आपके Mac पर Apple के text recognition से पढ़ा गया।

जब कोई receipt, scan या अनजानी file मेरे Downloads में आती है, तो मुझे उसमें से बस वही एक बात चाहिए, ताकि मैं उसे खोले बिना सही जगह रख सकूँ।

-f से file जोड़ें। हमने इन lines वाली एक test receipt image (receipt.png) बनाई:

Output
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

यही receipt सिर्फ़ image वाली PDF के रूप में save करें तो भी चलती है, क्योंकि apfel scan किए गए pages पर text recognition चलाता है:

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

और कोई भी text file, जैसे एक shell script:

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.

यह script आपको job 6 में मिलेगी। कई files एक साथ जोड़ने के लिए -f a.txt -f b.txt लिखें।

अगर न चले: exit code 4 का मतलब है कि file model के लिए बहुत लंबी है (सीमाएँ देखें)। Exit code 3 का मतलब है कि Apple के safety filter ने उसे रोक दिया; ऐसे में file extraction guide --permissive जोड़ने की सलाह देती है।

4. आम अंग्रेज़ी को shell command में बदलें

2 मिनट में आपके पास होगी: वह command जो आपको याद नहीं आ रही थी, बिना किसी सजावट के छपी हुई, ताकि आप उसे copy कर सकें।

जब मैं find, du या tar के flags भूल जाता हूँ, तो मुझे एक सीधे वाक्य से command चाहिए, ताकि मैं terminal में ही बना रहूँ।

--code सिर्फ़ code छापता है, कोई explanation नहीं:

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

Flags सही हैं, लेकिन model ने एक folder अपने मन से गढ़ दिया। आपका home folder ~ है (यहाँ: 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

हर command चलाने से पहले पढ़ें। हमारे tests में model ने गलत commands भी दीं। "the 10 largest files in the current folder" माँगने पर उसने ls -lh | head -n 10 छापा, जो पहली 10 entries दिखाता है, सबसे बड़ी files नहीं। "show open ports" कहने पर उसने netstat -tuln | grep LISTEN सुझाया, जिसमें Linux वाले flags हैं; macOS पर यह कुछ भी नहीं छापता। Mac पर lsof -iTCP -sTCP:LISTEN -n -P उन्हें list करता है।

आगे: job 6 की cmd demo script इसी को wrap करती है और कुछ भी चलाने (-x) या command copy करने (-c) से पहले पूछती है।

5. ऐसा JSON पाएँ जिस पर आपकी scripts भरोसा कर सकें

2 मिनट में आपके पास होगा: बिखरे हुए text से निकाला गया structured data, ऐसे JSON के रूप में जो हमेशा आपके schema से मेल खाता है।

जब मुझे emails और notes में से नाम, numbers या तारीखें चाहिए, तो मुझे लंबा-चौड़ा text नहीं, fields चाहिए, ताकि मैं उन्हें jq, spreadsheet या script में डाल सकूँ।

एक JSON Schema को contact.schema.json नाम से save करें:

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

फिर --schema के साथ text pipe करें। apfel model को इस तरह बाँधता है कि output उस schema के हिसाब से valid JSON ही हो:

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"
}

Keys उसी क्रम में लौटती हैं जिसमें आपका schema उन्हें declare करता है।

किसी भी जवाब को metadata के साथ JSON में पाने के लिए -o json इस्तेमाल करें:

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

पूरी list के लिए --batch इस्तेमाल करें: हर record के लिए एक JSON line अंदर, हर record के लिए एक result line बाहर, और हर record एक नए session में। एक text file में तीन product reviews:

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 हर line को एक record बना देता है; आखिरी line stderr पर apfel का summary है। जो record fail होता है उसे status: "error" मिलता है और batch आगे चलता रहता है।

अगर न चले: apfel JSON Schema के एक हिस्से को support करता है (objects, strings, enums, numbers, booleans, arrays, local $ref)। pattern जैसा unsupported keyword मिलने पर यह exit code 2 के साथ रुकता है और उस keyword का नाम बताता है; पूरी list API compatibility doc में है।

6. अपना दिन automate करें: git, आवाज़ और तैयार scripts

2 मिनट में आपके पास होंगे: आपके हाल के काम का summary, एक Mac जो लंबा job पूरा होने पर बोलकर बताता है, और आठ तैयार AI shell scripts।

जब मैं एक काम से दूसरे पर जाता हूँ या build का इंतज़ार करता हूँ, तो मुझे छोटे automations चाहिए जो चीज़ें समझाएँ और बताएँ, ताकि मुझे terminal पर नज़र न गड़ाए रखनी पड़े।

किसी भी git repository के अंदर से, आपने क्या किया उसका summary लें:

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.

कुछ खत्म होने पर अपने Mac को बोलने दें। जवाब को say में pipe करें, और अपनी लंबी command को && के साथ उसके आगे लगा दें:

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

Test वाले Mac में sound output नहीं था, इसलिए हमने आवाज़ को file में record किया (| say -o build-done.aiff, 102,880 bytes का audio)। उसने जो वाक्य बोला वह था Your build is finished, and I'm glad you asked!।

apfel के साथ आठ demo scripts भी आती हैं। उन्हें एक folder में लिखवाएँ:

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

Testing में हमें यह वाली पसंद आई:

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

हमारे runs में हर demo अच्छा नहीं निकला: oneliner "count unique IP addresses in access.log" length limit से टकरा गया और एक टूटी हुई command छाप दी, और explain ने एक ऐसा error message जोड़ दिया जो था ही नहीं। demo README में आठों की list है।

7. अपना OpenAI code मुफ़्त में चलाएँ

2 मिनट में आपके पास होगा: एक local server जो OpenAI Chat Completions API बोलता है, ताकि आपका मौजूदा SDK code किसी paid cloud model के बजाय आपके Mac पर चले।

जब मैं OpenAI SDK के साथ prototype बनाता हूँ, तो मुझे एक मुफ़्त local endpoint चाहिए, ताकि मैं keys, bills या data बाहर भेजे बिना build और test कर सकूँ।

एक terminal tab में server शुरू करें:

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

दूसरे tab में इसे वैसे ही call करें जैसे OpenAI को:

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.

Official OpenAI Python SDK बिना किसी बदलाव के चलता है। फ़र्क सिर्फ़ base URL और model के नाम का है। इसे hello.py नाम से save करें:

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

Server सिर्फ़ आपके अपने Mac (127.0.0.1) पर listen करता है और दूसरे origins के web pages से आई requests ठुकरा देता है। इसे अपने network के लिए खोलना हो तो एक token जोड़ें: apfel --serve --host 0.0.0.0 --token-auto (server security guide)।

अगर न चले: Connection refused का मतलब है कि server नहीं चल रहा। Embeddings और पुराना /v1/completions endpoint HTTP 501 लौटाते हैं, क्योंकि on-device model ये चीज़ें नहीं देता।

आगे: maintainers ने VS Code Copilot (सिर्फ़ chat), opencode, Zed और Node.js, Ruby, PHP और छह और भाषाओं के setups document किए हैं। इस पेज के लिए हमने उन्हें दोबारा test नहीं किया।

8. MCP से इसे tools दें

2 मिनट में आपके पास होगा: एक model जो Model Context Protocol tool के ज़रिए किसी live web page को पढ़कर उसका summary देता है।

जब जवाब किसी web page पर है, तो मैं चाहता हूँ कि model उसे खुद fetch करे, ताकि मुझे इधर-उधर text copy किए बिना summary मिल जाए।

apfel-mcp tools install करें, जो छोटी context window में फिट होने के लिए ही बनाए गए हैं:

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

--mcp से कोई एक tool जोड़ें और पूछें। -q tool का raw output छिपा देता है:

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.

इसी package में apfel-mcp-ddg-search (web search), apfel-mcp-search-and-fetch और apfel-mcp-fs (कोई local file पढ़ना) भी हैं। कोई भी MCP server चलता है: local script का path या कोई https:// URL।

कई named arguments वाले tools भी चलते हैं। यह रहा apfel repository का calculator (mcp/calculator/server.py): model दोनों arguments के साथ multiply call करता है, apfel उसे चलाता है और model result के साथ जवाब देता है:

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: वाली line में apfel आपको दिखाता है कि उसने कौन सी call चलाई। apfel 1.18.0 से पहले model को arguments के नाम नहीं दिखते थे और वह उनका अंदाज़ा लगाता था, इसलिए ऐसी call fail हो जाती थी (issue #555, pull request #556 में ठीक किया गया)। अगर यहाँ आपको invalid arguments दिखे, तो brew upgrade apfel से update करें।

9. Prompt test करने के लिए chat करें

2 मिनट में आपके पास होगी: terminal में एक बातचीत, जिसे याद रहता है कि आपने पहले क्या कहा था।

जब मैं किसी script के लिए prompt तैयार कर रहा होता हूँ, तो मैं जल्दी से कुछ turns आज़माना चाहता हूँ, ताकि मैं automate करने से पहले देख सकूँ कि model कैसे react करता है।

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 से कोई persona जोड़ें, जैसे apfel --chat -s "You are a patient Python tutor"। जब कोई लंबी chat context window से बड़ी हो जाती है, तो apfel default रूप से सबसे पुराने turns हटा देता है; बाकी strategies context guide में समझाई गई हैं। Buttons वाली window चाहिए तो apfel-chat देखें।

10. Server को background में चलता रखें

2 मिनट में आपके पास होगा: OpenAI-compatible server जो login पर अपने आप शुरू होता है और port 11434 पर हमेशा तैयार रहता है।

जब मेरे Mac के tools हर दिन local endpoint इस्तेमाल करते हैं, तो मैं चाहता हूँ कि वह हमेशा चालू रहे, ताकि मुझे उसे हाथ से शुरू न करना पड़े।

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 या MCP servers जैसी settings environment variables से होती हैं, जैसे APFEL_PORT=8080 brew services start apfel। सबकी list background service guide में है।

11. apfel पर बनी apps

2 मिनट में आपके पास होगा: वही on-device model एक window, menu bar या hotkey में, अगर आपको terminal से ज़्यादा apps पसंद हैं।

ये उन्हीं maintainers की हैं (README में "apfel tree")। हमने 15 नवंबर 2026 को जाँचा कि हर install name Homebrew में मौजूद है; इस पेज के लिए हमने apps को test नहीं किया।

App क्या करती है Install
apfel-chat Streaming जवाबों, speech और image analysis वाली chat app brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Clipboard पर menu bar actions: summarize, translate, rewrite brew install Arthur-Ficial/tap/apfel-clip
apfel-quick एक key दबाएँ, पूछें, जवाब पाएँ, बंद करें brew install Arthur-Ficial/tap/apfel-quick
apfelpad Notepad, जिसमें AI एक formula है जिसे आप cell में डालते हैं brew install Arthur-Ficial/tap/apfelpad
apfel-mcp छोटी window के नाप के MCP tools (job 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run Saved config और MCP servers की list के साथ apfel brew install Arthur-Ficial/tap/apfel-run
apfel-tag Pipe किए गए किसी भी text के लिए tags, topics और emotions brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Debug के लिए window: requests, MCP messages और speech देखें brew install Arthur-Ficial/tap/apfel-gui

सीमाएँ और ईमानदार जवाब

apfel आपको Apple का on-device model देता है। README के मुताबिक इसमें करीब 3 billion parameters हैं, यानी यह ChatGPT या Claude के पीछे चलने वाले cloud models से कहीं छोटा है। यह छोटे, focused text कामों में अच्छा है। ये वो सीमाएँ हैं जिनसे हम टकराए या जो documentation में लिखी हैं।

Context window छोटी है। सवाल और जवाब दोनों को मिलाकर macOS 26 पर और M1 व M2 Macs पर 4,096 tokens में, या macOS 27 चलाने वाले 12 GB या ज़्यादा वाले M3 या नए Macs पर 8,192 tokens में फिट होना चाहिए (README)। apfel --model-info आपकी window दिखाता है। apfel का अपना README इसके लिए बहुत लंबा है। भेजने से पहले गिन लें:

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 की window में से जवाब के लिए खाली रखे गए 512 tokens घटाने के बाद बचता है। README में करीब 3,000 शब्द हैं, लेकिन Markdown और code में हर शब्द पर कई tokens लगते हैं। लंबी files हिस्सों में भेजें (head -c 6000 file), एक बार में एक section।

इसे आज की तारीख नहीं पता। इसने एक तारीख गढ़ दी:

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.

जो भी तथ्य इसे चाहिए, वह prompt में दें। जब तक आप कोई MCP tool नहीं जोड़ते, इसके पास internet नहीं है।

यह कभी-कभी पूरे भरोसे के साथ गलत होता है। आपने ऊपर देखा: job 4 में गलत shell commands, job 2 में एक अनुवाद जिसने मतलब उलट दिया। जो भी ज़रूरी हो, उसे जाँच लें।

Apple का safety filter बेकसूर text को भी रोक सकता है। तब apfel exit code 3 और The request was blocked by Apple's safety guardrails message के साथ रुक जाता है। बात दूसरे शब्दों में कहें, या creative writing और documents के लिए --permissive जोड़ें; यह क्या बदलता है, यह guardrails doc में समझाया गया है। इस पेज के runs में हमें कोई block नहीं मिला।

हर run में जवाब अलग होते हैं। ये असली outputs हैं, हर एक एक ही run से। आपके जवाबों के शब्द अलग होंगे। ज़्यादा दोहराए जा सकने वाले जवाबों के लिए --temperature 0 इस्तेमाल करें; apfel अलग-अलग runs या macOS updates में एक जैसे output का वादा नहीं करता (stability policy)।

Speed: हमारे runs में ज़्यादातर जवाब 1 से 2 सेकंड में आ गए। MCP tool के साथ web page के summary में 8 सेकंड लगे।

Requirements सख्त हैं: सिर्फ़ Apple Silicon, macOS 26 या नया, Apple Intelligence चालू, और --model-info में दी गई 15 भाषाओं में से कोई एक। Intel Macs पर यह नहीं चल सकता।

जब कुछ fail हो

apfel समस्याओं को exit code से बताता है, ताकि scripts उन पर react कर सकें। Command के ठीक बाद echo $? से इसे जाँचें।

Exit code या error मतलब क्या करें
2 गलत flag या option Flags prompt से पहले आते हैं; apfel --help उनकी list देता है
3 Apple के safety filter ने request रोक दी दूसरे शब्दों में कहें, या --permissive जोड़ें
4 Input context window के लिए बहुत लंबा है कम text भेजें; apfel --count-tokens से जाँचें
5 Model उपलब्ध नहीं Apple Intelligence चालू करें, download का इंतज़ार करें, Mac और Siri की भाषा एक रखें
6 Model busy है या rate limit लगी है रुककर दोबारा चलाएँ, या --retry जोड़ें
Connection refused Port 11434 पर कोई server नहीं apfel --serve या brew services start apfel चलाएँ
HTTP 501 ऐसा endpoint जो on-device model नहीं देता (embeddings, /v1/completions) /v1/chat/completions इस्तेमाल करें
piped input was empty Command ने stderr पर लिखा command 2>&1 \| apfel "..."

अब भी अटके हैं? GitHub पर search करें या issue खोलें।

इसे किसने बनाया और कैसे test किया गया

apfel मुफ़्त और open source है (MIT license), Franz Enzenhofer का एक franzai प्रोजेक्ट। इसे Franz के AI assistant Arthur Ficial के साथ मिलकर maintain किया जाता है, जिसने यह ट्यूटोरियल भी लिखा है। क्योंकि यह पेज apfel बनाने वालों ने ही लिखा है, इसलिए हमने जो भी failure देखी उसे छोड़ने के बजाय list कर दिया।

हमने कैसे test किया: 15 नवंबर 2026 को हमने इस पेज की हर command एक MacBook Air M2 (24 GB) पर macOS 27.0.1 (build 26A434) के साथ चलाई। हमने GitHub release से signed apfel 1.18.0 binary इस्तेमाल की (वही file जो Homebrew tap install करता है), एक असली terminal session के अंदर, और output को बिना बदले copy किया। इस पेज के पहले version (14 नवंबर 2026, apfel 1.16.0) में job 8 वाला multi-argument tool bug दिखा था; 1.18.0 उसे ठीक करता है, इसलिए हमने इस version के लिए हर command दोबारा चलाई। जहाँ पहला output गलत था, वहाँ हमने गलत output ही पेज पर रखा और यह बता दिया। दोबारा run सिर्फ़ ऐसे जवाब पाने के लिए किए गए जिन्हें edit करने की ज़रूरत न हो: web page के एक summary में लंबा dash था, जिसे यह site नहीं छापती, इसलिए हमने उसे फिर चलाया और तीसरा run रखा। Speech वाले उदाहरण को audio file में लिखकर जाँचा गया, क्योंकि test वाले Mac में sound output नहीं था। Demo scripts apfel 1.18.0 के apfel --demos ने लिखीं।

apfel के बारे में दूसरों ने क्या लिखा: Show HN post (3 अप्रैल 2026, 743 points), Better Stack की एक guide, GIGAZINE का एक article और danilchenko.dev पर एक hands-on review।

Sources: apfel README, CLI reference, install guide, demo scripts, apfel बनाम Apple का fm और issue tracker, 15 नवंबर 2026 को पढ़े गए।