apfel ایک پراجیکٹ ہے۔

ٹیوٹوریل · 15 نومبر 2026 کو test کیا گیا

apfel AI ٹیوٹوریل

آپ کے Mac میں پہلے سے موجود AI کا پہلا جواب، 60 سیکنڈ میں۔ پھر 11 کام جو یہ اچھی طرح کرتا ہے، ہر ایک copy-paste کے لیے تیار اور اصلی output کے ساتھ، اور ان چیزوں کی ایمان دارانہ فہرست جو یہ نہیں کر سکتا۔

اصلی terminal recording، بغیر کسی edit کے: apfel 1.18.0، macOS 27.0.1 پر، MacBook Air M2۔
اس صفحے پر: 15 حصے
  1. 60 سیکنڈ میں آپ کا پہلا جواب
  2. 1. اپنے Mac سے اسی کے بارے میں پوچھیں
  3. 2. کاپی کیا ہوا کوئی بھی text درست کریں
  4. 3. رسیدیں، PDFs اور scripts پڑھیں
  5. 4. سادہ انگریزی سے shell کمانڈ بنائیں
  6. 5. ایسا JSON جس پر آپ کی scripts بھروسا کر سکیں
  7. 6. اپنا دن automate کریں: git، آواز اور تیار scripts
  8. 7. اپنا OpenAI code مفت چلائیں
  9. 8. MCP کے ذریعے اسے tools دیں
  10. 9. Prompt آزمانے کے لیے chat کریں
  11. 10. Server کو background میں چلتا رکھیں
  12. 11. apfel پر بنی ایپس
  13. حدود اور سچے جواب
  14. جب کچھ کام نہ کرے
  15. یہ کس نے بنایا اور کیسے test کیا گیا

60 سیکنڈ میں آپ کا پہلا جواب

آپ کو ایک Apple Silicon Mac (M1 یا نیا) چاہیے جس پر macOS 26 Tahoe یا اس کے بعد کا ورژن ہو، اور System Settings > Apple Intelligence & Siri میں Apple Intelligence آن ہو۔ پہلی دو شرطیں ایک ہی سطر میں چیک کریں:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

اگر ورژن 26 یا اس سے زیادہ ہے اور arm64 لکھا آئے تو آپ تیار ہیں۔ apfel کو Homebrew سے انسٹال کریں۔ نہ Xcode، نہ اکاؤنٹ، نہ 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 کے ماڈل سے آیا۔ کسی server کو کچھ نہیں بھیجا گیا، اور اس پر کوئی خرچ نہیں آیا۔

اگر کام نہ کرے: apfel سے پوچھیں کہ ماڈل تیار ہے یا نہیں:

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

اگر available: no لکھا آئے تو System Settings میں Apple Intelligence آن کریں اور ماڈل کا ڈاؤن لوڈ مکمل ہونے کا انتظار کریں (install guide کے مطابق یہ 3 سے 4 GB کا ہے)۔ آپ کے Mac کی زبان اور Siri کی زبان ایک ہی ہونی چاہیے، اور وہ کوئی supported زبان ہو۔ جب تک ماڈل دستیاب نہ ہو، apfel exit code 5 کے ساتھ بند ہو جاتا ہے۔

اگلا قدم: نیچے دیے گئے کام۔ ہر کام اس بات سے شروع ہوتا ہے کہ دو منٹ بعد آپ کے پاس کیا ہوگا۔

1. اپنے Mac سے اسی کے بارے میں پوچھیں

2 منٹ میں آپ کے پاس ہوگا: آپ کی disk، CPU اور memory کے بارے میں سادہ زبان میں جواب، انہی کمانڈز سے جو آپ پہلے سے جانتے ہیں۔

جب terminal کی کوئی کمانڈ نمبروں کا ڈھیر چھاپ دے، تو میں چاہتا ہوں کہ ایک سطر کا جواب ملے، تاکہ man page پڑھے بغیر قدم اٹھا سکوں۔

کسی بھی کمانڈ کا output 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۔ ماڈل ایک وقت میں صرف چند ہزار الفاظ پڑھ سکتا ہے، اور code ہو تو اس سے بھی کم (حدود دیکھیں)۔

اگر کام نہ کرے: کچھ کمانڈز اپنا output 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 فائلوں اور ہر اس چیز کے ساتھ چلتی ہے جو text چھاپتی ہو۔

2. کاپی کیا ہوا کوئی بھی text درست کریں

2 منٹ میں آپ کے پاس ہوگی: ایک کمانڈ جو آپ کے clipboard پر موجود text کی grammar درست کر دیتی ہے، چاہے وہ کسی بھی ایپ سے آیا ہو۔

جب میں Slack، Mail یا browser میں جلدی سے کوئی پیغام لکھوں، تو میں چاہتا ہوں کہ کوئی دوسری ایپ کھولے بغیر وہ صاف ہو جائے، تاکہ چند سیکنڈ میں اسے واپس paste کر سکوں۔

کچھ text کاپی کریں، پھر درمیان والی سطر چلائیں۔ pbpaste clipboard پڑھتا ہے اور pbcopy نتیجہ واپس لکھ دیتا ہے:

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 پہلے رکھتا ہے اور آپ کی ہدایت اس کے بعد (source)۔ مختصر ہدایت "fix grammar and spelling, reply with the corrected text only" کے ساتھ ماڈل نے پیغام درست کرنے کے بجائے اس کا جواب دے دیا اور لکھا Could you let me know which meeting you're referring to?۔ ہمارے test میں جب ہدایت میں صاف بتایا کہ کس text پر کام کرنا ہے تو مسئلہ حل ہو گیا۔

اگر کام نہ کرے: بھیجنے سے پہلے نتیجہ پڑھ لیں۔ چھوٹا ماڈل کبھی کبھی مطلب بدل دیتا ہے؛ جب ہم نے اس سے یہی جملہ جرمن میں ترجمہ کرنے کو کہا تو اس نے "Can you send me" کو "Can I send you" بنا دیا۔

اگلا قدم: درمیان والی سطر کو shell alias یا Shortcuts کے "Run Shell Script" action میں ڈالیں اور اسے کوئی keyboard shortcut دے دیں۔

3. رسیدیں، PDFs اور scripts پڑھیں

2 منٹ میں آپ کے پاس ہوں گے: کسی تصویر، scan شدہ PDF یا script کے بارے میں جواب، جنہیں Apple کی text recognition آپ کے Mac پر ہی پڑھتی ہے۔

جب کوئی رسید، scan یا انجان فائل میرے Downloads میں آئے، تو میں چاہتا ہوں کہ اس میں سے مجھے بس وہ ایک بات مل جائے جس کی ضرورت ہے، تاکہ اسے کھولے بغیر سنبھال کر رکھ سکوں۔

-f سے فائل attach کریں۔ ہم نے test کے لیے رسید کی ایک تصویر (receipt.png) بنائی جس میں یہ سطریں ہیں:

آؤٹ پٹ
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

یہی رسید صرف تصویر والی PDF کے طور پر محفوظ کی جائے تو بھی کام کرتی ہے، کیونکہ apfel scan شدہ صفحات پر text recognition چلاتا ہے:

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

اور کوئی بھی text فائل، مثال کے طور پر ایک 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 آپ کو کام 6 میں ملے گی۔ کئی فائلیں ایک ساتھ attach کرنے کے لیے -f a.txt -f b.txt لکھیں۔

اگر کام نہ کرے: exit code 4 کا مطلب ہے کہ فائل ماڈل کے لیے بہت لمبی ہے (حدود دیکھیں)۔ Exit code 3 کا مطلب ہے کہ Apple کے safety filter نے اسے روک دیا؛ ایسی صورت کے لیے file extraction guide --permissive لگانے کا مشورہ دیتی ہے۔

4. سادہ انگریزی سے shell کمانڈ بنائیں

2 منٹ میں آپ کے پاس ہوگی: وہ کمانڈ جو آپ کو یاد نہیں آ رہی تھی، بغیر کسی اضافی عبارت کے، تاکہ آپ اسے سیدھا کاپی کر سکیں۔

جب میں find، du یا tar کے flags بھول جاؤں، تو میں چاہتا ہوں کہ ایک سادہ جملے سے کمانڈ مل جائے، تاکہ terminal چھوڑے بغیر کام جاری رکھ سکوں۔

--code صرف code چھاپتا ہے، کوئی وضاحت نہیں:

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 درست ہیں، مگر ماڈل نے ایک فولڈر اپنی طرف سے گھڑ لیا۔ آپ کا home فولڈر ~ ہے (یعنی: 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

ہر کمانڈ چلانے سے پہلے پڑھیں۔ ہمارے tests میں ماڈل نے غلط کمانڈز بھی دیں۔ "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 کرتا ہے۔

اگلا قدم: کام 6 کی cmd demo script یہی کام کرتی ہے اور کچھ بھی چلانے (-x) یا کمانڈ کاپی کرنے (-c) سے پہلے آپ سے پوچھتی ہے۔

5. ایسا JSON جس پر آپ کی scripts بھروسا کر سکیں

2 منٹ میں آپ کے پاس ہوگا: بے ترتیب text میں سے نکالا گیا structured ڈیٹا، ایسے JSON کی شکل میں جو ہمیشہ آپ کے schema سے میل کھاتا ہے۔

جب مجھے emails اور notes میں سے نام، نمبر یا تاریخیں چاہییں، تو میں چاہتا ہوں کہ لمبی عبارت کے بجائے fields ملیں، تاکہ انہیں jq، کسی spreadsheet یا script میں ڈال سکوں۔

ایک JSON Schema کو contact.schema.json کے نام سے محفوظ کریں:

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

پھر text کو --schema کے ساتھ pipe کریں۔ apfel ماڈل کو اس طرح پابند کرتا ہے کہ output اس schema کے مطابق درست 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 انہیں بیان کرتا ہے۔

کسی بھی جواب کو metadata سمیت JSON میں لینے کے لیے -o json استعمال کریں:

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

پوری فہرست کے لیے --batch استعمال کریں: ہر record کی ایک JSON سطر اندر، ہر record کے نتیجے کی ایک سطر باہر، اور ہر record ایک نئے session میں۔ ایک text فائل میں تین 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 ہر سطر کو ایک record بنا دیتا ہے؛ آخری سطر stderr پر apfel کا خلاصہ ہے۔ جو record ناکام ہو اسے status: "error" ملتا ہے اور batch آگے چلتا رہتا ہے۔

اگر کام نہ کرے: apfel، JSON Schema کا ایک حصہ سپورٹ کرتا ہے (objects، strings، enums، numbers، booleans، arrays، local $ref)۔ pattern جیسا کوئی غیر سپورٹ شدہ keyword ہو تو apfel exit code 2 کے ساتھ رک جاتا ہے اور اس keyword کا نام بتاتا ہے؛ پوری فہرست API compatibility doc میں ہے۔

6. اپنا دن automate کریں: git، آواز اور تیار scripts

2 منٹ میں آپ کے پاس ہوں گے: آپ کے حالیہ کام کا خلاصہ، ایک Mac جو لمبا کام ختم ہونے پر بول کر بتاتا ہے، اور آٹھ تیار AI shell scripts۔

جب میں ایک کام سے دوسرے پر جاؤں یا کسی build کا انتظار کروں، تو میں چاہتا ہوں کہ چھوٹی automations چیزیں سمجھائیں اور اعلان کریں، تاکہ مجھے terminal پر نظریں نہ جمانی پڑیں۔

کسی بھی git repository کے اندر سے، اپنے کیے ہوئے کام کا خلاصہ نکالیں:

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 کریں، اور اپنی لمبی کمانڈ && کے ساتھ اس سے پہلے لگا دیں:

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

Test والے Mac میں آواز کا output نہیں تھا، اس لیے ہم نے آواز کو ایک فائل میں record کر لیا (| say -o build-done.aiff، 102,880 bytes کی audio)۔ اس نے یہ جملہ بولا: Your build is finished, and I'm glad you asked!۔

apfel کے ساتھ آٹھ demo scripts بھی آتی ہیں۔ انہیں ایک فولڈر میں لکھوائیں:

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

test کے دوران ہمیں یہ والی پسند آئی:

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" لمبائی کی حد سے ٹکرا گئی اور ایک ٹوٹی ہوئی کمانڈ چھاپ دی، اور explain نے ایک ایسا error message جوڑ دیا جو موجود ہی نہیں تھا۔ demo README میں آٹھوں کی فہرست ہے۔

7. اپنا OpenAI code مفت چلائیں

2 منٹ میں آپ کے پاس ہوگا: ایک local server جو OpenAI Chat Completions API بولتا ہے، تاکہ آپ کا موجودہ SDK code کسی مہنگے cloud ماڈل کے بجائے آپ کے Mac پر چلے۔

جب میں OpenAI SDK کے ساتھ prototype بناؤں، تو میں چاہتا ہوں کہ ایک مفت local endpoint ہو، تاکہ keys، بلوں اور ڈیٹا باہر بھیجے بغیر 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 میں اسے بالکل OpenAI کی طرح call کریں:

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.

OpenAI کا official Python SDK بغیر کسی تبدیلی کے چلتا ہے۔ صرف base URL اور ماڈل کا نام مختلف ہیں۔ اسے hello.py کے نام سے محفوظ کریں:

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 ماڈل یہ سہولتیں نہیں دیتا۔

اگلا قدم: maintainers نے VS Code Copilot (صرف chat)، opencode، Zed اور Node.js، Ruby، PHP اور چھ مزید زبانوں کے setups کی documentation لکھی ہے۔ اس صفحے کے لیے ہم نے انہیں دوبارہ test نہیں کیا۔

8. MCP کے ذریعے اسے tools دیں

2 منٹ میں آپ کے پاس ہوگا: ایک Model Context Protocol tool کے ذریعے ماڈل جو ایک live web page پڑھ کر اس کا خلاصہ کرتا ہے۔

جب جواب کسی web page پر موجود ہو، تو میں چاہتا ہوں کہ ماڈل اسے خود لے آئے، تاکہ text اِدھر اُدھر کاپی کیے بغیر خلاصہ مل جائے۔

apfel-mcp tools انسٹال کریں، جو چھوٹی context window میں فٹ ہونے کے لیے بنائے گئے ہیں:

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

--mcp سے ایک tool جوڑیں اور سوال پوچھیں۔ -q اس tool کا خام 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 فائل پڑھنا) بھی ہیں۔ کوئی بھی MCP server چلتا ہے: کسی local script کا path یا کوئی https:// URL۔

کئی نام والے arguments لینے والے tools بھی کام کرتے ہیں۔ یہ رہا apfel repository کا calculator (mcp/calculator/server.py): ماڈل دونوں arguments کے ساتھ multiply کو call کرتا ہے، apfel اسے چلاتا ہے اور ماڈل نتیجے کے ساتھ جواب دیتا ہے:

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: والی سطر میں apfel آپ کو وہ call دکھاتا ہے جو اس نے چلائی۔ apfel 1.18.0 سے پہلے ماڈل کو arguments کے نام نظر نہیں آتے تھے اور وہ اندازے سے لکھتا تھا، اس لیے ایسی call ناکام ہو جاتی تھی (issue #555، جو pull request #556 میں ٹھیک ہوا)۔ اگر یہاں آپ کو invalid arguments نظر آئے تو brew upgrade apfel سے update کریں۔

9. Prompt آزمانے کے لیے chat کریں

2 منٹ میں آپ کے پاس ہوگی: terminal میں ایک گفتگو جو یاد رکھتی ہے کہ آپ نے پہلے کیا کہا تھا۔

جب میں کسی script کے لیے prompt تیار کر رہا ہوں، تو میں چاہتا ہوں کہ جلدی سے چند باریاں آزما لوں، تاکہ automate کرنے سے پہلے دیکھ سکوں کہ ماڈل کیسا ردعمل دیتا ہے۔

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 سب سے پرانی باریاں ہٹا دیتا ہے؛ باقی strategies context guide میں بیان کی گئی ہیں۔ بٹنوں والی 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۔ ان سب کی فہرست background service guide میں ہے۔

11. apfel پر بنی ایپس

2 منٹ میں آپ کے پاس ہوگا: وہی on-device ماڈل ایک window، menu bar یا hotkey میں، اگر آپ terminal کے بجائے ایپس پسند کرتے ہیں۔

یہ ایپس انہی maintainers کی ہیں (README میں "apfel tree")۔ ہم نے 15 نومبر 2026 کو چیک کیا کہ ہر install نام Homebrew میں موجود ہے؛ اس صفحے کے لیے ہم نے ایپس کو test نہیں کیا۔

ایپ یہ کیا کرتی ہے انسٹال
apfel-chat Chat ایپ: stream ہوتے جواب، آواز اور تصویر کا تجزیہ 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 ایک formula ہے جو آپ کسی cell میں لکھتے ہیں brew install Arthur-Ficial/tap/apfelpad
apfel-mcp چھوٹی window کے حساب سے بنے MCP tools (کام 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run محفوظ شدہ 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 Debug window: requests، MCP پیغامات، آواز brew install Arthur-Ficial/tap/apfel-gui

حدود اور سچے جواب

apfel آپ کو Apple کا on-device ماڈل دیتا ہے۔ README کے مطابق اس میں تقریباً 3 ارب parameters ہیں، یعنی ChatGPT یا Claude کے پیچھے کام کرنے والے cloud ماڈلز سے کہیں چھوٹا۔ یہ مختصر اور واضح 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 آپ کی حد دکھاتا ہے۔ 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 لگتے ہیں۔ لمبی فائلیں حصوں میں دیں (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 نہ جوڑیں، اس کے پاس انٹرنیٹ نہیں ہوتا۔

یہ کبھی کبھی پورے اعتماد سے غلط ہوتا ہے۔ آپ اوپر دیکھ چکے ہیں: کام 4 میں غلط shell کمانڈز، اور کام 2 میں ایسا ترجمہ جس نے مطلب الٹ دیا۔ جو بات اہم ہو اسے ضرور چیک کریں۔

Apple کا safety filter بے ضرر text کو بھی روک سکتا ہے۔ ایسے میں apfel exit code 3 اور اس پیغام کے ساتھ رک جاتا ہے: The request was blocked by Apple's safety guardrails۔ بات کو دوسرے الفاظ میں کہیں، یا تخلیقی تحریر اور documents کے لیے --permissive لگائیں؛ guardrails doc بتاتا ہے کہ اس سے کیا بدلتا ہے۔ اس صفحے کے runs میں ہمارا کوئی request نہیں روکا گیا۔

ہر بار جواب مختلف ہوتا ہے۔ یہاں دکھائے گئے outputs اصلی ہیں، ہر ایک ایک ہی run سے۔ آپ کے جواب کے الفاظ مختلف ہوں گے۔ زیادہ یکساں جوابوں کے لیے --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 ان پر ردعمل دے سکیں۔ کمانڈ کے فوراً بعد echo $? سے اسے چیک کریں۔

Exit code یا error مطلب کیا کریں
2 غلط flag یا option Flags، prompt سے پہلے آتے ہیں؛ apfel --help ان کی فہرست دیتا ہے
3 Apple کے safety filter نے request روک دی دوسرے الفاظ میں کہیں، یا --permissive لگائیں
4 Input، context window کے لیے بہت لمبا ہے کم text بھیجیں؛ apfel --count-tokens سے چیک کریں
5 ماڈل دستیاب نہیں Apple Intelligence آن کریں، ڈاؤن لوڈ کا انتظار کریں، Mac اور Siri کی زبان ایک کریں
6 ماڈل مصروف ہے یا rate limit لگی ہے انتظار کر کے دوبارہ چلائیں، یا --retry لگائیں
Connection refused Port 11434 پر کوئی server نہیں apfel --serve یا brew services start apfel شروع کریں
HTTP 501 ایسا endpoint جو on-device ماڈل نہیں دیتا (embeddings، /v1/completions) /v1/chat/completions استعمال کریں
piped input was empty کمانڈ نے stderr پر لکھا command 2>&1 \| apfel "..."

پھر بھی مسئلہ ہے؟ GitHub پر تلاش کریں یا نیا issue کھولیں۔

یہ کس نے بنایا اور کیسے test کیا گیا

apfel مفت اور اوپن سورس ہے (MIT license)، Franz Enzenhofer کا ایک franzai پراجیکٹ۔ اس کی دیکھ بھال Franz کے AI اسسٹنٹ Arthur Ficial کے ساتھ مل کر ہوتی ہے، جس نے یہ ٹیوٹوریل بھی لکھا۔ چونکہ یہ صفحہ apfel بنانے والوں نے لکھا ہے، اس لیے ہم نے جو بھی ناکامی دیکھی اسے چھپانے کے بجائے یہاں درج کیا۔

ہم نے کیسے test کیا: 15 نومبر 2026 کو ہم نے اس صفحے کی ہر کمانڈ MacBook Air M2 (24 GB) پر macOS 27.0.1 (build 26A434) کے ساتھ چلائی۔ ہم نے GitHub release سے signed apfel 1.18.0 binary استعمال کی (وہی فائل جو Homebrew tap انسٹال کرتا ہے)، ایک اصلی terminal session میں، اور output بغیر تبدیلی کے کاپی کیا۔ اس صفحے کے پہلے ورژن (14 نومبر 2026، apfel 1.16.0) میں کام 8 والا multi-argument tool bug نظر آیا تھا؛ 1.18.0 اسے ٹھیک کر دیتا ہے، اس لیے ہم نے اس ورژن کے لیے ہر کمانڈ دوبارہ چلائی۔ جہاں پہلا output غلط تھا، وہاں ہم نے غلط output ہی صفحے پر رہنے دیا اور یہ بات بتا دی۔ دوبارہ runs صرف ایسے جواب ڈھونڈنے کے لیے کیے جن میں کسی edit کی ضرورت نہ ہو: web page کے ایک خلاصے میں لمبا dash تھا، جو یہ سائٹ نہیں چھاپتی، اس لیے ہم نے اسے دوبارہ چلایا اور تیسرا run رکھا۔ آواز والی مثال کو audio فائل میں لکھ کر چیک کیا گیا، کیونکہ test والے Mac میں آواز کا output نہیں تھا۔ 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 کو پڑھے گئے۔