apfel është projekt i .

Udhëzues · testuar më 15 nëntor 2026

Udhëzues për apfel AI

Përgjigjja jote e parë nga AI-ja që e ke tashmë në Mac, për 60 sekonda. Pastaj 11 punë që i bën mirë, secila gati për kopjim me output-in real, dhe një listë e sinqertë e gjërave që nuk i bën dot.

Regjistrim i vërtetë terminali, pa asnjë montazh: apfel 1.18.0 në macOS 27.0.1, MacBook Air M2.
Në këtë faqe: 15 seksione
  1. Përgjigjja jote e parë në 60 sekonda
  2. 1. Pyet Mac-un për veten e tij
  3. 2. Rregullo çdo tekst që ke kopjuar
  4. 3. Lexo fatura, PDF dhe skripte
  5. 4. Nga një fjali e thjeshtë te komanda shell
  6. 5. JSON i besueshëm për skriptet e tua
  7. 6. Automatizo ditën: git, zë dhe skripte të gatshme
  8. 7. Ekzekuto kodin tënd OpenAI falas
  9. 8. Jepi mjete me MCP
  10. 9. Bisedo për të testuar një prompt
  11. 10. Mbaje serverin aktiv në sfond
  12. 11. Aplikacione të ndërtuara mbi apfel
  13. Kufijtë dhe përgjigje të sinqerta
  14. Kur diçka nuk punon
  15. Kush e bëri këtë dhe si u testua

Përgjigjja jote e parë në 60 sekonda

Të duhet një Mac me Apple Silicon (M1 ose më i ri) me macOS 26 Tahoe ose më të ri, dhe Apple Intelligence e aktivizuar te System Settings > Apple Intelligence & Siri. Dy kushtet e para i kontrollon me një rresht:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Një version 26 ose më i lartë dhe arm64 do të thonë që je gati. Instalo apfel me Homebrew. Pa Xcode, pa llogari, pa çelës API:

Terminal
brew install apfel

Bëj pyetjen tënde të parë:

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.

Kjo përgjigje erdhi nga modeli i Apple në Mac-un tënd. Asgjë nuk u dërgua te ndonjë server dhe nuk kushtoi asgjë.

Nëse nuk punon: pyet apfel nëse modeli është gati:

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

Nëse shfaqet available: no, aktivizo Apple Intelligence te System Settings dhe prit derisa modeli të përfundojë shkarkimin (udhëzuesi i instalimit thotë se është 3 deri në 4 GB). Gjuha e Mac-ut dhe gjuha e Siri duhet të jenë e njëjta gjuhë e mbështetur. Për sa kohë modeli nuk është i disponueshëm, apfel mbyllet me kodin 5.

Më tej: punët më poshtë. Secila nis me atë që do të kesh pas dy minutash.

1. Pyet Mac-un për veten e tij

Për 2 minuta ke: përgjigje në gjuhë të thjeshtë për diskun, CPU-në dhe memorien, drejtpërdrejt nga komandat që i njeh tashmë.

Kur një komandë terminali nxjerr një mur me numra, dua një përgjigje në një rresht, që të veproj pa lexuar një faqe man.

Kaloji apfel-it çdo komandë me pipe dhe thuaj çfarë do të dish:

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.

Mbaje input-in të vogël: fillimisht head, awk dhe grep, pastaj apfel. Modeli lexon vetëm disa mijëra fjalë njëherësh, edhe më pak kur bëhet fjalë për kod (shih kufijtë).

Nëse nuk punon: disa komanda shkruajnë në stderr, të cilin pipe nuk e përcjell. apfel ta thotë vetë: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Më tej: i njëjti truk punon për git log, lsof, pmset -g batt, skedarë log-esh dhe çdo gjë tjetër që nxjerr tekst.

2. Rregullo çdo tekst që ke kopjuar

Për 2 minuta ke: një komandë që rregullon gramatikën e asaj që ke në clipboard, në çdo aplikacion.

Kur shkruaj një mesazh të shpejtë në Slack, Mail ose në shfletues, dua ta pastroj pa hapur një aplikacion tjetër, që të ta ngjis sërish brenda pak sekondash.

Kopjo një tekst, pastaj ekzekuto rreshtin e mesit. pbpaste lexon clipboard-in, pbcopy e shkruan rezultatin sërish aty:

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.

Pse "the text above": apfel e vendos tekstin që vjen me pipe në fillim dhe udhëzimin tënd pas tij (burimi). Me udhëzimin e shkurtër "fix grammar and spelling, reply with the corrected text only", modeli iu përgjigj mesazhit në vend që ta korrigjonte dhe shkroi Could you let me know which meeting you're referring to?. Kur e përmendëm qartë tekstin mbi të cilin duhet të punojë, problemi u zgjidh në testin tonë.

Nëse nuk punon: lexoje rezultatin para se ta dërgosh. Një model i vogël ndonjëherë e ndryshon kuptimin; kur i kërkuam ta përkthente këtë fjali në gjermanisht, e ktheu "Can you send me" në "Can I send you".

Më tej: vendose rreshtin e mesit në një alias shell ose në një veprim "Run Shell Script" te Shortcuts dhe jepi një shkurtore tastiere.

3. Lexo fatura, PDF dhe skripte

Për 2 minuta ke: përgjigje për një imazh, një PDF të skanuar ose një skript, të lexuar në Mac-un tënd me njohjen e tekstit të Apple.

Kur në Downloads më bie një faturë, një skanim ose një skedar i panjohur, dua të vetmin fakt që më duhet prej tij, që të ta arkivoj pa e hapur.

Bashkëngjit një skedar me -f. Krijuam një imazh fature testimi (receipt.png) me këto rreshta:

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

E njëjta faturë, e ruajtur si PDF që përmban vetëm imazh, punon gjithashtu, sepse apfel ekzekuton njohjen e tekstit te faqet e skanuara:

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

Dhe çdo skedar teksti, për shembull një skript shell:

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.

Këtë skript e merr te puna 6. Disa skedarë njëherësh i bashkëngjit me -f a.txt -f b.txt.

Nëse nuk punon: kodi i daljes 4 do të thotë që skedari është shumë i gjatë për modelin (shih kufijtë). Kodi i daljes 3 do të thotë që filtri i sigurisë i Apple e bllokoi; udhëzuesi për nxjerrjen nga skedarët sugjeron të shtosh --permissive në këtë rast.

4. Nga një fjali e thjeshtë te komanda shell

Për 2 minuta ke: komandën që nuk po e mbaje mend, të shtypur pa asgjë tjetër, gati për kopjim.

Kur harroj opsionet e find, du ose tar, dua komandën nga një fjali e thjeshtë, që të mos dal nga terminali.

--code shtyp vetëm kodin, pa shpjegim:

Terminal
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100M

Opsionet janë të sakta, por modeli shpiku një dosje. Dosja jote personale është ~ (këtu: 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

Lexo çdo komandë para se ta ekzekutosh. Në testet tona modeli prodhoi edhe komanda të gabuara. Kur i kërkuam "the 10 largest files in the current folder", shtypi ls -lh | head -n 10, që liston 10 elementet e para, jo më të mëdhenjtë. Kur i kërkuam "show open ports", sugjeroi netstat -tuln | grep LISTEN, që përdor opsione Linux; në macOS nuk shtyp asgjë fare. Në Mac i liston lsof -iTCP -sTCP:LISTEN -n -P.

Më tej: skripti demo cmd te puna 6 e mbështjell këtë dhe të pyet para se të ekzekutojë diçka (-x) ose të kopjojë komandën (-c).

5. JSON i besueshëm për skriptet e tua

Për 2 minuta ke: të dhëna të strukturuara të nxjerra nga tekst i çrregullt, si JSON që përputhet gjithmonë me skemën tënde.

Kur më duhen emra, numra ose data nga email-e dhe shënime, dua fusha, jo prozë, që të t'ia kaloj jq-së, një flete llogaritëse ose një skripti.

Ruaj një JSON Schema si contact.schema.json:

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

Pastaj kaloje tekstin me pipe dhe me --schema. apfel e kufizon modelin në mënyrë që output-i të jetë JSON i vlefshëm për atë skemë:

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"
}

Çelësat kthehen në rendin që i deklaron skema jote.

Për çdo përgjigje si JSON me metadata, përdor -o json:

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

Për një listë të tërë, përdor --batch: një rresht JSON për çdo rekord në hyrje, një rresht rezultati për çdo rekord në dalje, secili rekord në një sesion të ri. Tri vlerësime produktesh në një skedar teksti:

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 e kthen çdo rresht në një rekord; rreshti i fundit është përmbledhja e apfel në stderr. Një rekord që dështon merr status: "error" dhe batch-i vazhdon.

Nëse nuk punon: apfel mbështet një nëngrup të JSON Schema (objekte, stringje, enum, numra, boolean, vargje, $ref lokale). Një fjalë kyçe e pambështetur si pattern ndalon me kodin e daljes 2 dhe e përmend me emër; lista gjendet te dokumenti i pajtueshmërisë së API-së.

6. Automatizo ditën: git, zë dhe skripte të gatshme

Për 2 minuta ke: një përmbledhje të punës tënde të fundit, një Mac që të thotë me zë kur mbaron një punë e gjatë dhe tetë skripte shell me AI, të gatshme.

Kur kaloj nga një detyrë te tjetra ose pres një build, dua automatizime të vogla që shpjegojnë dhe njoftojnë, që të mos rri duke parë terminalin.

Përmblidh çfarë ke bërë, brenda çdo repository-je git:

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.

Lëre Mac-un të flasë kur mbaron diçka. Kaloja përgjigjen me pipe te say, dhe vendos komandën tënde të gjatë para saj me &&:

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

Mac-u i testimit nuk kishte dalje zëri, ndaj e regjistruam të folurën në një skedar (| say -o build-done.aiff, 102.880 bajt audio). Fjalia që tha ishte Your build is finished, and I'm glad you asked!.

apfel vjen edhe me tetë skripte demo. Shkruaji në një dosje:

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

Një që na pëlqeu gjatë testimit:

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

Jo çdo demo doli mirë në provat tona: oneliner "count unique IP addresses in access.log" u përplas me kufirin e gjatësisë dhe shtypi një komandë të prishur, ndërsa explain shtoi një mesazh gabimi që nuk ekzistonte. README-ja e demove i liston të tetat.

7. Ekzekuto kodin tënd OpenAI falas

Për 2 minuta ke: një server lokal që flet API-në OpenAI Chat Completions, kështu që kodi ekzistues me SDK ekzekutohet në Mac-un tënd në vend të një modeli me pagesë në cloud.

Kur bëj prototipe me SDK-në e OpenAI, dua një endpoint lokal falas, që të ndërtoj dhe testoj pa çelësa, pa fatura dhe pa i dërguar të dhënat gjetkë.

Nis serverin në një skedë terminali:

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

Në një skedë të dytë, thirre si të ishte 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.

SDK-ja zyrtare e OpenAI për Python punon pa asnjë ndryshim. Ndryshojnë vetëm URL-ja bazë dhe emri i modelit. Ruaje si 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

Serveri dëgjon vetëm në Mac-un tënd (127.0.0.1) dhe refuzon kërkesat nga faqe ueb me origjinë tjetër. Për ta hapur për rrjetin tënd, shto një token: apfel --serve --host 0.0.0.0 --token-auto (udhëzuesi i sigurisë së serverit).

Nëse nuk punon: Connection refused do të thotë që serveri nuk po ekzekutohet. Embeddings dhe endpoint-i i vjetër /v1/completions kthejnë HTTP 501, sepse modeli në pajisje nuk i ofron.

Më tej: mirëmbajtësit dokumentojnë konfigurime për VS Code Copilot (vetëm chat), opencode, Zed dhe Node.js, Ruby, PHP dhe gjashtë gjuhë të tjera. Ato nuk i ritestuam për këtë faqe.

8. Jepi mjete me MCP

Për 2 minuta ke: modelin që lexon një faqe ueb live dhe e përmbledh, përmes një mjeti Model Context Protocol.

Kur përgjigjja gjendet në një faqe ueb, dua që modeli ta marrë vetë, që të kem një përmbledhje pa kopjuar tekst andej-këtej.

Instalo mjetet apfel-mcp, të ndërtuara që të përshtaten me dritaren e vogël të kontekstit:

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

Bashkëngjit një prej tyre me --mcp dhe pyet. -q fsheh output-in bruto të mjetit:

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.

E njëjta paketë ka apfel-mcp-ddg-search (kërkim në ueb), apfel-mcp-search-and-fetch dhe apfel-mcp-fs (lexon një skedar lokal). Punon çdo server MCP: një shteg drejt një skripti lokal ose një URL https://.

Punojnë edhe mjetet me disa argumente me emër. Ja kalkulatori nga repository-ja e apfel (mcp/calculator/server.py): modeli thërret multiply me të dy argumentet, apfel e ekzekuton dhe modeli përgjigjet me rezultatin:

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.

Rreshti tool: është apfel që të tregon thirrjen që ekzekutoi. Para apfel 1.18.0, modeli nuk i shihte emrat e argumenteve dhe i hamendësonte, ndaj një thirrje si kjo dështonte (issue #555, rregulluar në pull request #556). Nëse këtu sheh invalid arguments, përditëso me brew upgrade apfel.

9. Bisedo për të testuar një prompt

Për 2 minuta ke: një bisedë në terminal që mban mend çfarë ke thënë më parë.

Kur po i jap formë një prompt-i për një skript, dua të provoj shpejt disa raunde, që të shoh si reagon modeli para se ta automatizoj.

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.

Jepi një rol (persona) me -s, për shembull apfel --chat -s "You are a patient Python tutor". Kur një bisedë e gjatë e tejkalon dritaren e kontekstit, apfel si parazgjedhje heq raundet më të vjetra; udhëzuesi i kontekstit shpjegon strategjitë e tjera. Për një dritare me butona, shih apfel-chat.

10. Mbaje serverin aktiv në sfond

Për 2 minuta ke: serverin e pajtueshëm me OpenAI që niset vetë kur hyn në sistem, gjithmonë gati në portën 11434.

Kur mjetet në Mac-un tim e përdorin endpoint-in lokal çdo ditë, dua që ai të jetë gjithmonë aktiv, që të mos e nis më me dorë.

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)

Cilësimet si porta, një token ose serverët MCP janë variabla mjedisi, për shembull APFEL_PORT=8080 brew services start apfel. Të gjitha renditen te udhëzuesi i shërbimit në sfond.

11. Aplikacione të ndërtuara mbi apfel

Për 2 minuta ke: të njëjtin model në pajisje në një dritare, në shiritin e menysë ose pas një shkurtoreje tastiere, nëse aplikacionet të pëlqejnë më shumë se terminali.

Këto vijnë nga të njëjtët mirëmbajtës ("apfel tree" te README). Më 15 nëntor 2026 kontrolluam që çdo emër instalimi ekziston në Homebrew; aplikacionet nuk i testuam për këtë faqe.

Aplikacioni Çfarë bën Instalimi
apfel-chat Aplikacion chat me përgjigje në streaming, të folur dhe analizë imazhesh brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Veprime në shiritin e menysë mbi clipboard-in: përmblidh, përkthe, rishkruaj brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Shtyp një tast, pyet, merr përgjigjen, mbylle brew install Arthur-Ficial/tap/apfel-quick
apfelpad Bllok shënimesh ku AI-ja është një formulë që e vendos në një qelizë brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Mjete MCP të përmasuara për dritaren e vogël (puna 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel me një konfigurim të ruajtur dhe një listë serverësh MCP brew install Arthur-Ficial/tap/apfel-run
apfel-tag Etiketa, tema dhe emocione për çdo tekst që i kalon me pipe brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Dritare debug-u: kërkesa, mesazhe MCP, të folur brew install Arthur-Ficial/tap/apfel-gui

Kufijtë dhe përgjigje të sinqerta

apfel të jep modelin e Apple në pajisje. README e vlerëson në rreth 3 miliardë parametra, shumë më të vogël se modelet në cloud pas ChatGPT ose Claude. Është i mirë në punë të shkurtra dhe të përqendruara me tekst. Këta janë kufijtë që hasëm ose që i përmend dokumentacioni.

Dritarja e kontekstit është e vogël. Pyetja bashkë me përgjigjen duhet të nxihen në 4.096 tokenë në macOS 26 dhe në Mac-ët M1 dhe M2, ose në 8.192 tokenë në Mac-ët M3 ose më të rinj me 12 GB ose më shumë që ekzekutojnë macOS 27 (README). apfel --model-info të tregon sa është në Mac-un tënd. Vetë README-ja e apfel është shumë e gjatë për të. Numëro para se të dërgosh:

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

Numri 3.584 është dritarja prej 4.096 minus 512 tokenë që mbahen të lirë për përgjigjen. README-ja ka rreth 3.000 fjalë, por Markdown-i dhe kodi kushtojnë shumë tokenë për fjalë. Skedarët e gjatë jepja me pjesë (head -c 6000 file), seksion pas seksioni.

Nuk e di datën e sotme. Shpiku një datë:

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.

Çdo fakt që i duhet, jepja në prompt. Nuk ka internet, përveç nëse i bashkëngjit një mjet MCP.

Ndonjëherë gabon, dhe me plot bindje. E pe më lart: komanda shell të gabuara te puna 4, një përkthim që e përmbysi kuptimin te puna 2. Kontrollo çdo gjë që ka rëndësi.

Filtri i sigurisë i Apple mund të bllokojë tekst të padëmshëm. Atëherë apfel ndalon me kodin e daljes 3 dhe mesazhin The request was blocked by Apple's safety guardrails. Riformuloje, ose shto --permissive për shkrim krijues dhe dokumente; dokumenti për guardrails shpjegon çfarë ndryshon. Në provat për këtë faqe nuk hasëm asnjë bllokim.

Përgjigjet ndryshojnë në çdo ekzekutim. Këto janë output-e reale, secili nga një ekzekutim i vetëm. Të tuat do të formulohen ndryshe. Përdor --temperature 0 për përgjigje më të përsëritshme; apfel nuk premton output identik nga një ekzekutim te tjetri ose pas përditësimeve të macOS (politika e stabilitetit).

Shpejtësia: në provat tona shumica e përgjigjeve erdhën për 1 deri në 2 sekonda. Përmbledhja e faqes ueb me një mjet MCP zgjati 8 sekonda.

Kërkesat janë strikte: vetëm Apple Silicon, macOS 26 ose më i ri, Apple Intelligence e aktivizuar dhe një nga 15 gjuhët që liston --model-info. Mac-ët me Intel nuk e ekzekutojnë dot.

Kur diçka nuk punon

apfel i raporton problemet me një kod daljeje, kështu që skriptet mund të reagojnë. Kontrolloje me echo $? menjëherë pas komandës.

Kodi i daljes ose gabimi Kuptimi Çfarë të bësh
2 Opsion ose parametër i gabuar Opsionet shkojnë para prompt-it; apfel --help i liston
3 Filtri i sigurisë i Apple e bllokoi kërkesën Riformuloje, ose shto --permissive
4 Input-i është shumë i gjatë për dritaren e kontekstit Dërgo më pak tekst; kontrollo me apfel --count-tokens
5 Modeli nuk është i disponueshëm Aktivizo Apple Intelligence, prit shkarkimin, njësoje gjuhën e Mac-ut me atë të Siri
6 Modeli është i zënë ose ka kufizim kërkesash Prit dhe ekzekutoje sërish, ose shto --retry
Connection refused Asnjë server në portën 11434 Nis apfel --serve ose brew services start apfel
HTTP 501 Endpoint që modeli në pajisje nuk e ofron (embeddings, /v1/completions) Përdor /v1/chat/completions
piped input was empty Komanda shkroi në stderr command 2>&1 \| apfel "..."

Ende ke problem? Kërko ose hap një issue në GitHub.

Kush e bëri këtë dhe si u testua

apfel është falas dhe me burim të hapur (licenca MIT), një projekt i franzai nga Franz Enzenhofer. Mirëmbahet me Arthur Ficial, asistentin AI të Franz, i cili shkroi edhe këtë udhëzues. Meqë këtë faqe e shkruan vetë krijuesit e apfel, renditëm çdo dështim që pamë në vend që t'i lëmë jashtë.

Si e testuam: më 15 nëntor 2026 ekzekutuam çdo komandë të kësaj faqeje në një MacBook Air M2 (24 GB) me macOS 27.0.1 (build 26A434). Përdorëm binarin e nënshkruar apfel 1.18.0 nga publikimi në GitHub (i njëjti skedar që instalon tap-i i Homebrew), brenda një sesioni të vërtetë terminali, dhe e kopjuam output-in pa e ndryshuar. Versioni i parë i kësaj faqeje (14 nëntor 2026, apfel 1.16.0) tregonte gabimin me mjetet me shumë argumente te puna 8; 1.18.0 e rregullon, ndaj i riekzekutuam të gjitha komandat për këtë version. Aty ku output-i i parë ishte i gabuar, e mbajtëm output-in e gabuar në faqe dhe e thamë qartë. Riekzekutimet e vetme u bënë për të gjetur përgjigje që nuk kërkonin asnjë ndryshim: një përmbledhje faqeje ueb përmbante një vizë të gjatë, të cilën kjo faqe nuk e shfaq, ndaj e ekzekutuam sërish dhe mbajtëm ekzekutimin e tretë. Shembulli i të folurës u verifikua duke e shkruar audion në një skedar, sepse Mac-u i testimit nuk kishte dalje zëri. Skriptet demo u shkruan nga apfel --demos i apfel 1.18.0.

Çfarë kanë shkruar të tjerët për apfel: postimi Show HN (3 prill 2026, 743 pikë), një udhëzues nga Better Stack, një artikull nga GIGAZINE dhe një recension praktik në danilchenko.dev.

Burimet: README e apfel, referenca e CLI, udhëzuesi i instalimit, skriptet demo, apfel kundrejt fm të Apple dhe lista e issue-ve, lexuar më 15 nëntor 2026.