apfel ఒక ప్రాజెక్ట్.

ట్యుటోరియల్ · 15 నవంబర్ 2026న పరీక్షించాం

apfel AI ట్యుటోరియల్

మీ Macలో ఇప్పటికే ఉన్న AI నుంచి 60 సెకన్లలో మీ మొదటి సమాధానం. ఆ తర్వాత అది బాగా చేసే 11 పనులు, ఒక్కొక్కటీ నిజమైన outputతో copy-paste చేయడానికి సిద్ధం, ఇంకా అది ఏం చేయలేదో నిజాయితీగా చెప్పే జాబితా.

ఏ మాత్రం edit చేయని నిజమైన terminal recording: macOS 27.0.1పై apfel 1.18.0, MacBook Air M2.
ఈ పేజీలో: 15 విభాగాలు
  1. 60 సెకన్లలో మీ మొదటి సమాధానం
  2. 1. మీ Macను దాని గురించే అడగండి
  3. 2. Copy చేసిన ఏ textనైనా సరిచేయండి
  4. 3. Receipts, PDFలు, scripts చదివించండి
  5. 4. మామూలు ఇంగ్లీష్‌ను shell commandగా మార్చండి
  6. 5. మీ scripts నమ్మగలిగే JSON పొందండి
  7. 6. మీ రోజును automate చేయండి: git, voice, రెడీమేడ్ scripts
  8. 7. మీ OpenAI codeను ఉచితంగా నడపండి
  9. 8. MCPతో దానికి tools ఇవ్వండి
  10. 9. Promptను test చేయడానికి chat చేయండి
  11. 10. Serverను backgroundలో నడుస్తూ ఉంచండి
  12. 11. apfel మీద నిర్మించిన apps
  13. పరిమితులు, నిజాయితీగా
  14. ఏదైనా fail అయినప్పుడు
  15. దీన్ని ఎవరు తయారు చేశారు, ఎలా పరీక్షించారు

60 సెకన్లలో మీ మొదటి సమాధానం

మీకు macOS 26 Tahoe లేదా కొత్త version ఉన్న 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కూ వెళ్లలేదు, ఒక్క పైసా ఖర్చు కాలేదు.

పని చేయకపోతే: model సిద్ధంగా ఉందో లేదో apfelనే అడగండి:

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తో ఆగిపోతుంది.

తర్వాత: కింద ఉన్న పనులు. ప్రతిదీ రెండు నిమిషాల తర్వాత మీ చేతిలో ఏం ఉంటుందో చెప్పడంతో మొదలవుతుంది.

1. మీ Macను దాని గురించే అడగండి

2 నిమిషాల్లో మీ చేతిలో: మీకు ఇప్పటికే తెలిసిన commands నుంచి నేరుగా, మీ disk, CPU, memory గురించి తేలికైన మాటల్లో సమాధానాలు.

ఎప్పుడు: ఒక terminal command అంకెల గుట్టను print చేసినప్పుడు. నాకు కావాల్సింది: ఒక్క లైన్ సమాధానం. దాంతో 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.

తర్వాత: ఇదే trick git log, lsof, pmset -g batt, log files, text print చేసే మరేదానికైనా పనిచేస్తుంది.

2. Copy చేసిన ఏ textనైనా సరిచేయండి

2 నిమిషాల్లో మీ చేతిలో: ఏ appలో ఉన్నా, మీ clipboardలో ఉన్న దాని grammarను సరిచేసే ఒక command.

ఎప్పుడు: Slack, Mail లేదా browserలో త్వరగా ఒక message రాసినప్పుడు. నాకు కావాల్సింది: ఇంకో app తెరవకుండానే దాన్ని శుభ్రంగా సరిచేయడం. దాంతో సెకన్లలో దాన్ని తిరిగి paste చేయగలను.

కొంత text copy చేసి, మధ్య లైన్‌ను run చేయండి. pbpaste clipboardను చదువుతుంది, pbcopy resultను తిరిగి అందులో రాస్తుంది:

Terminal
printf 'can u send me the slides from yesterdays meeting i lost them' | pbcopy
pbpaste | apfel "Rewrite the text above with correct grammar and spelling. Reply with the rewritten text only." | pbcopy
pbpaste
Can you send me the slides from yesterday’s meeting? I lost them.

"the text above" అని ఎందుకు రాశామంటే: apfel pipe చేసిన textను ముందు పెట్టి, మీ instructionను దాని తర్వాత పెడుతుంది (source). "fix grammar and spelling, reply with the corrected text only" అనే చిన్న instruction ఇచ్చినప్పుడు, model messageను సరిచేయకుండా దానికి జవాబిచ్చింది: Could you let me know which meeting you're referring to?. ఏ text మీద పని చేయాలో పేరుతో చెప్పగానే మా testలో ఆ సమస్య తీరిపోయింది.

పని చేయకపోతే: పంపే ముందు resultను చదవండి. చిన్న model అప్పుడప్పుడు అర్థాన్ని మార్చేస్తుంది; ఈ వాక్యాన్ని జర్మన్‌లోకి translate చేయమని అడిగినప్పుడు, అది "Can you send me"ను "Can I send you"గా మార్చేసింది.

తర్వాత: మధ్య లైన్‌ను ఒక shell aliasలో లేదా Shortcutsలోని "Run Shell Script" actionలో పెట్టి, దానికి ఒక keyboard shortcut ఇవ్వండి.

3. Receipts, PDFలు, scripts చదివించండి

2 నిమిషాల్లో మీ చేతిలో: ఒక image, scan చేసిన PDF లేదా script గురించి సమాధానాలు, Apple text recognitionతో మీ Macలోనే చదివినవి.

ఎప్పుడు: ఒక receipt, scan లేదా తెలియని file నా Downloadsలోకి వచ్చినప్పుడు. నాకు కావాల్సింది: అందులో నాకు అవసరమైన ఆ ఒక్క విషయం. దాంతో file తెరవకుండానే దాన్ని సరైన చోట పెట్టేయగలను.

-fతో file జత చేయండి. ఈ లైన్లతో మేం ఒక 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 మీకు పని 6లో దొరుకుతుంది. చాలా files జత చేయాలంటే -f a.txt -f b.txt.

పని చేయకపోతే: exit code 4 అంటే file modelకు చాలా పెద్దదని అర్థం (పరిమితులు చూడండి). Exit code 3 అంటే Apple safety filter దాన్ని block చేసింది; అలాంటప్పుడు --permissive జోడించమని file extraction guide సూచిస్తుంది.

4. మామూలు ఇంగ్లీష్‌ను shell commandగా మార్చండి

2 నిమిషాల్లో మీ చేతిలో: మీకు గుర్తురాని command, ఏ వివరణా లేకుండా ఒంటరిగా print అయి, copy చేసుకోవడానికి సిద్ధంగా.

ఎప్పుడు: find, du లేదా tar flags మర్చిపోయినప్పుడు. నాకు కావాల్సింది: ఒక మామూలు వాక్యం నుంచి command. దాంతో terminal వదలకుండానే పని చేసుకోగలను.

--code వివరణ లేకుండా code మాత్రమే print చేస్తుంది:

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ను run చేసే ముందు చదవండి. మా testsలో model తప్పు commands కూడా ఇచ్చింది. "the 10 largest files in the current folder" అని అడిగితే, అది ls -lh | head -n 10 print చేసింది, ఇది మొదటి 10 entriesను చూపిస్తుంది, అతి పెద్దవాటిని కాదు. "show open ports" అని అడిగితే, netstat -tuln | grep LISTEN సూచించింది, ఇది Linux flags వాడుతుంది; macOSలో ఇది ఏమీ print చేయదు. Macలో వాటిని lsof -iTCP -sTCP:LISTEN -n -P చూపిస్తుంది.

తర్వాత: పని 6లోని cmd demo script దీన్నే wrap చేస్తుంది, ఏదైనా run చేసే ముందు (-x) లేదా commandను copy చేసే ముందు (-c) మిమ్మల్ని అడుగుతుంది.

5. మీ scripts నమ్మగలిగే JSON పొందండి

2 నిమిషాల్లో మీ చేతిలో: గజిబిజి text నుంచి తీసిన structured data, ఎప్పుడూ మీ schemaకు సరిపోయే JSONగా.

ఎప్పుడు: 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"]
}

ఆ తర్వాత textను --schemaతో pipe చేయండి. Output ఆ schemaకు సరిపోయే valid JSON అయ్యేలా apfel modelను కట్టడి చేస్తుంది:

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కు ఒక result లైన్ బయటకు, ప్రతి 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 ప్రతి లైన్‌ను ఒక recordగా మారుస్తుంది; చివరి లైన్ stderr మీద apfel ఇచ్చే summary. Fail అయిన recordకు status: "error" వస్తుంది, batch మాత్రం కొనసాగుతుంది.

పని చేయకపోతే: apfel JSON Schemaలో ఒక భాగాన్ని మాత్రమే support చేస్తుంది (objects, strings, enums, numbers, booleans, arrays, local $ref). pattern లాంటి support లేని keyword వస్తే, apfel దాని పేరు చెప్పి exit code 2తో ఆగిపోతుంది; పూర్తి జాబితా API compatibility docలో ఉంది.

6. మీ రోజును automate చేయండి: git, voice, రెడీమేడ్ scripts

2 నిమిషాల్లో మీ చేతిలో: మీరు ఇటీవల చేసిన పని summary, పెద్ద job పూర్తవగానే గట్టిగా చెప్పే Mac, ఇంకా ఎనిమిది రెడీమేడ్ AI shell scripts.

ఎప్పుడు: పనులు మారుతున్నప్పుడు లేదా build కోసం ఎదురుచూస్తున్నప్పుడు. నాకు కావాల్సింది: విషయాలను వివరించి, ప్రకటించే చిన్న automations. దాంతో terminal వైపు చూస్తూ కూర్చోవాల్సిన పని ఉండదు.

ఏ git repository లోపలి నుంచైనా, మీరు ఏం చేశారో summarize చేయండి:

Terminal
git log --oneline -10 | apfel "summarize what I have been working on, two sentences"
I've been updating star counts to 6,608 and refining ISO datetimes with timezone handling in the Article JSON-LD. Additionally, I've implemented the apfel AI tutorial and redesigned the pre-header with a centered line about the project.

ఏదైనా పూర్తవగానే మీ Mac మాట్లాడేలా చేయండి. సమాధానాన్ని sayలోకి pipe చేసి, మీ పెద్ద commandను దాని ముందు &&తో పెట్టండి:

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

Test Macకు sound output లేదు, అందుకే మేం మాటను ఒక fileలోకి record చేశాం (| say -o build-done.aiff, 102,880 bytes audio). అది పలికిన వాక్యం Your build is finished, and I'm glad you asked!.

apfelతో పాటు ఎనిమిది demo scripts కూడా వస్తాయి. వాటిని ఒక folderలోకి రాయండి:

Terminal
apfel --demos
apfel: wrote 9 demo files to /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/apfel-demos
  • cmd
  • explain
  • gitsum
  • mac-narrator
  • naming
  • oneliner
  • port
  • wtd

Testingలో మాకు నచ్చినది ఒకటి:

Terminal
./apfel-demos/naming "function that retries HTTP requests with exponential backoff"
retryExponentialBackoff | exponential_retry_backoff | exponential delay retry  
retryWithExponentialBackoff | exponential_retry_http_backoff | HTTP retry with delay  
backoffRetryHTTP | exponential_http_retry | retry with exponential pause

మా runsలో ప్రతి demo బాగా పనిచేయలేదు: oneliner "count unique IP addresses in access.log" length limitకు తగిలి విరిగిన command print చేసింది, 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ను start చేయండి:

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ని పిలిచినట్టే దాన్ని పిలవండి:

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ను చదివి summarize చేసే model.

ఎప్పుడు: సమాధానం ఒక web pageలో ఉన్నప్పుడు. నాకు కావాల్సింది: model తానే దాన్ని తెచ్చుకోవడం. దాంతో text అటూ ఇటూ copy చేయకుండానే summary పొందగలను.

చిన్న context windowకు సరిపోయేలా తయారుచేసిన apfel-mcp toolsను install చేయండి:

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ను పిలుస్తుంది, apfel దాన్ని run చేస్తుంది, model resultతో సమాధానం ఇస్తుంది:

Terminal
apfel --mcp ./server.py "What is 15 times 27?"
mcp: /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/./server.py - add, subtract, multiply, divide, sqrt, power, round_number
tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

tool: లైన్ apfel run చేసిన callను మీకు చూపిస్తుంది. apfel 1.18.0కు ముందు modelకు argument పేర్లు కనిపించేవి కావు, అది వాటిని ఊహించేది, అందుకే ఇలాంటి call fail అయ్యేది (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 డిఫాల్ట్‌గా పాత turnsను తీసేస్తుంది; మిగతా strategies గురించి context guide వివరిస్తుంది. Buttons ఉన్న window కావాలంటే apfel-chat చూడండి.

10. Serverను backgroundలో నడుస్తూ ఉంచండి

2 నిమిషాల్లో మీ చేతిలో: login అవగానే తనంతట తానే start అయ్యే OpenAI-compatible server, port 11434 మీద ఎప్పుడూ సిద్ధంగా.

ఎప్పుడు: నా Macలోని tools రోజూ local endpointను వాడుతున్నప్పుడు. నాకు కావాల్సింది: అది ఎప్పుడూ ఆన్‌లో ఉండటం. దాంతో ప్రతిసారీ చేతితో start చేయాల్సిన పని ఉండదు.

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 నిమిషాల్లో మీ చేతిలో: terminal కంటే apps మీకు ఇష్టమైతే, అదే on-device model ఒక windowలో, menu barలో లేదా ఒక hotkeyతో.

ఇవి అదే 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: summarize, translate, rewrite brew install Arthur-Ficial/tap/apfel-clip
apfel-quick ఒక key నొక్కండి, అడగండి, సమాధానం పొందండి, మూసేయండి brew install Arthur-Ficial/tap/apfel-quick
apfelpad AI ఒక cellలో పెట్టే formulaగా ఉండే notepad 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, topics, emotions brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Debug కోసం window: requests, MCP messages, speech చూపిస్తుంది brew install Arthur-Ficial/tap/apfel-gui

పరిమితులు, నిజాయితీగా

apfel మీకు Apple on-device modelను అందిస్తుంది. README ప్రకారం దానికి సుమారు 3 billion parameters ఉన్నాయి, ChatGPT లేదా Claude వెనుక ఉండే cloud models కంటే చాలా చిన్నది. చిన్న, focused text పనుల్లో ఇది బాగా పనిచేస్తుంది. మాకు ఎదురైన పరిమితులు, documentation చెప్పే పరిమితులు ఇవి.

Context window చిన్నది. ప్రశ్న, సమాధానం కలిపి macOS 26 మీద, M1, M2 Macsలో 4,096 tokensలో సరిపోవాలి; macOS 27 నడిచే, 12 GB లేదా అంతకంటే ఎక్కువ ఉన్న M3 లేదా కొత్త Macsలో 8,192 tokens (README). మీదెంతో apfel --model-info చూపిస్తుంది. apfel సొంత README కూడా దానికి చాలా పెద్దది. పంపే ముందు లెక్కించండి:

Terminal
apfel --count-tokens -f README.md "summarize in 3 bullets"
8272/3584 tokens (over budget)
  prompt=7, README.md=8258
apfel -f README.md "summarize in 3 bullets"; echo "exit code: $?"
error: [context overflow] Input exceeds the model's context window: the input is 8264 tokens, the window is 4096 tokens. Shorten the conversation history.
exit code: 4

3,584 అంటే 4,096 window నుంచి సమాధానం కోసం ఖాళీగా ఉంచిన 512 tokens తీసేయగా మిగిలేది. READMEలో సుమారు 3,000 పదాలు ఉన్నాయి, కానీ Markdown, code ఒక్కో పదానికి చాలా tokens తీసుకుంటాయి. పెద్ద filesను భాగాలుగా (head -c 6000 file), ఒకసారికి ఒక section చొప్పున ఇవ్వండి.

దానికి ఈరోజు తేదీ తెలియదు. అది ఒక తేదీని కల్పించింది:

Terminal
apfel "What is today's date?"
Today's date is October 27, 2024.
apfel -s "Today is $(date '+%B %d, %Y')." "What is today's date? One sentence."
Today's date is November 15, 2026.

దానికి అవసరమైన ఏ విషయాన్నైనా promptలోనే ఇవ్వండి. మీరు ఒక MCP tool జత చేస్తే తప్ప దానికి internet ఉండదు.

అది అప్పుడప్పుడు తప్పు చెబుతుంది, అది కూడా పూర్తి నమ్మకంతో. మీరు పైన చూశారు: పని 4లో తప్పు shell commands, పని 2లో అర్థాన్ని తిప్పేసిన translation. ముఖ్యమైన ఏ విషయాన్నైనా చెక్ చేయండి.

Apple safety filter హాని లేని textను కూడా block చేయవచ్చు. అప్పుడు 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 వాడండి; runs మధ్య లేదా macOS updates తర్వాత ఒకే output వస్తుందని apfel హామీ ఇవ్వదు (stability policy).

వేగం: మా runsలో చాలా సమాధానాలు 1 నుంచి 2 సెకన్లలో వచ్చాయి. MCP toolతో web page summaryకి 8 సెకన్లు పట్టింది.

Requirements కచ్చితమైనవి: Apple Silicon మాత్రమే, macOS 26 లేదా కొత్తది, Apple Intelligence ఆన్‌లో ఉండాలి, ఇంకా --model-info చూపించే 15 భాషల్లో ఒకటి. Intel Macsలో ఇది నడవదు.

ఏదైనా fail అయినప్పుడు

apfel సమస్యలను exit codeతో తెలియజేస్తుంది, అందువల్ల scripts దానికి తగ్గట్టు స్పందించగలవు. Command అయిన వెంటనే echo $?తో దాన్ని చెక్ చేయండి.

Exit code లేదా error అర్థం ఏం చేయాలి
2 తప్పు flag లేదా option Flags promptకు ముందు రావాలి; apfel --help వాటి జాబితా చూపిస్తుంది
3 Apple safety filter requestను block చేసింది వేరేలా రాయండి, లేదా --permissive జోడించండి
4 Input context windowకు చాలా పెద్దది తక్కువ text పంపండి; apfel --count-tokensతో చెక్ చేయండి
5 Model అందుబాటులో లేదు Apple Intelligenceను ఆన్ చేయండి, download కోసం ఆగండి, Mac భాష, Siri భాష ఒకటే ఉండేలా చూడండి
6 Model busyగా ఉంది లేదా rate limit తగిలింది కాసేపు ఆగి మళ్లీ run చేయండి, లేదా --retry జోడించండి
Connection refused Port 11434 మీద server లేదు apfel --serve లేదా brew services start apfel start చేయండి
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 సహాయంతో దీన్ని నిర్వహిస్తున్నారు, ఈ ట్యుటోరియల్ రాసింది కూడా Arthur Ficialనే. apfel తయారుచేసినవాళ్లే ఈ పేజీ రాశారు కాబట్టి, మేం చూసిన ప్రతి failureను దాచకుండా ఇక్కడ రాశాం.

మేం ఎలా పరీక్షించాం: 15 నవంబర్ 2026న ఈ పేజీలోని ప్రతి commandను macOS 27.0.1 (build 26A434) ఉన్న MacBook Air M2 (24 GB) మీద run చేశాం. GitHub release నుంచి signed apfel 1.18.0 binary (Homebrew tap install చేసే అదే file) వాడాం, నిజమైన terminal sessionలో నడిపి, outputను ఏ మార్పూ లేకుండా copy చేశాం. ఈ పేజీ మొదటి version (14 నవంబర్ 2026, apfel 1.16.0) పని 8లోని multi-argument tool bugను చూపించింది; 1.18.0 దాన్ని సరిచేస్తుంది, అందుకే ఈ version కోసం ప్రతి commandను మళ్లీ run చేశాం. మొదటి output తప్పుగా వచ్చిన చోట, ఆ తప్పు outputనే పేజీలో ఉంచి ఆ విషయం చెప్పాం. Edit అవసరం లేని సమాధానాల కోసం మాత్రమే మళ్లీ run చేశాం: ఒక web page summaryలో పొడవైన dash వచ్చింది, ఈ site దాన్ని print చేయదు, అందుకే మళ్లీ run చేసి మూడో run outputను ఉంచాం. 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 article, danilchenko.devలో hands-on review.

మూలాలు: apfel README, CLI reference, install guide, demo scripts, apfel vs Apple fm, issue tracker, 15 నవంబర్ 2026న చదివినవి.