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.
Sellel lehel: 15 jaotist
- Esimene vastus 60 sekundiga
- 1. Küsi Macilt tema enda kohta
- 2. Paranda iga kopeeritud tekst
- 3. Loe tšekke, PDF-e ja skripte
- 4. Tavalisest lausest shellikäsk
- 5. JSON, mida su skriptid usaldada saavad
- 6. Automatiseeri oma päev: git, hääl ja valmisskriptid
- 7. Käita oma OpenAI koodi tasuta
- 8. Anna talle MCP kaudu tööriistad
- 9. Testi prompti vestluses
- 10. Hoia server taustal töös
- 11. apfelil põhinevad rakendused
- Piirangud ja ausad vastused
- Kui midagi läheb valesti
- 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:
sw_vers -productVersion && uname -m
27.0.1
arm64Kui 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:
brew install apfelEsita oma esimene küsimus:
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:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensKui 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:
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.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:
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:
CAFE APFEL
2x Melange 9.80
1x Sachertorte 7.90
1x Apfelstrudel 6.50
TOTAL EUR 24.20
14.11.2026 21:14apfel -f receipt.png "What is the total? Just the amount."
24.20Sama tšekk ainult pildina salvestatud PDF-ina töötab samuti, sest apfel käivitab skannitud lehtedel tekstituvastuse:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20Ja ka iga tekstifail, näiteks shelliskript:
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:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MVõtmed on õiged, aga kausta mõtles mudel ise välja. Sinu kodukaust on ~ (siin: find ~ -type f -size +100M).
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 resultLoe 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:
{
"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:
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:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelTerve nimekirja jaoks kasuta --batch: sisse üks JSON-rida kirje kohta, välja üks tulemusrida kirje kohta, iga kirje värskes sessioonis. Kolm tootearvustust tekstifailis:
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 failedjq -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:
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:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayTest-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:
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:
./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 pauseMeie 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:
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:11434Teises vahekaardis kutsu seda nagu OpenAI-d:
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:
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)python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew
2. CogCafé
3. Circuit SipServer 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:
brew install Arthur-Ficial/tap/apfel-mcpÜhenda üks neist võtmega --mcp ja küsi. -q peidab tööriista toorväljundi:
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:
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.
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.
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:
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: 43 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:
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.