apfel yra projektas.

Vadovas · išbandyta 2026 m. lapkričio 15 d.

apfel DI vadovas

Pirmasis atsakymas iš DI, kuris jau yra jūsų Mac kompiuteryje, per 60 sekundžių. Tada 11 užduočių, kurias jis atlieka gerai, kiekviena paruošta kopijuoti ir su tikra išvestimi, bei sąžiningas sąrašas to, ko jis nemoka.

Tikras terminalo įrašas, niekas nekarpyta: apfel 1.18.0, macOS 27.0.1, MacBook Air M2.
Šiame puslapyje: 15 skyriai
  1. Pirmasis atsakymas per 60 sekundžių
  2. 1. Klauskite Mac apie jį patį
  3. 2. Pataisykite bet kokį nukopijuotą tekstą
  4. 3. Skaitykite čekius, PDF ir skriptus
  5. 4. Iš paprasto sakinio į shell komandą
  6. 5. JSON, kuriuo gali pasitikėti jūsų skriptai
  7. 6. Automatizuokite dieną: git, balsas ir paruošti skriptai
  8. 7. Paleiskite savo OpenAI kodą nemokamai
  9. 8. Suteikite jam įrankių per MCP
  10. 9. Pokalbis promptui išbandyti
  11. 10. Laikykite serverį veikiantį fone
  12. 11. Programos, sukurtos su apfel
  13. Ribos ir sąžiningi atsakymai
  14. Kai kas nors nepavyksta
  15. Kas tai sukūrė ir kaip testuota

Pirmasis atsakymas per 60 sekundžių

Jums reikia Mac su Apple Silicon (M1 ar naujesniu) ir macOS 26 Tahoe ar naujesne versija, o Apple Intelligence turi būti įjungtas skiltyje Sistemos nustatymai > Apple Intelligence ir Siri. Pirmąsias dvi sąlygas patikrinsite viena eilute:

Terminalas
sw_vers -productVersion && uname -m
27.0.1
arm64

Jei versija yra 26 ar didesnė ir matote arm64, viskas paruošta. Įdiekite apfel su Homebrew. Nereikia nei Xcode, nei paskyros, nei API rakto:

Terminalas
brew install apfel

Užduokite pirmąjį klausimą:

Terminalas
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.

Šį atsakymą pateikė Apple modelis jūsų Mac kompiuteryje. Niekas nebuvo išsiųsta į serverį, ir tai nekainavo nieko.

Jei nepavyksta: paklauskite apfel, ar modelis paruoštas:

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

Jei matote available: no, Sistemos nustatymuose įjunkite Apple Intelligence ir palaukite, kol modelis bus atsisiųstas (pagal diegimo vadovą jis užima 3-4 GB). Mac sistemos kalba ir Siri kalba turi sutapti ir būti palaikoma. Kol modelis nepasiekiamas, apfel baigia darbą su išėjimo kodu 5.

Toliau: užduotys žemiau. Kiekviena prasideda tuo, ką turėsite po dviejų minučių.

1. Klauskite Mac apie jį patį

Per 2 minutes turėsite: aiškius atsakymus paprasta kalba apie diską, procesorių ir atmintį, tiesiai iš jau pažįstamų komandų.

Kai terminalo komanda išspausdina skaičių sieną, noriu atsakymo viena eilute, kad galėčiau veikti neskaitęs viso žinyno (man puslapio).

Perduokite bet kurios komandos išvestį į apfel per pipe ir pasakykite, ką norite sužinoti:

Terminalas
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
Terminalas
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.

Įvestį laikykite trumpą: pirmiausia head, awk ir grep, tik tada apfel. Modelis vienu metu perskaito tik kelis tūkstančius žodžių, o kodo dar mažiau (žr. ribas).

Jei nepavyksta: kai kurios komandos rašo į stderr, o pipe jo neperduoda. apfel apie tai praneša: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Toliau: tas pats triukas veikia su git log, lsof, pmset -g batt, žurnalų failais ir viskuo, kas spausdina tekstą.

2. Pataisykite bet kokį nukopijuotą tekstą

Per 2 minutes turėsite: komandą, kuri bet kurioje programoje ištaiso iškarpinėje esančio teksto gramatiką.

Kai greitai rašau žinutę Slack, Mail ar naršyklėje, noriu, kad ji būtų sutvarkyta neatidarant kitos programos, kad galėčiau per kelias sekundes ją vėl įklijuoti.

Nukopijuokite tekstą ir paleiskite vidurinę eilutę. pbpaste skaito iškarpinę, pbcopy įrašo rezultatą atgal:

Terminalas
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.

Kodėl „the text above“: apfel per pipe gautą tekstą deda pirmą, o jūsų nurodymą po jo (šaltinis). Su trumpu nurodymu "fix grammar and spelling, reply with the corrected text only" modelis atsakė į žinutę, užuot ją pataisęs, ir parašė Could you let me know which meeting you're referring to?. Mūsų teste padėjo tai, kad aiškiai įvardijome tekstą, su kuriuo reikia dirbti.

Jei nepavyksta: prieš siųsdami perskaitykite rezultatą. Mažas modelis kartais pakeičia prasmę: kai paprašėme išversti šį sakinį į vokiečių kalbą, „Can you send me“ jis pavertė „Can I send you“.

Toliau: įrašykite vidurinę eilutę į shell alias arba į Shortcuts veiksmą „Run Shell Script“ ir priskirkite jam klavišų kombinaciją.

3. Skaitykite čekius, PDF ir skriptus

Per 2 minutes turėsite: atsakymus apie paveikslėlį, nuskenuotą PDF ar skriptą, perskaitytą jūsų Mac kompiuteryje Apple teksto atpažinimu.

Kai į aplanką „Atsisiuntimai“ atkeliauja čekis, skenuotas dokumentas ar nežinomas failas, noriu gauti vienintelį man reikalingą faktą, kad galėčiau jį sutvarkyti net neatidaręs.

Failą pridėkite su -f. Sukūrėme bandomąjį čekio paveikslėlį (receipt.png) su šiomis eilutėmis:

Išvestis
CAFE APFEL
2x Melange          9.80
1x Sachertorte      7.90
1x Apfelstrudel     6.50
TOTAL EUR          24.20
14.11.2026  21:14
Terminalas
apfel -f receipt.png "What is the total? Just the amount."
24.20

Tas pats čekis, išsaugotas kaip PDF tik su paveikslėliu, irgi veikia, nes apfel skenuotiems puslapiams taiko teksto atpažinimą:

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

Ir bet kuris tekstinis failas, pavyzdžiui, shell skriptas:

Terminalas
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.

Šį skriptą gausite 6 užduotyje. Kelis failus pridėsite taip: -f a.txt -f b.txt.

Jei nepavyksta: išėjimo kodas 4 reiškia, kad failas modeliui per ilgas (žr. ribas). Išėjimo kodas 3 reiškia, kad jį užblokavo Apple saugumo filtras; tokiu atveju failų nuskaitymo vadovas siūlo pridėti --permissive.

4. Iš paprasto sakinio į shell komandą

Per 2 minutes turėsite: komandą, kurios negalėjote prisiminti, išspausdintą be jokių priedų, kad galėtumėte ją nukopijuoti.

Kai pamirštu find, du ar tar parametrus, noriu gauti komandą iš paprasto sakinio, kad galėčiau neišeiti iš terminalo.

--code išspausdina tik kodą, be paaiškinimų:

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

Parametrai teisingi, bet aplanką modelis išsigalvojo. Jūsų namų aplankas yra ~ (šiuo atveju: find ~ -type f -size +100M).

Terminalas
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

Perskaitykite kiekvieną komandą prieš ją paleisdami. Mūsų testuose modelis pateikė ir klaidingų. Paprašytas „the 10 largest files in the current folder“, jis išspausdino ls -lh | head -n 10, kuri parodo pirmus 10 įrašų, o ne didžiausius. Paprašytas „show open ports“, pasiūlė netstat -tuln | grep LISTEN su Linux parametrais; macOS sistemoje ji neišspausdina visiškai nieko. Mac kompiuteryje atvirus prievadus parodo lsof -iTCP -sTCP:LISTEN -n -P.

Toliau: demonstracinis skriptas cmd iš 6 užduoties remiasi šia galimybe ir paklausia prieš ką nors paleisdamas (-x) ar nukopijuodamas komandą (-c).

5. JSON, kuriuo gali pasitikėti jūsų skriptai

Per 2 minutes turėsite: struktūrizuotus duomenis, ištrauktus iš netvarkingo teksto, JSON formatu, kuris visada atitinka jūsų schemą.

Kai man reikia vardų, skaičių ar datų iš laiškų ir užrašų, noriu laukų, o ne rišlaus teksto, kad galėčiau juos perduoti jq, skaičiuoklei ar skriptui.

Išsaugokite JSON Schema kaip contact.schema.json:

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

Tada perduokite tekstą per pipe su --schema. apfel apriboja modelį taip, kad išvestis būtų šią schemą atitinkantis galiojantis JSON:

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

Raktai grąžinami ta tvarka, kuria jie aprašyti jūsų schemoje.

Jei bet kokį atsakymą norite gauti kaip JSON su metaduomenimis, naudokite -o json:

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

Visam sąrašui naudokite --batch: įvestyje viena JSON eilutė kiekvienam įrašui, išvestyje viena rezultato eilutė kiekvienam įrašui, ir kiekvienas įrašas apdorojamas naujoje sesijoje. Trys produktų atsiliepimai tekstiniame faile:

Terminalas
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 kiekvieną eilutę paverčia įrašu; paskutinė eilutė yra apfel santrauka, išvesta į stderr. Nepavykęs įrašas gauna status: "error", o paketas apdorojamas toliau.

Jei nepavyksta: apfel palaiko JSON Schema poaibį (objektai, eilutės, enum, skaičiai, loginės reikšmės, masyvai, vietiniai $ref). Nepalaikomas raktinis žodis, pavyzdžiui, pattern, sustabdo vykdymą su išėjimo kodu 2 ir yra įvardijamas; visas sąrašas pateiktas API suderinamumo dokumente.

6. Automatizuokite dieną: git, balsas ir paruošti skriptai

Per 2 minutes turėsite: naujausio savo darbo santrauką, Mac, kuris garsiai praneša, kai baigiasi ilga užduotis, ir aštuonis paruoštus DI shell skriptus.

Kai perjungiu užduotis ar laukiu, kol baigsis kompiliavimas, noriu mažų automatizacijų, kurios viską paaiškina ir praneša, kad galėčiau nebestebėti terminalo.

Apibendrinkite, ką nuveikėte, iš bet kurios git saugyklos:

Terminalas
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.

Tegul Mac prabyla, kai kas nors baigiasi. Perduokite atsakymą į say, o savo ilgą komandą parašykite prieš ją ir sujunkite su &&:

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

Bandomasis Mac neturėjo garso išvesties, todėl kalbą įrašėme į failą (| say -o build-done.aiff, 102 880 baitų garso). Ištartas sakinys buvo Your build is finished, and I'm glad you asked!.

Kartu su apfel pateikiami ir aštuoni demonstraciniai skriptai. Įrašykite juos į aplanką:

Terminalas
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

Vienas, kuris mums patiko testuojant:

Terminalas
./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

Mūsų bandymuose ne visi demonstraciniai skriptai pasirodė gerai: oneliner "count unique IP addresses in access.log" atsimušė į ilgio ribą ir išspausdino sugadintą komandą, o explain pridėjo neegzistuojantį klaidos pranešimą. Visi aštuoni aprašyti demonstracijų README.

7. Paleiskite savo OpenAI kodą nemokamai

Per 2 minutes turėsite: vietinį serverį, kuris supranta OpenAI Chat Completions API, todėl esamas SDK kodas veikia jūsų Mac kompiuteryje, o ne mokamame debesų modelyje.

Kai kuriu prototipą su OpenAI SDK, noriu nemokamo vietinio galinio taško, kad galėčiau kurti ir testuoti be raktų, sąskaitų ir duomenų siuntimo kitur.

Paleiskite serverį viename terminalo skirtuke:

Terminalas
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

Antrame skirtuke kreipkitės į jį kaip į OpenAI:

Terminalas
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.

Oficialus OpenAI Python SDK veikia be jokių pakeitimų. Skiriasi tik bazinis URL ir modelio pavadinimas. Išsaugokite kaip 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)
Terminalas
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

Serveris klausosi tik jūsų paties Mac (127.0.0.1) ir atmeta užklausas iš kitos kilmės (origin) tinklalapių. Norėdami jį atverti savo tinklui, pridėkite tokeną: apfel --serve --host 0.0.0.0 --token-auto (serverio saugumo vadovas).

Jei nepavyksta: Connection refused reiškia, kad serveris neveikia. Embeddings ir senasis galinis taškas /v1/completions grąžina HTTP 501, nes modelis įrenginyje jų nesiūlo.

Toliau: prižiūrėtojai yra aprašę konfigūracijas, skirtas VS Code Copilot (tik pokalbiui), opencode, Zed ir Node.js, Ruby, PHP bei dar šešioms kalboms. Šiam puslapiui jų pakartotinai netestavome.

8. Suteikite jam įrankių per MCP

Per 2 minutes turėsite: modelį, kuris per Model Context Protocol įrankį perskaito gyvą tinklalapį ir jį apibendrina.

Kai atsakymas yra tinklalapyje, noriu, kad modelis jį parsisiųstų pats, kad galėčiau gauti santrauką nekopijuodamas teksto pirmyn atgal.

Įdiekite apfel-mcp įrankius, sukurtus tilpti mažame konteksto lange:

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

Prijunkite vieną su --mcp ir klauskite. -q paslepia neapdorotą įrankio išvestį:

Terminalas
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.

Tame pačiame pakete yra apfel-mcp-ddg-search (paieška internete), apfel-mcp-search-and-fetch ir apfel-mcp-fs (vietinio failo skaitymas). Tinka bet kuris MCP serveris: kelias iki vietinio skripto arba https:// URL.

Veikia ir įrankiai su keliais vardiniais argumentais. Štai skaičiuotuvas iš apfel saugyklos (mcp/calculator/server.py): modelis iškviečia multiply su abiem argumentais, apfel jį įvykdo, ir modelis atsako su rezultatu:

Terminalas
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.

Eilutėje tool: apfel parodo, kokį iškvietimą įvykdė. Iki apfel 1.18.0 modelis nematė argumentų pavadinimų ir juos spėliojo, todėl toks iškvietimas nepavykdavo (issue #555, ištaisyta pull request #556). Jei čia matote invalid arguments, atnaujinkite su brew upgrade apfel.

9. Pokalbis promptui išbandyti

Per 2 minutes turėsite: pokalbį terminale, kuris prisimena, ką sakėte anksčiau.

Kai rašau promptą skriptui, noriu greitai išbandyti kelis pokalbio žingsnius, kad galėčiau pamatyti, kaip modelis reaguoja, dar prieš viską automatizuodamas.

Terminalas
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.

Personą pridėsite su -s, pavyzdžiui, apfel --chat -s "You are a patient Python tutor". Kai ilgas pokalbis nebetelpa į konteksto langą, apfel pagal numatytuosius nustatymus išmeta seniausius žingsnius; kitas strategijas paaiškina konteksto vadovas. Jei norite lango su mygtukais, žr. apfel-chat.

10. Laikykite serverį veikiantį fone

Per 2 minutes turėsite: su OpenAI suderinamą serverį, kuris pasileidžia pats prisijungus ir visada laukia prievade 11434.

Kai įrankiai mano Mac kompiuteryje kasdien naudoja vietinį galinį tašką, noriu, kad jis veiktų nuolat, kad galėčiau nebeleisti jo rankomis.

Terminalas
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)

Tokie nustatymai kaip prievadas, tokenas ar MCP serveriai nurodomi aplinkos kintamaisiais, pavyzdžiui, APFEL_PORT=8080 brew services start apfel. Visi jie išvardyti foninės paslaugos vadove.

11. Programos, sukurtos su apfel

Per 2 minutes turėsite: tą patį modelį įrenginyje lange, meniu juostoje ar po klavišų kombinacija, jei programos jums mielesnės už terminalą.

Jas kuria tie patys prižiūrėtojai („apfel tree“ README faile). 2026 m. lapkričio 15 d. patikrinome, kad kiekvienas diegimo pavadinimas egzistuoja Homebrew; pačių programų šiam puslapiui netestavome.

Programa Ką ji daro Įdiegimas
apfel-chat Pokalbių programa su srautiniais atsakymais, kalba ir vaizdų analize brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Veiksmai su iškarpine meniu juostoje: santrauka, vertimas, perrašymas brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Paspauskite klavišą, paklauskite, gaukite atsakymą, uždarykite brew install Arthur-Ficial/tap/apfel-quick
apfelpad Užrašinė, kurioje DI yra formulė, įrašoma į langelį brew install Arthur-Ficial/tap/apfelpad
apfel-mcp MCP įrankiai, pritaikyti mažam konteksto langui (8 užduotis) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel su išsaugota konfigūracija ir MCP serverių sąrašu brew install Arthur-Ficial/tap/apfel-run
apfel-tag Žymos, temos ir emocijos bet kuriam per pipe perduotam tekstui brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Derinimo langas: užklausos, MCP pranešimai, kalba brew install Arthur-Ficial/tap/apfel-gui

Ribos ir sąžiningi atsakymai

apfel suteikia prieigą prie Apple modelio įrenginyje. README nurodo, kad jis turi apie 3 mlrd. parametrų, taigi yra gerokai mažesnis už debesų modelius, kuriais remiasi ChatGPT ar Claude. Jis gerai atlieka trumpas, aiškiai apibrėžtas teksto užduotis. Toliau pateikiamos ribos, į kurias atsimušėme patys arba kurias nurodo dokumentacija.

Konteksto langas mažas. Klausimas kartu su atsakymu turi tilpti į 4 096 tokenus su macOS 26 ir Mac kompiuteriuose su M1 ir M2, arba į 8 192 tokenus Mac kompiuteriuose su M3 ar naujesniu lustu ir 12 GB ar daugiau atminties, veikiančiuose su macOS 27 (README). Jūsų reikšmę parodo apfel --model-info. Paties apfel README jam per ilgas. Prieš siųsdami suskaičiuokite:

Terminalas
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 yra 4 096 tokenų langas atėmus 512 tokenų, paliekamų atsakymui. README yra apie 3 000 žodžių, bet Markdown ir kodas vienam žodžiui sunaudoja daug tokenų. Ilgus failus pateikite dalimis (head -c 6000 file), po vieną skyrių.

Jis nežino šiandienos datos. Jis ją išsigalvojo:

Terminalas
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.

Kiekvieną reikalingą faktą pateikite prompte. Interneto jis neturi, nebent prijungsite MCP įrankį.

Kartais jis klysta, ir dar labai užtikrintai. Tai jau matėte: klaidingos shell komandos 4 užduotyje, vertimas, apvertęs prasmę 2 užduotyje. Tikrinkite viską, kas svarbu.

Apple saugumo filtras gali užblokuoti nekaltą tekstą. Tada apfel sustoja su išėjimo kodu 3 ir pranešimu The request was blocked by Apple's safety guardrails. Performuluokite arba kūrybiniams tekstams ir dokumentams pridėkite --permissive; ką tai pakeičia, paaiškina guardrails dokumentas. Bandymuose šiam puslapiui į blokavimą neatsimušėme.

Kiekvieną kartą atsakymai skiriasi. Čia pateiktos tikros išvestys, kiekviena iš vieno paleidimo. Jūsų atsakymai bus suformuluoti kitaip. Norėdami labiau pasikartojančių atsakymų, naudokite --temperature 0; apfel nežada identiškos išvesties skirtingais paleidimais ar po macOS atnaujinimų (stabilumo politika).

Greitis: mūsų bandymuose dauguma atsakymų grįžo per 1-2 sekundes. Tinklalapio santrauka su MCP įrankiu užtruko 8 sekundes.

Reikalavimai griežti: tik Apple Silicon, macOS 26 ar naujesnė, įjungtas Apple Intelligence ir viena iš 15 kalbų, kurias išvardija --model-info. Intel Mac kompiuteriuose jis neveikia.

Kai kas nors nepavyksta

apfel apie problemas praneša išėjimo kodu, todėl skriptai gali į juos reaguoti. Patikrinkite jį su echo $? iškart po komandos.

Išėjimo kodas ar klaida Reikšmė Ką daryti
2 Neteisingas parametras ar parinktis Parametrai rašomi prieš promptą; juos išvardija apfel --help
3 Užklausą užblokavo Apple saugumo filtras Performuluokite arba pridėkite --permissive
4 Įvestis per ilga konteksto langui Siųskite mažiau teksto; patikrinkite su apfel --count-tokens
5 Modelis nepasiekiamas Įjunkite Apple Intelligence, palaukite, kol baigsis atsisiuntimas, suvienodinkite Mac ir Siri kalbą
6 Modelis užimtas arba pasiekta užklausų riba Palaukite ir paleiskite dar kartą arba pridėkite --retry
Connection refused Prievade 11434 neveikia joks serveris Paleiskite apfel --serve arba brew services start apfel
HTTP 501 Galinis taškas, kurio modelis įrenginyje nesiūlo (embeddings, /v1/completions) Naudokite /v1/chat/completions
piped input was empty Komanda rašė į stderr command 2>&1 \| apfel "..."

Vis dar nesiseka? Paieškokite arba sukurkite issue GitHub svetainėje.

Kas tai sukūrė ir kaip testuota

apfel yra nemokamas atvirojo kodo įrankis (MIT licencija), Franz Enzenhofer franzai projektas. Jį kartu prižiūri Arthur Ficial, Franz DI asistentas, kuris parašė ir šį vadovą. Kadangi šį puslapį parašė patys apfel kūrėjai, išvardijome kiekvieną pastebėtą nesėkmę, užuot ją nutylėję.

Kaip testavome: 2026 m. lapkričio 15 d. kiekvieną šio puslapio komandą paleidome MacBook Air M2 (24 GB) kompiuteryje su macOS 27.0.1 (build 26A434). Naudojome pasirašytą apfel 1.18.0 vykdomąjį failą iš GitHub leidimo (tą patį failą, kurį įdiegia Homebrew tap), tikroje terminalo sesijoje, o išvestį nukopijavome nepakeistą. Pirmojoje šio puslapio versijoje (2026 m. lapkričio 14 d., apfel 1.16.0) buvo matyti 8 užduoties klaida su keliais įrankio argumentais; 1.18.0 ją ištaiso, todėl šiai versijai iš naujo paleidome kiekvieną komandą. Kur pirmoji išvestis buvo klaidinga, palikome ją puslapyje ir tai pažymėjome. Pakartotinai leidome tik tam, kad rastume atsakymus, kurių nereikia redaguoti: vienoje tinklalapio santraukoje buvo ilgas brūkšnys, kurio ši svetainė nespausdina, todėl paleidome dar kartą ir palikome trečiąjį rezultatą. Kalbos pavyzdį patikrinome įrašę garsą į failą, nes bandomasis Mac neturėjo garso išvesties. Demonstracinius skriptus įrašė apfel --demos iš apfel 1.18.0.

Ką apie apfel rašė kiti: Show HN įrašas (2026 m. balandžio 3 d., 743 taškai), Better Stack vadovas, GIGAZINE straipsnis ir praktinė apžvalga danilchenko.dev svetainėje.

Šaltiniai: apfel README, CLI žinynas, diegimo vadovas, demonstraciniai skriptai, apfel ir Apple fm palyginimas ir issue sekimo sistema, skaityta 2026 m. lapkričio 15 d.