apfel એ નો પ્રોજેક્ટ છે.

ટ્યુટોરિયલ · 15 નવેમ્બર 2026 ના રોજ test કરેલું

apfel AI ટ્યુટોરિયલ

તમારા Mac માં પહેલેથી રહેલા AI નો પહેલો જવાબ 60 સેકન્ડમાં. પછી 11 jobs જે તે સારી રીતે કરે છે, દરેક સાચા output સાથે copy-paste માટે તૈયાર, અને તે શું નથી કરી શકતું તેની પ્રામાણિક યાદી.

સાચું 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. કંઈક નિષ્ફળ જાય ત્યારે
  15. આ કોણે બનાવ્યું અને કેવી રીતે test થયું

60 સેકન્ડમાં તમારો પહેલો જવાબ

તમારે macOS 26 Tahoe કે તેથી નવા વર્ઝનવાળું Apple Silicon Mac (M1 કે તેથી નવું) જોઈએ, અને 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 ની ભાષા એક જ, support થતી ભાષા હોવી જોઈએ. Model ઉપલબ્ધ ન હોય ત્યાં સુધી apfel exit code 5 સાથે બંધ થાય છે.

આગળ: નીચેના jobs. દરેક job ની શરૂઆતમાં લખ્યું છે કે બે મિનિટ પછી તમારી પાસે શું હશે.

1. તમારા Mac ને તેના વિશે જ પૂછો

2 મિનિટમાં તમારી પાસે હશે: તમારી disk, CPU અને memory વિશે સાદી ભાષામાં જવાબો, સીધા એ commands માંથી જે તમે પહેલેથી જાણો છો.

જ્યારે કોઈ terminal command આંકડાઓનો ઢગલો છાપે, ત્યારે મને એક 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 જે કોઈ પણ app માં તમારા clipboard પર જે હોય તેનું વ્યાકરણ સુધારી દે.

જ્યારે હું Slack, Mail કે browser માં ઝડપથી કોઈ message લખું, ત્યારે મને બીજી app ખોલ્યા વગર તે સાફ-સુથરો જોઈએ છે, જેથી હું થોડી સેકન્ડમાં તેને પાછો paste કરી શકું.

થોડું text copy કરો, પછી વચ્ચેની line ચલાવો. 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" આપી ત્યારે model એ message સુધારવાને બદલે તેનો જવાબ આપ્યો અને લખ્યું Could you let me know which meeting you're referring to?. અમારા test માં, કયા text પર કામ કરવાનું છે તે સ્પષ્ટ કહેવાથી આ ઠીક થઈ ગયું.

જો ન ચાલે તો: મોકલતા પહેલા પરિણામ વાંચી લો. નાનું 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 વિશેના જવાબો, જે Apple ના text recognition થી તમારા Mac પર જ વંચાય છે.

જ્યારે કોઈ 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 છાપે છે, કોઈ સમજૂતી નહીં:

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 પણ આપ્યા. "હાલના folder ની 10 સૌથી મોટી files" માગી ત્યારે તેણે ls -lh | head -n 10 છાપ્યું, જે પહેલી 10 entries બતાવે છે, સૌથી મોટી નહીં. "open ports બતાવો" કહ્યું ત્યારે તેણે netstat -tuln | grep LISTEN સૂચવ્યું, જે Linux ના flags વાપરે છે; macOS પર તે કંઈ જ છાપતું નથી. Mac પર lsof -iTCP -sTCP:LISTEN -n -P તેમની યાદી આપે છે.

આગળ: job 6 નો cmd demo script આને wrap કરે છે અને કંઈ પણ ચલાવતા (-x) કે command copy કરતા (-c) પહેલા પૂછે છે.

5. એવું JSON મેળવો જેના પર તમારી scripts ભરોસો કરી શકે

2 મિનિટમાં તમારી પાસે હશે: અવ્યવસ્થિત text માંથી કાઢેલો structured data, એવા JSON તરીકે જે હંમેશા તમારા schema સાથે મેળ ખાય છે.

જ્યારે મને emails અને notes માંથી નામ, નંબર કે તારીખો જોઈએ, ત્યારે મને લાંબું લખાણ નહીં પણ 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 માં લખી છે.

કોઈ પણ જવાબ metadata સાથે JSON તરીકે જોઈએ, તો -o json વાપરો:

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

આખી યાદી માટે --batch વાપરો: દરેક record માટે અંદર એક JSON line, બહાર એક 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 નિષ્ફળ જાય તેને status: "error" મળે છે અને batch આગળ ચાલતો રહે છે.

જો ન ચાલે તો: apfel JSON Schema ના એક ભાગને support કરે છે (objects, strings, enums, numbers, booleans, arrays, local $ref). pattern જેવો unsupported keyword હોય તો તે exit code 2 સાથે અટકે છે અને તેનું નામ બતાવે છે; આખી યાદી API compatibility doc માં છે.

6. તમારો દિવસ automate કરો: git, અવાજ અને તૈયાર scripts

2 મિનિટમાં તમારી પાસે હશે: તમારા તાજેતરના કામનો summary, લાંબું કામ પૂરું થાય ત્યારે મોટેથી કહેતું Mac, અને આઠ તૈયાર 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" લંબાઈની મર્યાદામાં અટવાયો અને બગડેલો command છાપ્યો, અને explain એ એવો error message ઉમેર્યો જે અસ્તિત્વમાં જ નહોતો. Demo README માં આઠેયની યાદી છે.

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 શરૂ કરો:

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 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) પર સાંભળે છે અને બીજા 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 Context Protocol tool દ્વારા live web page વાંચીને તેનો summary આપતું model.

જ્યારે જવાબ કોઈ 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.

એકથી વધુ નામવાળા arguments ધરાવતાં tools પણ ચાલે છે. અહીં apfel repository નું calculator છે (mcp/calculator/server.py): model બંને arguments સાથે multiply call કરે છે, apfel તેને ચલાવે છે અને model પરિણામ સાથે જવાબ આપે છે:

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 નિષ્ફળ જતો (issue #555, pull request #556 માં ઠીક થયો). જો અહીં invalid arguments દેખાય, તો brew upgrade apfel થી update કરો.

9. Prompt test કરવા chat કરો

2 મિનિટમાં તમારી પાસે હશે: terminal માં એક વાતચીત જે તમે પહેલાં કહેલું યાદ રાખે છે.

જ્યારે હું કોઈ script માટે prompt ઘડી રહ્યો હોઉં, ત્યારે મારે ઝડપથી થોડા turns અજમાવી જોવા છે, જેથી હું automate કરતા પહેલા જોઈ શકું કે model કેવો પ્રતિસાદ આપે છે.

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 કાઢી નાખે છે; context guide બીજી strategies સમજાવે છે. Buttons વાળી window જોઈએ તો apfel-chat જુઓ.

10. Server ને background માં ચાલુ રાખો

2 મિનિટમાં તમારી પાસે હશે: login વખતે જાતે શરૂ થતો OpenAI-compatible server, 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 પર બનેલી apps

2 મિનિટમાં તમારી પાસે હશે: એ જ on-device model એક window, menu bar કે hotkey માં, જો તમને terminal કરતાં apps વધુ ગમતી હોય.

આ apps એ જ maintainers ની છે (README માં "apfel tree"). 15 નવેમ્બર 2026 ના રોજ અમે તપાસ્યું કે દરેક install નામ 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: summary, ભાષાંતર, ફરીથી લખવું 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 Save કરેલા config અને MCP servers ની યાદી સાથે apfel brew install Arthur-Ficial/tap/apfel-run
apfel-tag તમે pipe કરો તે કોઈ પણ text માટે tags, topics અને લાગણીઓ 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 કરતાં ઘણું નાનું. ટૂંકાં, ચોક્કસ 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 તમારી 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), એક વારમાં એક વિભાગ.

તેને આજની તારીખ ખબર નથી. તેણે એક તારીખ ઘડી કાઢી:

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 માં જવાબ અલગ આવે છે. આ દરેક એક run ના સાચા outputs છે. તમારા જવાબના શબ્દો અલગ હશે. વધુ એકસરખા જવાબો માટે --temperature 0 વાપરો; apfel runs કે macOS updates વચ્ચે એકસરખા output નું વચન આપતું નથી (stability policy).

ઝડપ: અમારા runs માં મોટા ભાગના જવાબો 1 થી 2 સેકન્ડમાં આવ્યા. MCP tool સાથે web page ના summary માં 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 Input context window માટે બહુ લાંબું છે ઓછું 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 એવો endpoint જે on-device model આપતું નથી (embeddings, /v1/completions) /v1/chat/completions વાપરો
piped input was empty Command એ stderr પર લખ્યું command 2>&1 \| apfel "..."

હજી અટવાયા છો? GitHub પર issue શોધો કે નવો issue ખોલો.

આ કોણે બનાવ્યું અને કેવી રીતે test થયું

apfel મફત અને open source છે (MIT license), Franz Enzenhofer નો એક franzai પ્રોજેક્ટ. તેની જાળવણી Franz ના AI assistant Arthur Ficial સાથે થાય છે, જેણે આ ટ્યુટોરિયલ પણ લખ્યું છે. આ પેજ apfel બનાવનારાઓએ જ લખ્યું હોવાથી, અમને દેખાયેલી દરેક નિષ્ફળતા અમે છુપાવવાને બદલે અહીં લખી છે.

અમે કેવી રીતે test કર્યું: 15 નવેમ્બર 2026 ના રોજ અમે આ પેજનો દરેક command macOS 27.0.1 (build 26A434) વાળા MacBook Air M2 (24 GB) પર ચલાવ્યો. અમે 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 નો ઘણા arguments વાળો tool bug દેખાયો હતો; 1.18.0 તેને ઠીક કરે છે, એટલે આ version માટે અમે દરેક command ફરીથી ચલાવ્યો. જ્યાં પહેલું output ખોટું હતું, ત્યાં અમે ખોટું output જ પેજ પર રાખ્યું અને એમ કહ્યું. ફરીથી runs ફક્ત એવા જવાબો મેળવવા માટે કર્યા જેમાં edit ની જરૂર ન પડે: web page ના એક summary માં લાંબો 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 vs Apple નું fm અને issue tracker, 15 નવેમ્બર 2026 ના રોજ વાંચેલાં.