apfel একটি প্রকল্প।

টিউটোরিয়াল · পরীক্ষা করা হয়েছে 15 নভেম্বর 2026

apfel AI টিউটোরিয়াল

আপনার Mac-এ আগে থেকেই থাকা AI-এর কাছ থেকে প্রথম উত্তর, 60 সেকেন্ডে। তারপর 11টি কাজ যা এটি ভালো পারে, প্রতিটি আসল 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. কপি করা যেকোনো text ঠিক করুন
  4. 3. রসিদ, PDF আর script পড়ুন
  5. 4. সাধারণ ভাষাকে shell command-এ বদলান
  6. 5. এমন JSON পান যার উপর script ভরসা করতে পারে
  7. 6. দিনের কাজ automate করুন: git, voice আর তৈরি script
  8. 7. আপনার OpenAI code বিনা খরচে চালান
  9. 8. MCP দিয়ে tool দিন
  10. 9. Chat করে prompt পরীক্ষা করুন
  11. 10. Server-কে background-এ চালু রাখুন
  12. 11. apfel-এর উপর তৈরি app
  13. সীমাবদ্ধতা আর সৎ উত্তর
  14. কিছু ব্যর্থ হলে
  15. কে বানিয়েছে আর কীভাবে পরীক্ষা করা হয়েছে

60 সেকেন্ডে আপনার প্রথম উত্তর

আপনার লাগবে macOS 26 Tahoe বা নতুন সংস্করণ সহ একটি Apple Silicon Mac (M1 বা নতুন), আর System Settings > Apple Intelligence & Siri-তে Apple Intelligence চালু থাকতে হবে। প্রথম দুটি শর্ত এক লাইনেই যাচাই করুন:

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-র ভাষা একই এবং সমর্থিত ভাষা হতে হবে। Model যতক্ষণ unavailable, apfel ততক্ষণ exit code 5 দিয়ে বেরিয়ে যায়।

এরপর: নিচের কাজগুলো। প্রতিটির শুরুতে লেখা আছে দুই মিনিট পরে আপনার হাতে কী থাকবে।

1. আপনার Mac-কে তার নিজের কথা জিজ্ঞেস করুন

2 মিনিটে আপনি পাবেন: আপনার disk, CPU আর memory নিয়ে সহজ ভাষায় উত্তর, সরাসরি আপনার চেনা command-গুলো থেকে।

যখন কোনো terminal command সংখ্যার একটা দেয়াল ছাপিয়ে দেয়, আমি চাই এক লাইনের একটি উত্তর, যাতে 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 হলে আরও কম (সীমাবদ্ধতা দেখুন)।

যদি কাজ না করে: কিছু command 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 file আর text ছাপায় এমন যেকোনো কিছুর সঙ্গে।

2. কপি করা যেকোনো text ঠিক করুন

2 মিনিটে আপনি পাবেন: একটি command, যা যেকোনো app-এ আপনার clipboard-এ থাকা text-এর ব্যাকরণ ঠিক করে দেয়।

যখন আমি Slack, Mail বা browser-এ তাড়াহুড়ো করে একটি message লিখি, আমি চাই অন্য কোনো app না খুলেই সেটা গুছিয়ে নিতে, যাতে কয়েক সেকেন্ডেই আবার 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" দিলে model message-টি ঠিক না করে তার উত্তর দিয়ে বসেছিল: Could you let me know which meeting you're referring to?। কোন text নিয়ে কাজ করতে হবে সেটা নাম ধরে বলে দেওয়ায় আমাদের পরীক্ষায় সমস্যাটি মিটে গেছে।

যদি কাজ না করে: পাঠানোর আগে ফলাফলটি পড়ে নিন। ছোট model মাঝে মাঝে অর্থ বদলে ফেলে; এই বাক্যটি জার্মান ভাষায় অনুবাদ করতে বললে এটি "Can you send me"-কে বানিয়ে দিয়েছিল "Can I send you"।

এরপর: মাঝের লাইনটি একটি shell alias বা Shortcuts-এর "Run Shell Script" action-এ রাখুন আর তাতে একটি keyboard shortcut দিন।

3. রসিদ, PDF আর script পড়ুন

2 মিনিটে আপনি পাবেন: একটি ছবি, scan করা PDF বা script নিয়ে উত্তর, যা আপনার Mac-এই Apple-এর text recognition দিয়ে পড়া হয়।

যখন কোনো রসিদ, scan বা অচেনা file আমার Downloads-এ এসে পড়ে, আমি চাই তার ভেতর থেকে দরকারি একটি তথ্য, যাতে file না খুলেই সেটা গুছিয়ে রাখতে পারি।

-f দিয়ে একটি file যুক্ত করুন। আমরা এই লাইনগুলো দিয়ে একটি পরীক্ষামূলক রসিদের ছবি (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

একই রসিদ শুধু ছবি দিয়ে তৈরি PDF হিসেবে save করলেও কাজ করে, কারণ apfel scan করা পাতায় 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-টি আপনি পাবেন কাজ 6-এ। একাধিক file যুক্ত করতে -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 মনে করতে পারছিলেন না সেটাই, কোনো ব্যাখ্যা ছাড়া ছাপানো, যাতে সরাসরি কপি করতে পারেন।

যখন আমি find, du বা tar-এর flag ভুলে যাই, আমি চাই একটি সাধারণ বাক্য থেকে 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

Flag-গুলো ঠিক আছে, কিন্তু 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 পড়ে নিন। আমাদের পরীক্ষায় model ভুল command-ও দিয়েছে। "the 10 largest files in the current folder" চাইলে এটি ছাপিয়েছিল ls -lh | head -n 10, যা প্রথম 10টি entry দেখায়, সবচেয়ে বড়গুলো নয়। "show open ports" বললে এটি netstat -tuln | grep LISTEN প্রস্তাব করেছিল, যাতে Linux-এর flag ব্যবহার হয়েছে; macOS-এ এটি কিছুই ছাপায় না। Mac-এ lsof -iTCP -sTCP:LISTEN -n -P সেগুলোর তালিকা দেয়।

এরপর: কাজ 6-এর cmd demo script ঠিক এই কাজটিই করে, আর কিছু চালানোর আগে (-x) বা command কপি করার আগে (-c) আপনাকে জিজ্ঞেস করে নেয়।

5. এমন JSON পান যার উপর script ভরসা করতে পারে

2 মিনিটে আপনি পাবেন: অগোছালো text থেকে বের করে আনা structured data, এমন JSON হিসেবে যা সবসময় আপনার schema মেনে চলে।

যখন email আর note থেকে নাম, সংখ্যা বা তারিখ বের করতে হয়, আমি চাই গদ্য নয়, field, যাতে সেগুলো 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"
}

Key-গুলো ফেরত আসে ঠিক সেই ক্রমে, যে ক্রমে আপনার schema সেগুলো ঘোষণা করেছে।

যেকোনো উত্তর metadata সহ JSON হিসেবে পেতে -o json ব্যবহার করুন:

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

পুরো একটি তালিকার জন্য --batch ব্যবহার করুন: প্রতি record-এ একটি JSON লাইন ঢোকে, প্রতি record-এ একটি ফলাফলের লাইন বেরোয়, আর প্রতিটি record চলে একটি নতুন session-এ। একটি text file-এ তিনটি product review:

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-র একটি অংশ সমর্থন করে (object, string, enum, number, boolean, array, local $ref)। pattern-এর মতো অসমর্থিত keyword পেলে এটি exit code 2 দিয়ে থেমে যায় আর keyword-টির নাম বলে দেয়; পুরো তালিকা আছে API compatibility doc-এ।

6. দিনের কাজ automate করুন: git, voice আর তৈরি script

2 মিনিটে আপনি পাবেন: আপনার সাম্প্রতিক কাজের সারসংক্ষেপ, এমন একটি Mac যা লম্বা কোনো job শেষ হলে মুখে বলে জানিয়ে দেয়, আর আটটি তৈরি AI shell script।

যখন আমি এক কাজ থেকে আরেক কাজে যাই বা build-এর অপেক্ষায় থাকি, আমি চাই ছোট ছোট automation যা জিনিস বুঝিয়ে দেয় আর ঘোষণা করে, যাতে 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 করুন, আর আপনার লম্বা command-টি && দিয়ে তার সামনে বসিয়ে দিন:

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

পরীক্ষার Mac-এ কোনো sound output ছিল না, তাই আমরা কথাটি একটি file-এ record করেছি (| say -o build-done.aiff, 102,880 byte audio)। যে বাক্যটি বলা হয়েছিল তা হলো Your build is finished, and I'm glad you asked!।

apfel-এর সঙ্গে আটটি demo script-ও আসে। সেগুলো একটি 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

পরীক্ষার সময় যেটি আমাদের ভালো লেগেছে:

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

আমাদের পরীক্ষায় সব 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 বানাই, আমি চাই একটি free local endpoint, যাতে key, bill বা বাইরে 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) listen করে, আর অন্য origin-এর web page থেকে আসা request ফিরিয়ে দেয়। আপনার 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 এগুলো দেয় না।

এরপর: maintainer-রা setup-এর documentation দিয়েছেন VS Code Copilot (শুধু chat), opencode, Zed আর Node.js, Ruby, PHP এবং আরও ছয়টি ভাষার জন্য। এই পাতার জন্য আমরা সেগুলো নতুন করে পরীক্ষা করিনি।

8. MCP দিয়ে tool দিন

2 মিনিটে আপনি পাবেন: একটি Model Context Protocol tool-এর মাধ্যমে model একটি live web page পড়ে তার সারসংক্ষেপ করছে।

যখন উত্তরটা কোনো web page-এ থাকে, আমি চাই model নিজেই সেটা নিয়ে আসুক, যাতে text এদিক-ওদিক কপি না করেই সারসংক্ষেপ পাই।

apfel-mcp tool-গুলো 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।

একাধিক নামযুক্ত argument সহ tool-ও কাজ করে। এই হলো apfel repository-র calculator (mcp/calculator/server.py): model দুটি argument দিয়ে 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: লাইনে apfel আপনাকে দেখায় সে কোন call চালিয়েছে। apfel 1.18.0-এর আগে model argument-এর নাম দেখতে পেত না, আন্দাজ করে নিত, তাই এমন call ব্যর্থ হতো (issue #555, সমাধান হয়েছে pull request #556-এ)। এখানে invalid arguments দেখলে brew upgrade apfel দিয়ে update করুন।

9. Chat করে prompt পরীক্ষা করুন

2 মিনিটে আপনি পাবেন: terminal-এ একটি কথোপকথন, যা আগে কী বলেছেন তা মনে রাখে।

যখন আমি কোনো script-এর জন্য prompt গড়ে তুলছি, আমি চাই দ্রুত কয়েকটি turn চালিয়ে দেখতে, যাতে 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 হিসেবে সবচেয়ে পুরোনো turn-গুলো বাদ দেয়; অন্য strategy-গুলো ব্যাখ্যা করা আছে context guide-এ। Button সহ একটি window চাইলে দেখুন apfel-chat।

10. Server-কে background-এ চালু রাখুন

2 মিনিটে আপনি পাবেন: OpenAI-compatible server যা login-এর সময় নিজে থেকেই চালু হয়, port 11434-এ সবসময় প্রস্তুত।

যখন আমার Mac-এর tool-গুলো প্রতিদিন 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 server-এর মতো setting-গুলো environment variable, যেমন APFEL_PORT=8080 brew services start apfel। সবগুলোর তালিকা আছে background service guide-এ।

11. apfel-এর উপর তৈরি app

2 মিনিটে আপনি পাবেন: একই on-device model একটি window, menu bar বা hotkey-তে, যদি terminal-এর চেয়ে app আপনার বেশি পছন্দ হয়।

এগুলো একই maintainer-দের তৈরি (README-এর "apfel tree")। 15 নভেম্বর 2026-এ আমরা যাচাই করেছি যে প্রতিটি install নাম Homebrew-তে আছে; এই পাতার জন্য app-গুলো আমরা পরীক্ষা করিনি।

App কী করে Install
apfel-chat Streaming উত্তর, speech আর ছবি বিশ্লেষণ সহ chat app brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Clipboard-এর উপর menu bar action: সারসংক্ষেপ, অনুবাদ, নতুন করে লেখা 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 tool (কাজ 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run Save করা config আর MCP server-এর তালিকা সহ apfel brew install Arthur-Ficial/tap/apfel-run
apfel-tag আপনি pipe করা যেকোনো text-এর tag, topic আর আবেগ brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Debug window: request, MCP message, speech brew install Arthur-Ficial/tap/apfel-gui

সীমাবদ্ধতা আর সৎ উত্তর

apfel আপনাকে দেয় Apple-এর on-device model। README অনুযায়ী এটি প্রায় 3 billion parameter-এর, ChatGPT বা Claude-এর পেছনের cloud model-গুলোর চেয়ে অনেক ছোট। ছোট, নির্দিষ্ট text-এর কাজে এটি ভালো। নিচের সীমাবদ্ধতাগুলোয় আমরা নিজেরা আটকেছি, অথবা documentation-এ সেগুলো লেখা আছে।

Context window ছোট। প্রশ্ন আর উত্তর মিলিয়ে আঁটতে হবে macOS 26-এ এবং M1 ও M2 Mac-এ 4,096 token-এ, অথবা macOS 27 চালানো 12 GB বা তার বেশি memory-র M3 বা নতুন Mac-এ 8,192 token-এ (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 token বাদ দিলে যা থাকে। README-তে প্রায় 3,000 শব্দ আছে, কিন্তু Markdown আর code-এ প্রতি শব্দে অনেক token খরচ হয়। লম্বা file ভাগে ভাগে দিন (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 নেই।

এটি মাঝে মাঝে ভুল বলে, তাও পূর্ণ আত্মবিশ্বাসে। উপরে দেখেছেন: কাজ 4-এ ভুল shell command, কাজ 2-এ অর্থ উল্টে দেওয়া অনুবাদ। গুরুত্বপূর্ণ যেকোনো কিছু যাচাই করে নিন।

Apple-এর safety filter নিরীহ text-ও আটকে দিতে পারে। তখন apfel exit code 3 আর The request was blocked by Apple's safety guardrails message দিয়ে থেমে যায়। অন্যভাবে লিখুন, অথবা সৃজনশীল লেখা আর document-এর জন্য --permissive যোগ করুন; এতে কী বদলায় তা ব্যাখ্যা করা আছে guardrails doc-এ। এই পাতার পরীক্ষাগুলোয় আমরা কোনো block-এ পড়িনি।

প্রতিবার উত্তর আলাদা হয়। এগুলো প্রতিটি একবার চালিয়ে পাওয়া আসল output। আপনারটার ভাষা অন্যরকম হবে। বেশি পুনরাবৃত্তিযোগ্য উত্তরের জন্য --temperature 0 ব্যবহার করুন; বিভিন্ন run বা macOS update-এ হুবহু একই output-এর প্রতিশ্রুতি apfel দেয় না (stability policy)।

Speed: আমাদের পরীক্ষায় বেশিরভাগ উত্তর এসেছে 1 থেকে 2 সেকেন্ডে। MCP tool দিয়ে web page-এর সারসংক্ষেপে লেগেছে 8 সেকেন্ড।

শর্তগুলো কঠোর: শুধু Apple Silicon, macOS 26 বা নতুন, Apple Intelligence চালু, আর --model-info-এর তালিকার 15টি ভাষার একটি। Intel Mac-এ এটি চলে না।

কিছু ব্যর্থ হলে

apfel সমস্যা জানায় exit code দিয়ে, যাতে script সেই অনুযায়ী ব্যবস্থা নিতে পারে। Command-এর ঠিক পরেই echo $? দিয়ে দেখে নিন।

Exit code বা error মানে কী করবেন
2 ভুল flag বা option Flag বসে prompt-এর আগে; apfel --help সবগুলোর তালিকা দেয়
3 Apple-এর safety filter request আটকে দিয়েছে অন্যভাবে লিখুন, অথবা --permissive যোগ করুন
4 Context window-এর জন্য input বেশি লম্বা কম text পাঠান; apfel --count-tokens দিয়ে যাচাই করুন
5 Model unavailable 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 খুলুন।

কে বানিয়েছে আর কীভাবে পরীক্ষা করা হয়েছে

apfel free আর open source (MIT license), Franz Enzenhofer-এর একটি franzai প্রকল্প। এটি রক্ষণাবেক্ষণ করা হয় Franz-এর AI assistant Arthur Ficial-এর সঙ্গে, যে এই tutorial-ও লিখেছে। যেহেতু এই পাতা লিখেছেন apfel-এর নির্মাতারাই, তাই আমরা যত ব্যর্থতা দেখেছি তার একটিও বাদ না দিয়ে সবগুলো তালিকায় রেখেছি।

আমরা কীভাবে পরীক্ষা করেছি: 15 নভেম্বর 2026-এ আমরা এই পাতার প্রতিটি command চালিয়েছি macOS 27.0.1 (build 26A434) সহ একটি MacBook Air M2 (24 GB)-এ। আমরা GitHub release থেকে signed apfel 1.18.0 binary ব্যবহার করেছি (Homebrew tap যে file install করে, ঠিক সেটিই), একটি আসল terminal session-এর ভেতরে, আর output অপরিবর্তিত অবস্থায় কপি করেছি। এই পাতার প্রথম সংস্করণে (14 নভেম্বর 2026, apfel 1.16.0) কাজ 8-এর multi-argument tool bug দেখা গিয়েছিল; 1.18.0 সেটি ঠিক করেছে, তাই এই সংস্করণের জন্য আমরা প্রতিটি command আবার চালিয়েছি। যেখানে প্রথম output ভুল ছিল, সেখানে ভুল output-টিই পাতায় রেখে আমরা তা বলে দিয়েছি। আবার চালানো হয়েছে শুধু এমন উত্তর পেতে, যেগুলোতে কোনো edit লাগে না: একটি web page-এর সারসংক্ষেপে একটি লম্বা dash ছিল, যা এই site ছাপায় না, তাই আমরা আবার চালিয়ে তৃতীয় run-টি রেখেছি। Speech-এর উদাহরণটি যাচাই করা হয়েছে audio একটি file-এ লিখে, কারণ পরীক্ষার Mac-এ কোনো sound output ছিল না। Demo script-গুলো লিখেছে apfel 1.18.0-এর apfel --demos।

apfel নিয়ে অন্যরা যা লিখেছেন: Show HN post (3 এপ্রিল 2026, 743 point), Better Stack-এর একটি guide, GIGAZINE-এর একটি article আর danilchenko.dev-এ একটি hands-on review।

সূত্র: apfel README, CLI reference, install guide, demo script-গুলো, apfel বনাম Apple-এর fm আর issue tracker, পড়া হয়েছে 15 নভেম্বর 2026-এ।