ट्यूटोरियल · 15 नोव्हेंबर 2026 रोजी तपासले
apfel AI ट्यूटोरियल
तुमच्या Mac मध्ये आधीपासूनच असलेल्या AI कडून 60 सेकंदांत पहिले उत्तर. त्यानंतर ते चांगल्या प्रकारे करणारी 11 कामे, प्रत्येक copy-paste साठी तयार आणि खऱ्या output सह, आणि ते काय करू शकत नाही याची प्रामाणिक यादी.
या पानावर: 15 विभाग
- 60 सेकंदांत तुमचे पहिले उत्तर
- 1. तुमच्या Mac ला त्याच्याबद्दलच विचारा
- 2. Copy केलेला कोणताही text सुधारा
- 3. पावत्या, PDFs आणि scripts वाचा
- 4. साध्या इंग्रजीतून shell command मिळवा
- 5. तुमच्या scripts ना विश्वासार्ह JSON द्या
- 6. तुमचा दिवस automate करा: git, आवाज आणि तयार scripts
- 7. तुमचा OpenAI code मोफत चालवा
- 8. MCP ने त्याला tools द्या
- 9. Prompt तपासण्यासाठी chat करा
- 10. Server background मध्ये सतत चालू ठेवा
- 11. apfel वर बनलेली apps
- मर्यादा आणि प्रामाणिक उत्तरे
- काही बिघडले तर
- हे कोणी बनवले आणि कसे तपासले
60 सेकंदांत तुमचे पहिले उत्तर
तुम्हाला Apple Silicon Mac (M1 किंवा त्यानंतरचा), macOS 26 Tahoe किंवा त्यापुढील आवृत्ती, आणि System Settings > Apple Intelligence & Siri मध्ये Apple Intelligence सुरू असणे आवश्यक आहे. पहिल्या दोन गोष्टी एकाच ओळीत तपासा:
sw_vers -productVersion && uname -m
27.0.1
arm64Version 26 किंवा जास्त आणि arm64 दिसले तर तुम्ही तयार आहात. Homebrew ने apfel install करा. ना Xcode, ना account, ना API key:
brew install apfelतुमचा पहिला प्रश्न विचारा:
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 ला काहीही पाठवले गेले नाही, आणि एक पैसाही खर्च झाला नाही.
अडचण आली तर: model तयार आहे का, हे apfel लाच विचारा:
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 exit code 5 देऊन बंद होते.
पुढे: खालील कामे. प्रत्येक कामाच्या सुरुवातीला दोन मिनिटांनंतर तुमच्याकडे काय असेल ते लिहिले आहे.
1. तुमच्या Mac ला त्याच्याबद्दलच विचारा
2 मिनिटांत तुमच्याकडे: तुमची disk, CPU आणि memory याबद्दल सोप्या भाषेतील उत्तरे, तुम्हाला आधीच माहीत असलेल्या commands मधूनच.
जेव्हा एखादी terminal command आकड्यांचा ढीग छापते, तेव्हा मला एका ओळीचे उत्तर हवे असते, जेणेकरून man page न वाचता मी लगेच काम करू शकेन.
कोणतीही command apfel मध्ये pipe करा आणि तुम्हाला काय जाणून घ्यायचे आहे ते सांगा:
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.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 तो output पुढे नेत नाही. 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 वर जे काही आहे त्याचे व्याकरण सुधारते, कोणत्याही app मध्ये.
जेव्हा मी Slack, Mail किंवा browser मध्ये घाईत message लिहितो, तेव्हा मला दुसरे app न उघडता तो नीटनेटका करून हवा असतो, जेणेकरून काही सेकंदांत तो परत paste करू शकेन.
काही text copy करा, मग मधली ओळ चालवा. pbpaste clipboard वाचते, pbcopy result परत clipboard वर लिहिते:
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 आधी ठेवते आणि तुमची सूचना त्यानंतर (source). "fix grammar and spelling, reply with the corrected text only" या छोट्या सूचनेवर model ने message सुधारण्याऐवजी त्यालाच उत्तर दिले: Could you let me know which meeting you're referring to?. कोणत्या text वर काम करायचे ते नेमके सांगितल्यावर आमच्या test मध्ये हे दुरुस्त झाले.
अडचण आली तर: पाठवण्यापूर्वी result वाचा. छोटे model कधीकधी अर्थच बदलते; हे वाक्य German मध्ये translate करायला सांगितले तेव्हा त्याने "Can you send me" चे "Can I send you" केले.
पुढे: मधली ओळ shell alias मध्ये किंवा Shortcuts मधील "Run Shell Script" action मध्ये टाका आणि तिला keyboard shortcut द्या.
3. पावत्या, PDFs आणि scripts वाचा
2 मिनिटांत तुमच्याकडे: image, scan केलेला PDF किंवा script याबद्दलची उत्तरे, Apple च्या text recognition ने तुमच्या Mac वरच वाचलेली.
जेव्हा एखादी पावती, scan किंवा अनोळखी file माझ्या Downloads मध्ये येते, तेव्हा मला त्यातली नेमकी एक माहिती हवी असते, जेणेकरून ती न उघडता मी योग्य ठिकाणी ठेवू शकेन.
-f ने file जोडा. आम्ही या ओळी असलेली एक test पावती image (receipt.png) बनवली:
CAFE APFEL
2x Melange 9.80
1x Sachertorte 7.90
1x Apfelstrudel 6.50
TOTAL EUR 24.20
14.11.2026 21:14apfel -f receipt.png "What is the total? Just the amount."
24.20हीच पावती फक्त image असलेला PDF म्हणून save केली तरी चालते, कारण apfel scan केलेल्या pages वर text recognition चालवते:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20आणि कोणतीही text file, उदाहरणार्थ एखादी shell script:
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 तुम्हाला काम 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 छापते, स्पष्टीकरण नाही:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MFlags बरोबर आहेत, पण model ने एक folder मनानेच तयार केला. तुमचा home folder म्हणजे ~ (इथे: find ~ -type f -size +100M).
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 दाखवते. "show open ports" विचारल्यावर त्याने netstat -tuln | grep LISTEN सुचवले, जे Linux चे flags वापरते; macOS वर ते काहीच छापत नाही. Mac वर lsof -iTCP -sTCP:LISTEN -n -P हे ports दाखवते.
पुढे: काम 6 मधील cmd demo script हेच काम करते आणि काहीही चालवण्यापूर्वी (-x) किंवा command copy करण्यापूर्वी (-c) विचारते.
5. तुमच्या scripts ना विश्वासार्ह JSON द्या
2 मिनिटांत तुमच्याकडे: विस्कळीत text मधून काढलेला structured data, JSON स्वरूपात जो नेहमी तुमच्या schema शी जुळतो.
जेव्हा मला emails आणि notes मधून नावे, आकडे किंवा तारखा काढायच्या असतात, तेव्हा मला लांबलचक मजकूर नव्हे तर fields हवे असतात, जेणेकरून ते jq, spreadsheet किंवा script ला देऊ शकेन.
एक JSON Schema contact.schema.json म्हणून save करा:
{
"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 च असतो:
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 मध्ये ज्या क्रमाने लिहिल्या आहेत त्याच क्रमाने परत येतात.
कोणतेही उत्तर metadata सह JSON म्हणून हवे असेल तर -o json वापरा:
apfel -o json "Translate to German: apple" | jq -r .content
Apfelसंपूर्ण यादीसाठी --batch वापरा: प्रत्येक record साठी एक JSON ओळ आत, प्रत्येक record साठी एक result ओळ बाहेर, आणि प्रत्येक record नव्या session मध्ये. एका text file मधील तीन product reviews:
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 failedjq -R प्रत्येक ओळीचा एक record बनवते; शेवटची ओळ म्हणजे stderr वरचा apfel चा सारांश. एखादा record fail झाला तर त्याला status: "error" मिळते आणि batch पुढे चालू राहते.
अडचण आली तर: apfel JSON Schema चा एक भागच support करते (objects, strings, enums, numbers, booleans, arrays, local $ref). pattern सारखा unsupported keyword असल्यास apfel exit code 2 देऊन थांबते आणि त्या keyword चे नाव सांगते; संपूर्ण यादी API compatibility doc मध्ये आहे.
6. तुमचा दिवस automate करा: git, आवाज आणि तयार scripts
2 मिनिटांत तुमच्याकडे: तुमच्या अलीकडच्या कामाचा सारांश, लांब चालणारे काम संपल्यावर मोठ्याने सांगणारा Mac, आणि आठ तयार AI shell scripts.
जेव्हा मी एका कामातून दुसऱ्या कामाकडे वळतो किंवा build ची वाट पाहत असतो, तेव्हा मला गोष्टी समजावून सांगणारी आणि कळवणारी छोटी automations हवी असतात, जेणेकरून सतत terminal कडे पाहत बसावे लागणार नाही.
कोणत्याही git repository मधून, तुम्ही काय केले त्याचा सारांश मिळवा:
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 && सह त्याच्या आधी ठेवा:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayTest 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 मध्ये लिहा:
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
• wtdTesting मध्ये आम्हाला आवडलेली एक:
./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" लांबीच्या मर्यादेला धडकले आणि त्याने तुटकी command छापली, आणि explain ने अस्तित्वात नसलेला error message जोडला. Demo README मध्ये आठही scripts ची यादी आहे.
7. तुमचा OpenAI code मोफत चालवा
2 मिनिटांत तुमच्याकडे: OpenAI Chat Completions API बोलणारा local server, म्हणजे तुमचा सध्याचा SDK code पैसे लागणाऱ्या cloud model ऐवजी तुमच्या Mac वर चालतो.
जेव्हा मी OpenAI SDK सह prototype बनवतो, तेव्हा मला मोफत local endpoint हवा असतो, जेणेकरून keys, bills किंवा data बाहेर न पाठवता build आणि test करू शकेन.
एका terminal tab मध्ये server सुरू करा:
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 मध्ये, OpenAI ला करता तसाच call करा:
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.अधिकृत OpenAI Python SDK कोणताही बदल न करता चालते. फक्त base URL आणि model चे नाव वेगळे. hello.py म्हणून save करा:
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)python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew
2. CogCafé
3. Circuit SipServer फक्त तुमच्या स्वतःच्या Mac वरच (127.0.0.1) ऐकतो आणि इतर 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 आणि आणखी सहा भाषा यांचे setup documentation केले आहे. या पानासाठी आम्ही ते पुन्हा test केलेले नाहीत.
8. MCP ने त्याला tools द्या
2 मिनिटांत तुमच्याकडे: Model Context Protocol tool च्या मदतीने एखादे live web page वाचून त्याचा सारांश देणारे model.
जेव्हा उत्तर एखाद्या web page वर असते, तेव्हा मला model ने ते स्वतःच आणावे असे वाटते, जेणेकरून text इकडून तिकडे copy न करता सारांश मिळवू शकेन.
apfel-mcp tools install करा, जे छोट्या context window मध्ये बसतील असेच बनवले आहेत:
brew install Arthur-Ficial/tap/apfel-mcp--mcp ने एक tool जोडा आणि विचारा. -q tool चा raw output लपवते:
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.
अनेक नावाचे arguments असलेले tools पण चालतात. हा apfel repository मधील calculator आहे (mcp/calculator/server.py): model दोन्ही arguments सह multiply call करते, apfel ते चालवते आणि model result सह उत्तर देते:
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: ओळीत apfel ने प्रत्यक्ष चालवलेला call दिसतो. apfel 1.18.0 पूर्वी model ला arguments ची नावे दिसत नसत आणि ते अंदाज लावत असे, त्यामुळे असा call fail होत असे (issue #555, pull request #556 मध्ये दुरुस्त). इथे invalid arguments दिसले तर brew upgrade apfel ने update करा.
9. Prompt तपासण्यासाठी chat करा
2 मिनिटांत तुमच्याकडे: terminal मधील असे संभाषण, ज्याला तुम्ही आधी काय सांगितले ते आठवते.
जेव्हा मी एखाद्या script साठी prompt घडवत असतो, तेव्हा मला पटकन काही turns वापरून पाहायचे असतात, जेणेकरून automate करण्यापूर्वी model कसे प्रतिसाद देते ते पाहू शकेन.
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 मिनिटांत तुमच्याकडे: login होताच आपोआप सुरू होणारा OpenAI-compatible server, port 11434 वर नेहमी तयार.
जेव्हा माझ्या Mac वरील tools रोज local endpoint वापरतात, तेव्हा मला तो नेहमी चालू हवा असतो, जेणेकरून तो हाताने सुरू करावा लागणार नाही.
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. त्या सर्वांची यादी background service guide मध्ये आहे.
11. apfel वर बनलेली apps
2 मिनिटांत तुमच्याकडे: तेच on-device model window, menu bar किंवा hotkey मध्ये, जर तुम्हाला terminal पेक्षा apps आवडत असतील तर.
ही apps त्याच maintainers ची आहेत (README मधील "apfel tree"). प्रत्येक install नाव Homebrew मध्ये अस्तित्वात आहे याची आम्ही 15 नोव्हेंबर 2026 रोजी खात्री केली; या पानासाठी 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: सारांश, भाषांतर, पुनर्लेखन | brew install Arthur-Ficial/tap/apfel-clip |
| apfel-quick | एक key दाबा, विचारा, उत्तर मिळवा, बंद करा | brew install Arthur-Ficial/tap/apfel-quick |
| apfelpad | Notepad, जिथे AI हा cell मध्ये लिहिलेला formula असतो | brew install Arthur-Ficial/tap/apfelpad |
| apfel-mcp | छोट्या window ला साजेसे MCP tools (काम 8) | brew install Arthur-Ficial/tap/apfel-mcp |
| apfel-run | Save केलेला config आणि MCP servers ची यादी असलेले apfel | brew install Arthur-Ficial/tap/apfel-run |
| apfel-tag | तुम्ही pipe केलेल्या कोणत्याही text साठी tags, विषय आणि भावना | brew install Arthur-Ficial/tap/apfel-tag |
| apfel-gui | Debugging साठी 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 पेक्षा खूपच लहान. छोटी, नेमकी text ची कामे ते चांगली करते. खालील मर्यादा आम्हाला प्रत्यक्ष आल्या किंवा documentation मध्ये नमूद आहेत.
Context window लहान आहे. प्रश्न आणि उत्तर मिळून macOS 26 वर आणि M1 व M2 Macs वर 4,096 tokens मध्ये, किंवा macOS 27 चालवणाऱ्या 12 GB किंवा जास्त memory असलेल्या M3 किंवा नवीन Macs वर 8,192 tokens मध्ये बसायला हवे (README). तुमचा किती आहे ते apfel --model-info दाखवते. apfel चे स्वतःचे README च त्यासाठी खूप मोठे आहे. पाठवण्यापूर्वी मोजा:
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: 43,584 म्हणजे 4,096 च्या window मधून उत्तरासाठी राखून ठेवलेले 512 tokens वजा. README मध्ये सुमारे 3,000 शब्द आहेत, पण Markdown आणि code मध्ये एका शब्दाला अनेक tokens लागतात. मोठ्या files भागांमध्ये द्या (head -c 6000 file), एका वेळी एक विभाग.
त्याला आजची तारीख माहीत नसते. त्याने एक तारीख मनानेच सांगितली:
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 नसते.
ते कधीकधी चुकते, आणि तेही आत्मविश्वासाने. तुम्ही वर पाहिलेच: काम 4 मधील चुकीच्या shell commands, काम 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 मध्ये उत्तरे वेगळी येतात. हे प्रत्येकी एका run मधील खरे outputs आहेत. तुमच्या उत्तरांचे शब्द वेगळे असतील. जास्त सातत्यपूर्ण उत्तरांसाठी --temperature 0 वापरा; apfel वेगवेगळ्या runs मध्ये किंवा macOS updates नंतर एकसारख्या output चे वचन देत नाही (stability policy).
वेग: आमच्या runs मध्ये बहुतेक उत्तरे 1 ते 2 सेकंदांत आली. MCP tool वापरून web page चा सारांश यायला 8 सेकंद लागले.
आवश्यकता कडक आहेत: फक्त Apple Silicon, macOS 26 किंवा नवीन, Apple Intelligence सुरू, आणि --model-info दाखवत असलेल्या 15 भाषांपैकी एक. Intel Macs वर ते चालू शकत नाही.
काही बिघडले तर
apfel अडचणी exit code ने कळवते, त्यामुळे scripts त्यावर प्रतिक्रिया देऊ शकतात. Command नंतर लगेच echo $? ने तो तपासा.
| Exit code किंवा error | अर्थ | काय करायचे |
|---|---|---|
2 |
चुकीचा flag किंवा option | Flags prompt च्या आधी येतात; apfel --help त्यांची यादी दाखवते |
3 |
Apple च्या safety filter ने request अडवली | वाक्य बदलून पाहा, किंवा --permissive जोडा |
4 |
Context window साठी input खूप मोठा | कमी text पाठवा; apfel --count-tokens ने तपासा |
5 |
Model उपलब्ध नाही | Apple Intelligence सुरू करा, download पूर्ण होईपर्यंत थांबा, Mac आणि Siri ची भाषा एकच ठेवा |
6 |
Model व्यस्त आहे किंवा rate limit लागला आहे | थोडे थांबून पुन्हा चालवा, किंवा --retry जोडा |
Connection refused |
Port 11434 वर कोणताही server नाही | apfel --serve किंवा brew services start apfel सुरू करा |
| HTTP 501 | On-device model देत नसलेला endpoint (embeddings, /v1/completions) |
/v1/chat/completions वापरा |
piped input was empty |
Command ने stderr वर लिहिले | command 2>&1 \| apfel "..." |
तरीही अडकला आहात? GitHub वर शोधा किंवा issue उघडा.
हे कोणी बनवले आणि कसे तपासले
apfel मोफत आणि open source आहे (MIT license), Franz Enzenhofer यांचा एक franzai प्रकल्प. त्याची देखभाल Franz यांचा AI assistant Arthur Ficial सोबत केली जाते, ज्याने हे ट्यूटोरियलही लिहिले. हे पान apfel च्या निर्मात्यांनीच लिहिले असल्यामुळे, आम्हाला दिसलेली प्रत्येक चूक आम्ही वगळण्याऐवजी इथे नोंदवली आहे.
आम्ही कसे तपासले: 15 नोव्हेंबर 2026 रोजी आम्ही या पानावरील प्रत्येक command MacBook Air M2 (24 GB) वर macOS 27.0.1 (build 26A434) सह चालवली. आम्ही GitHub release मधील signed apfel 1.18.0 binary वापरली (Homebrew tap install करते तीच file), खऱ्या terminal session मध्ये, आणि output कोणताही बदल न करता copy केला. या पानाच्या पहिल्या आवृत्तीत (14 नोव्हेंबर 2026, apfel 1.16.0) काम 8 मधील multi-argument tool bug दिसला होता; 1.18.0 तो दुरुस्त करते, म्हणून या आवृत्तीसाठी आम्ही प्रत्येक command पुन्हा चालवली. जिथे पहिला output चुकीचा होता, तिथे आम्ही तो चुकीचा output पानावर तसाच ठेवला आणि तसे स्पष्ट लिहिले. आम्ही पुन्हा runs फक्त एकाच कारणासाठी केले, edit न करता वापरता येणारी उत्तरे मिळवण्यासाठी: web page च्या एका सारांशात लांब dash होता, जो ही site छापत नाही, म्हणून आम्ही तो पुन्हा चालवला आणि तिसरा run ठेवला. Test Mac ला sound output नसल्याने speech चे उदाहरण audio file मध्ये लिहून तपासले. Demo scripts apfel 1.18.0 च्या apfel --demos ने लिहिल्या.
इतरांनी apfel बद्दल काय लिहिले: Show HN post (3 एप्रिल 2026, 743 points), Better Stack ची guide, GIGAZINE चा लेख आणि danilchenko.dev वरील hands-on review.
स्रोत: apfel README, CLI reference, install guide, demo scripts, apfel विरुद्ध Apple चे fm आणि issue tracker, 15 नोव्हेंबर 2026 रोजी वाचलेले.