apfel on projekt.

Juhend · testitud 15. novembril 2026

apfeli AI-juhend

Esimene vastus AI-lt, mis on sinu Macis juba olemas, 60 sekundiga. Siis 11 tööd, millega see hästi hakkama saab, igaüks kopeerimiseks valmis ja päris väljundiga, ning aus nimekiri sellest, mida see ei suuda.

Päris terminalisalvestus, midagi pole kärbitud: apfel 1.18.0, macOS 27.0.1, MacBook Air M2.
Sellel lehel: 15 jaotist
  1. Esimene vastus 60 sekundiga
  2. 1. Küsi Macilt tema enda kohta
  3. 2. Paranda iga kopeeritud tekst
  4. 3. Loe tšekke, PDF-e ja skripte
  5. 4. Tavalisest lausest shellikäsk
  6. 5. JSON, mida su skriptid usaldada saavad
  7. 6. Automatiseeri oma päev: git, hääl ja valmisskriptid
  8. 7. Käita oma OpenAI koodi tasuta
  9. 8. Anna talle MCP kaudu tööriistad
  10. 9. Testi prompti vestluses
  11. 10. Hoia server taustal töös
  12. 11. apfelil põhinevad rakendused
  13. Piirangud ja ausad vastused
  14. Kui midagi läheb valesti
  15. Kes selle tegi ja kuidas seda testiti

Esimene vastus 60 sekundiga

Vajad Apple Siliconiga Maci (M1 või uuem), macOS 26 Tahoe või uuemat ning sisse lülitatud Apple Intelligence'it (System Settings > Apple Intelligence & Siri). Kaks esimest saad kontrollida ühe reaga:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Kui versioon on 26 või suurem ja näed arm64, oled valmis. Paigalda apfel Homebrew abil. Pole vaja Xcode'i, kontot ega API-võtit:

Terminal
brew install apfel

Esita oma esimene küsimus:

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.

See vastus tuli Apple'i mudelilt sinu enda Macis. Serverisse ei saadetud midagi ja see ei maksnud sentigi.

Kui see ei tööta: küsi apfelilt, kas mudel on valmis:

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

Kui seal on available: no, lülita System Settingsis sisse Apple Intelligence ja oota, kuni mudel on lõpuni alla laaditud (paigaldusjuhendi järgi on see 3 kuni 4 GB). Maci keel ja Siri keel peavad olema sama toetatud keel. Seni kuni mudel pole saadaval, lõpetab apfel väljumiskoodiga 5.

Edasi: allolevad tööd. Iga töö algab sellega, mis sul kahe minuti pärast olemas on.

1. Küsi Macilt tema enda kohta

2 minutiga on sul olemas: tavakeelsed vastused ketta, protsessori ja mälu kohta otse käskudest, mida sa juba tunned.

Kui terminalikäsk paiskab ekraanile numbrite seina, tahan saada üherealise vastuse, et saaksin tegutseda ilma man-lehte lugemata.

Suuna mis tahes käsu väljund toruga apfelisse ja ütle, mida teada tahad:

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.

Hoia sisend väike: kõigepealt head, awk ja grep, siis apfel. Mudel loeb korraga vaid mõni tuhat sõna, koodi puhul veel vähem (vaata piiranguid).

Kui see ei tööta: mõned käsud kirjutavad stderr'i, mida toru edasi ei kanna. apfel ütleb selle sulle ise: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Edasi: sama nipp töötab ka git log, lsof, pmset -g batt, logifailide ja kõige muuga, mis teksti väljastab.

2. Paranda iga kopeeritud tekst

2 minutiga on sul olemas: käsk, mis parandab lõikelaual oleva teksti grammatika, ükskõik millises rakenduses.

Kui kirjutan Slackis, Mailis või brauseris kiire sõnumi, tahan selle korda teha ilma teist rakendust avamata, et saaksin selle mõne sekundiga tagasi kleepida.

Kopeeri mingi tekst ja käivita keskmine rida. pbpaste loeb lõikelauda, pbcopy kirjutab tulemuse sinna tagasi:

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.

Miks "the text above": apfel paneb torust tulnud teksti ette ja sinu juhise selle järele (lähtekood). Lühikese juhisega "fix grammar and spelling, reply with the corrected text only" vastas mudel sõnumile, selle asemel et seda parandada, ja kirjutas Could you let me know which meeting you're referring to?. Kui juhises oli nimetatud tekst, millega töötada, kadus see probleem meie testis.

Kui see ei tööta: loe tulemus enne saatmist läbi. Väike mudel muudab vahel tähendust: kui palusime tal see lause saksa keelde tõlkida, tegi ta "Can you send me" asemel "Can I send you".

Edasi: pane keskmine rida shelli aliasesse või Shortcutsi toimingusse "Run Shell Script" ja määra sellele kiirklahv.

3. Loe tšekke, PDF-e ja skripte

2 minutiga on sul olemas: vastused pildi, skannitud PDF-i või skripti kohta, loetud sinu Macis Apple'i tekstituvastusega.

Kui Downloads-kausta jõuab tšekk, skaneering või tundmatu fail, tahan sellest kätte saada just selle ühe fakti, mida vajan, et saaksin selle avamata ära arhiveerida.

Lisa fail võtmega -f. Tegime testiks tšekipildi (receipt.png) järgmiste ridadega:

Väljund
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

Sama tšekk ainult pildina salvestatud PDF-ina töötab samuti, sest apfel käivitab skannitud lehtedel tekstituvastuse:

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

Ja ka iga tekstifail, näiteks shelliskript:

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.

Selle skripti saad töös 6. Mitu faili lisad nii: -f a.txt -f b.txt.

Kui see ei tööta: väljumiskood 4 tähendab, et fail on mudeli jaoks liiga pikk (vaata piiranguid). Väljumiskood 3 tähendab, et Apple'i turvafilter blokeeris selle; failidest teksti eraldamise juhend soovitab sel juhul lisada --permissive.

4. Tavalisest lausest shellikäsk

2 minutiga on sul olemas: käsk, mida sa ei mäletanud, ilma lisajututa, nii et saad selle kohe kopeerida.

Kui ma ei mäleta käskude find, du või tar võtmeid, tahan saada käsu tavalise lause põhjal, et saaksin terminalist lahkumata edasi töötada.

--code väljastab ainult koodi, ilma selgituseta:

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

Võtmed on õiged, aga kausta mõtles mudel ise välja. Sinu kodukaust on ~ (siin: 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

Loe iga käsk enne käivitamist läbi. Meie testides andis mudel ka valesid käske. Kui küsisime "the 10 largest files in the current folder", väljastas see ls -lh | head -n 10, mis näitab esimest 10 kirjet, mitte suurimaid. Palvele "show open ports" pakkus see netstat -tuln | grep LISTEN, mis kasutab Linuxi võtmeid; macOS-is ei väljasta see üldse midagi. Macis näitab neid lsof -iTCP -sTCP:LISTEN -n -P.

Edasi: töö 6 demoskript cmd teeb sama ja küsib enne, kui midagi käivitab (-x) või käsu kopeerib (-c).

5. JSON, mida su skriptid usaldada saavad

2 minutiga on sul olemas: segasest tekstist välja võetud struktureeritud andmed JSON-ina, mis vastab alati sinu skeemile.

Kui vajan e-kirjadest ja märkmetest nimesid, numbreid või kuupäevi, tahan saada välju, mitte proosat, et saaksin need anda edasi jq-le, tabelarvutusse või skriptile.

Salvesta JSON Schema failina contact.schema.json:

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

Seejärel suuna tekst toruga sisse koos võtmega --schema. apfel piirab mudelit nii, et väljund on selle skeemi järgi kehtiv 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"
}

Võtmed tulevad tagasi selles järjekorras, nagu sinu skeem need deklareerib.

Kui tahad mis tahes vastust metaandmetega JSON-ina, kasuta -o json:

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

Terve nimekirja jaoks kasuta --batch: sisse üks JSON-rida kirje kohta, välja üks tulemusrida kirje kohta, iga kirje värskes sessioonis. Kolm tootearvustust tekstifailis:

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 teeb igast reast kirje; viimane rida on apfeli kokkuvõte stderr'is. Ebaõnnestunud kirje saab status: "error" ja partii töötlemine jätkub.

Kui see ei tööta: apfel toetab JSON Schema alamhulka (objektid, sõned, enumid, arvud, tõeväärtused, massiivid, lokaalne $ref). Toetamata märksõna, näiteks pattern, peatab töö väljumiskoodiga 2 ja apfel nimetab selle; nimekiri on API ühilduvuse dokumendis.

6. Automatiseeri oma päev: git, hääl ja valmisskriptid

2 minutiga on sul olemas: kokkuvõte sinu viimasest tööst, Mac, mis ütleb valjult, kui pikk töö on valmis, ja kaheksa valmis AI-shelliskripti.

Kui vahetan ülesannet või ootan, kuni build valmis saab, tahan väikseid automatiseeringuid, mis asju selgitavad ja teada annavad, et ma ei peaks terminali jõllitama.

Võta oma tehtud töö kokku ükskõik millise git-repositooriumi seest:

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.

Lase Macil rääkida, kui midagi valmis saab. Suuna vastus toruga käsku say ja pane oma pikk käsk selle ette koos &&-ga:

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

Test-Macil polnud heliväljundit, seega salvestasime kõne hoopis faili (| say -o build-done.aiff, 102 880 baiti heli). Lause, mille ta ütles, oli Your build is finished, and I'm glad you asked!.

apfeliga on kaasas ka kaheksa demoskripti. Kirjuta need kausta:

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

Üks, mis meile testides meeldis:

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

Meie katsetes polnud iga demo hea: oneliner "count unique IP addresses in access.log" jooksis pikkusepiirangusse kinni ja väljastas katkise käsu ning explain lisas veateate, mida tegelikult polnud. Demode README loetleb kõik kaheksa.

7. Käita oma OpenAI koodi tasuta

2 minutiga on sul olemas: kohalik server, mis räägib OpenAI Chat Completions API keelt, nii et olemasolev SDK-kood töötab tasulise pilvemudeli asemel sinu Maci vastu.

Kui teen OpenAI SDK-ga prototüüpe, tahan tasuta kohalikku otspunkti, et saaksin ehitada ja testida ilma võtmete, arvete ja andmete väljasaatmiseta.

Käivita server ühes terminali vahekaardis:

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

Teises vahekaardis kutsu seda nagu OpenAI-d:

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.

Ametlik OpenAI Pythoni SDK töötab muutmata kujul. Erinevad ainult baas-URL ja mudeli nimi. Salvesta failina 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

Server kuulab ainult sinu enda Macis (127.0.0.1) ega võta vastu päringuid teise päritoluga (origin) veebilehtedelt. Kui tahad selle oma võrgule avada, lisa token: apfel --serve --host 0.0.0.0 --token-auto (serveri turvajuhend).

Kui see ei tööta: Connection refused tähendab, et server ei tööta. Embeddingud ja vana otspunkt /v1/completions tagastavad HTTP 501, sest seadmesisene mudel neid ei paku.

Edasi: arendajad on dokumenteerinud seadistused VS Code Copiloti (ainult vestlus), opencode'i, Zedi ning Node.js-i, Ruby, PHP ja veel kuue keele jaoks. Neid me selle lehe jaoks uuesti ei testinud.

8. Anna talle MCP kaudu tööriistad

2 minutiga on sul olemas: mudel, mis loeb Model Context Protocol tööriista kaudu päris veebilehte ja võtab selle kokku.

Kui vastus on veebilehel, tahan, et mudel selle ise kätte tooks, et saaksin kokkuvõtte ilma teksti edasi-tagasi kopeerimata.

Paigalda apfel-mcp tööriistad, mis on ehitatud väikesesse kontekstiaknasse mahtuma:

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

Ühenda üks neist võtmega --mcp ja küsi. -q peidab tööriista toorväljundi:

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.

Samas paketis on ka apfel-mcp-ddg-search (veebiotsing), apfel-mcp-search-and-fetch ja apfel-mcp-fs (loeb kohalikku faili). Töötab iga MCP-server: kohaliku skripti tee või https:// URL.

Töötavad ka mitme nimelise argumendiga tööriistad. Siin on apfeli repositooriumi kalkulaator (mcp/calculator/server.py): mudel kutsub välja multiply mõlema argumendiga, apfel käivitab selle ja mudel vastab tulemusega:

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.

Rida tool: näitab sulle kutset, mille apfel käivitas. Enne apfeli versiooni 1.18.0 ei näinud mudel argumentide nimesid ja arvas need ära, nii et selline kutse ebaõnnestus (issue #555, parandatud pull requestiga #556). Kui näed siin invalid arguments, uuenda käsuga brew upgrade apfel.

9. Testi prompti vestluses

2 minutiga on sul olemas: vestlus terminalis, mis mäletab, mida sa varem ütlesid.

Kui viimistlen skripti jaoks prompti, tahan kiiresti paar käiku läbi proovida, et saaksin näha, kuidas mudel reageerib, enne kui selle automatiseerin.

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.

Rolli saad mudelile anda võtmega -s, näiteks apfel --chat -s "You are a patient Python tutor". Kui pikk vestlus kontekstiaknast välja kasvab, viskab apfel vaikimisi välja vanimad käigud; kontekstijuhend selgitab teisi strateegiaid. Nuppudega akna jaoks vaata apfel-chat.

10. Hoia server taustal töös

2 minutiga on sul olemas: OpenAI-ühilduv server, mis käivitub sisselogimisel ise ja on pordil 11434 alati valmis.

Kui minu Maci tööriistad kasutavad kohalikku otspunkti iga päev, tahan, et see oleks alati sees, et saaksin lõpetada selle käsitsi käivitamise.

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)

Seaded nagu port, token või MCP-serverid on keskkonnamuutujad, näiteks APFEL_PORT=8080 brew services start apfel. Kõik need on loetletud taustateenuse juhendis.

11. apfelil põhinevad rakendused

2 minutiga on sul olemas: sama seadmesisene mudel aknas, menüüribal või kiirklahvi all, kui eelistad terminalile rakendusi.

Need tulevad samadelt arendajatelt ("apfel tree" README-s). Kontrollisime 15. novembril 2026, et iga paigaldusnimi on Homebrew's olemas; rakendusi me selle lehe jaoks ei testinud.

Rakendus Mida see teeb Paigaldus
apfel-chat Vestlusrakendus voogedastatud vastuste, kõne ja pildianalüüsiga brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Menüüriba toimingud lõikelaua sisuga: kokkuvõte, tõlge, ümbersõnastus brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Vajuta klahvi, küsi, saa vastus, sulge brew install Arthur-Ficial/tap/apfel-quick
apfelpad Märkmik, kus AI on valem, mille paned lahtrisse brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Väikese akna jaoks mõõdetud MCP-tööriistad (töö 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel salvestatud seadistuse ja MCP-serverite nimekirjaga brew install Arthur-Ficial/tap/apfel-run
apfel-tag Sildid, teemad ja emotsioonid mis tahes toruga sisse suunatud tekstile brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Silumisaken: päringud, MCP-sõnumid, kõne brew install Arthur-Ficial/tap/apfel-gui

Piirangud ja ausad vastused

apfel annab sulle Apple'i seadmesisese mudeli. README hindab selle suuruseks umbes 3 miljardit parameetrit, mis on palju väiksem kui ChatGPT või Claude'i taga olevad pilvemudelid. See on hea lühikeste ja selgelt piiritletud tekstitööde jaoks. Siin on piirangud, millega me kokku puutusime või mida dokumentatsioon mainib.

Kontekstiaken on väike. Küsimus koos vastusega peab mahtuma 4 096 tokenisse macOS 26-ga ning M1 ja M2 Macidel, või 8 192 tokenisse M3 või uuematel vähemalt 12 GB mäluga Macidel, millel töötab macOS 27 (README). apfel --model-info näitab, milline on sinu oma. apfeli enda README on selle jaoks liiga pikk. Loenda enne saatmist:

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 on 4 096-tokenine aken miinus 512 tokenit, mis jäetakse vastuse jaoks vabaks. README-s on umbes 3 000 sõna, aga Markdown ja kood maksavad sõna kohta palju tokeneid. Anna pikad failid ette osade kaupa (head -c 6000 file), üks jaotis korraga.

See ei tea tänast kuupäeva. Mudel mõtles selle välja:

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.

Anna promptis kaasa iga fakt, mida see vajab. Internetti tal pole, kui sa just MCP-tööriista ei ühenda.

See eksib vahel, ja seda enesekindlalt. Nägid seda eespool: valed shellikäsud töös 4, tõlge, mis keeras tähenduse ümber, töös 2. Kontrolli kõike, mis on oluline.

Apple'i turvafilter võib blokeerida ka süütut teksti. Siis peatub apfel väljumiskoodiga 3 ja teatega The request was blocked by Apple's safety guardrails. Sõnasta ümber või lisa loomingulise kirjutamise ja dokumentide puhul --permissive; guardrails-dokument selgitab, mida see muudab. Selle lehe katsetes me blokeeringut ei kohanud.

Vastused erinevad igal käivitusel. Need on päris väljundid, igaüks ühest käivitusest. Sinu omad on teistmoodi sõnastatud. Korratavamate vastuste jaoks kasuta --temperature 0; apfel ei luba identset väljundit eri käivitustel ega macOS-i uuenduste järel (stabiilsuspõhimõtted).

Kiirus: enamik vastuseid tuli meie katsetes 1 kuni 2 sekundiga. Veebilehe kokkuvõte MCP-tööriistaga võttis aega 8 sekundit.

Nõuded on ranged: ainult Apple Silicon, macOS 26 või uuem, Apple Intelligence sees ja üks 15 keelest, mida --model-info loetleb. Inteli Macidel see ei tööta.

Kui midagi läheb valesti

apfel annab probleemidest teada väljumiskoodiga, nii et skriptid saavad reageerida. Kontrolli seda kohe pärast käsku käsuga echo $?.

Väljumiskood või viga Tähendus Mida teha
2 Vale võti või valik Võtmed käivad enne prompti; apfel --help loetleb need
3 Apple'i turvafilter blokeeris päringu Sõnasta ümber või lisa --permissive
4 Sisend on kontekstiakna jaoks liiga pikk Saada vähem teksti; kontrolli käsuga apfel --count-tokens
5 Mudel pole saadaval Lülita sisse Apple Intelligence, oota allalaadimise lõppu, sea Maci ja Siri keel samaks
6 Mudel on hõivatud või päringute arv on piiratud Oota ja käivita uuesti või lisa --retry
Connection refused Pordil 11434 pole serverit Käivita apfel --serve või brew services start apfel
HTTP 501 Otspunkt, mida seadmesisene mudel ei paku (embeddingud, /v1/completions) Kasuta /v1/chat/completions
piped input was empty Käsk kirjutas stderr'i command 2>&1 \| apfel "..."

Ikka jänni jäänud? Otsi või ava issue GitHubis.

Kes selle tegi ja kuidas seda testiti

apfel on tasuta ja avatud lähtekoodiga (MIT-litsents), Franz Enzenhoferi franzai projekt. Seda arendatakse koos Arthur Ficialiga, Franzi AI-assistendiga, kes kirjutas ka selle juhendi. Kuna selle lehe kirjutasid apfeli tegijad ise, loetlesime iga nähtud ebaõnnestumise, selle asemel et neid välja jätta.

Kuidas me testisime: 15. novembril 2026 käivitasime iga sellel lehel oleva käsu MacBook Air M2-s (24 GB) macOS 27.0.1-ga (build 26A434). Kasutasime GitHubi väljalaskest pärit allkirjastatud apfel 1.18.0 binaari (sama faili, mille paigaldab Homebrew tap), päris terminalisessioonis, ja kopeerisime väljundi muutmata kujul. Selle lehe esimene versioon (14. november 2026, apfel 1.16.0) näitas töös 8 mitme argumendiga tööriistade viga; 1.18.0 parandab selle, seega käivitasime selle versiooni jaoks iga käsu uuesti. Kui esimene väljund oli vale, jätsime vale väljundi lehele ja ütlesime seda. Ainsad kordused tehti, et leida vastused, mis ei vajanud muutmist: ühes veebilehe kokkuvõttes oli pikk mõttekriips, mida see sait ei kuva, seega käivitasime selle uuesti ja jätsime alles kolmanda käivituse tulemuse. Kõnenäidet kontrolliti heli faili kirjutamisega, sest test-Macil polnud heliväljundit. Demoskriptid kirjutas apfel 1.18.0 käsk apfel --demos.

Mida teised on apfelist kirjutanud: Show HN postitus (3. aprill 2026, 743 punkti), Better Stacki juhend, GIGAZINE'i artikkel ja praktiline arvustus saidil danilchenko.dev.

Allikad: apfeli README, CLI teatmik, paigaldusjuhend, demoskriptid, apfel vs Apple'i fm ja issue tracker, loetud 15. novembril 2026.