apfel on -projekti.

Opas · testattu 15. marraskuuta 2026

apfelin tekoälyopas

Ensimmäinen vastaus Macissasi jo olevalta tekoälyltä 60 sekunnissa. Sen jälkeen 11 tehtävää, joissa se on hyvä, jokainen valmiina kopioitavaksi oikean tulosteen kera, sekä rehellinen lista siitä, mihin se ei pysty.

Aito terminaalitallenne, mitään ei ole editoitu: apfel 1.18.0, macOS 27.0.1, MacBook Air M2.
Tällä sivulla: 15 osiota
  1. Ensimmäinen vastaus 60 sekunnissa
  2. 1. Kysy Macilta siitä itsestään
  3. 2. Korjaa mikä tahansa kopioimasi teksti
  4. 3. Lue kuitit, PDF:t ja skriptit
  5. 4. Tavallisesta lauseesta shell-komennoksi
  6. 5. JSONia, johon skriptisi voivat luottaa
  7. 6. Automatisoi arkesi: git, puhe ja valmiit skriptit
  8. 7. Aja OpenAI-koodisi ilmaiseksi
  9. 8. Anna sille työkaluja MCP:llä
  10. 9. Testaa promptia chatissa
  11. 10. Pidä palvelin käynnissä taustalla
  12. 11. apfelin päälle rakennetut sovellukset
  13. Rajoitukset ja rehelliset vastaukset
  14. Kun jokin menee pieleen
  15. Kuka tämän teki ja miten se testattiin

Ensimmäinen vastaus 60 sekunnissa

Tarvitset Apple Silicon -Macin (M1 tai uudempi), jossa on macOS 26 Tahoe tai uudempi ja Apple Intelligence päällä kohdassa Järjestelmäasetukset > Apple Intelligence & Siri. Kaksi ensimmäistä voit tarkistaa yhdellä rivillä:

Terminaali
sw_vers -productVersion && uname -m
27.0.1
arm64

Jos versio on 26 tai suurempi ja näet arm64, olet valmis. Asenna apfel Homebrew'lla. Ei Xcodea, ei tiliä, ei API-avainta:

Terminaali
brew install apfel

Kysy ensimmäinen kysymyksesi:

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

Vastaus tuli Applen mallilta omalla Macillasi. Mitään ei lähetetty palvelimelle, eikä se maksanut mitään.

Jos se ei toimi: kysy apfelilta, onko malli valmiina:

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

Jos näet available: no, ota Apple Intelligence käyttöön Järjestelmäasetuksissa ja odota, että malli on latautunut kokonaan (asennusohjeen mukaan se vie 3-4 GB). Macin kielen ja Sirin kielen on oltava sama tuettu kieli. Niin kauan kuin malli ei ole käytettävissä, apfel päättyy exit-koodiin 5.

Seuraavaksi: alla olevat tehtävät. Jokainen alkaa siitä, mitä sinulla on kahden minuutin päästä.

1. Kysy Macilta siitä itsestään

2 minuutissa saat: selkokieliset vastaukset levystä, prosessorista ja muistista suoraan komennoista, jotka jo tunnet.

Kun terminaalikomento tulostaa seinällisen numeroita, haluan yhden rivin vastauksen, jotta voin toimia lukematta man-sivua.

Pipetä mikä tahansa komento apfelille ja kerro, mitä haluat tietää:

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

Pidä syöte pienenä: ensin head, awk ja grep, vasta sitten apfel. Malli lukee kerralla vain muutaman tuhannen sanan, koodia vielä vähemmän (katso rajoitukset).

Jos se ei toimi: jotkin komennot kirjoittavat stderriin, jota pipe ei välitä. apfel kertoo sen itse: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Seuraavaksi: sama temppu toimii komennoille git log, lsof ja pmset -g batt, lokitiedostoille ja kaikelle muulle, mikä tulostaa tekstiä.

2. Korjaa mikä tahansa kopioimasi teksti

2 minuutissa saat: komennon, joka korjaa leikepöydälläsi olevan tekstin kieliopin, sovelluksesta riippumatta.

Kun kirjoitan nopean viestin Slackiin, Mailiin tai selaimeen, haluan sen siistityksi avaamatta toista sovellusta, jotta voin liittää sen takaisin sekunneissa.

Kopioi jotain tekstiä ja aja sitten keskimmäinen rivi. pbpaste lukee leikepöydän, pbcopy kirjoittaa tuloksen takaisin:

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

Miksi ”the text above”: apfel laittaa pipetetyn tekstin ensin ja ohjeesi vasta sen perään (lähde). Lyhyellä ohjeella "fix grammar and spelling, reply with the corrected text only" malli vastasi viestiin sen korjaamisen sijaan ja kirjoitti Could you let me know which meeting you're referring to?. Kun ohjeessa nimettiin teksti, jota sen piti käsitellä, ongelma poistui testissämme.

Jos se ei toimi: lue tulos ennen kuin lähetät sen. Pieni malli muuttaa joskus merkitystä: kun pyysimme sitä kääntämään tämän lauseen saksaksi, ”Can you send me” muuttui muotoon ”Can I send you”.

Seuraavaksi: laita keskimmäinen rivi shell-aliakseksi tai Pikakomennot-sovelluksen ”Suorita shell-skripti” -toimintoon (Run Shell Script) ja anna sille pikanäppäin.

3. Lue kuitit, PDF:t ja skriptit

2 minuutissa saat: vastauksia kuvasta, skannatusta PDF:stä tai skriptistä, luettuna Macillasi Applen tekstintunnistuksella.

Kun Lataukset-kansiooni putoaa kuitti, skannaus tai tuntematon tiedosto, haluan siitä sen yhden tiedon, jota tarvitsen, jotta voin arkistoida sen avaamatta sitä.

Liitä tiedosto valitsimella -f. Teimme testiksi kuittikuvan (receipt.png), jossa on nämä rivit:

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

Sama kuitti toimii myös PDF:nä, jossa on pelkkä kuva, koska apfel ajaa skannatuille sivuille tekstintunnistuksen:

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

Samoin mikä tahansa tekstitiedosto, esimerkiksi shell-skripti:

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

Tämän skriptin saat tehtävässä 6. Useita tiedostoja liität näin: -f a.txt -f b.txt.

Jos se ei toimi: exit-koodi 4 tarkoittaa, että tiedosto on mallille liian pitkä (katso rajoitukset). Exit-koodi 3 tarkoittaa, että Applen turvasuodatin esti sen; tiedostojen lukemisen ohje neuvoo silloin lisäämään valitsimen --permissive.

4. Tavallisesta lauseesta shell-komennoksi

2 minuutissa saat: sen komennon, jota et muistanut, tulostettuna ilman selityksiä, valmiina kopioitavaksi.

Kun unohdan komentojen find, du tai tar valitsimet, haluan komennon tavallisen lauseen perusteella, jotta voin pysyä terminaalissa.

--code tulostaa pelkän koodin ilman selityksiä:

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

Valitsimet ovat oikein, mutta malli keksi kansion omasta päästään. Kotikansiosi on ~ (eli tässä: find ~ -type f -size +100M).

Terminaali
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

Lue jokainen komento ennen kuin ajat sen. Testeissämme malli tuotti myös vääriä komentoja. Kun pyysimme ”the 10 largest files in the current folder” (nykyisen kansion 10 suurinta tiedostoa), se tulosti ls -lh | head -n 10, joka listaa 10 ensimmäistä kohdetta eikä suurimpia. Pyyntöön ”show open ports” (näytä avoimet portit) se ehdotti netstat -tuln | grep LISTEN, jossa on Linuxin valitsimet; macOS:ssä se ei tulosta yhtään mitään. Macilla portit listaa lsof -iTCP -sTCP:LISTEN -n -P.

Seuraavaksi: tehtävän 6 cmd-demoskripti käärii tämän ja kysyy luvan ennen kuin ajaa mitään (-x) tai kopioi komennon (-c).

5. JSONia, johon skriptisi voivat luottaa

2 minuutissa saat: sotkuisesta tekstistä poimittua rakenteista dataa JSONina, joka vastaa aina skeemaasi.

Kun tarvitsen nimiä, numeroita tai päivämääriä sähköposteista ja muistiinpanoista, haluan kenttiä enkä proosaa, jotta voin syöttää ne jq:lle, taulukkolaskentaan tai skriptille.

Tallenna JSON Schema nimellä contact.schema.json:

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

Pipetä sitten teksti sisään valitsimen --schema kanssa. apfel rajoittaa mallia niin, että tuloste on tämän skeeman mukaista kelvollista JSONia:

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

Avaimet ovat tuloksessa samassa järjestyksessä kuin skeemassasi.

Kun haluat minkä tahansa vastauksen JSONina metatietoineen, käytä valitsinta -o json:

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

Kokonaiselle listalle käytä valitsinta --batch: sisään yksi JSON-rivi tietuetta kohden, ulos yksi tulosrivi tietuetta kohden, ja jokainen tietue käsitellään omassa tuoreessa istunnossaan. Kolme tuotearvostelua tekstitiedostossa:

Terminaali
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 tekee jokaisesta rivistä tietueen; viimeinen rivi on apfelin yhteenveto stderrissä. Epäonnistunut tietue saa arvon status: "error", ja ajo jatkuu.

Jos se ei toimi: apfel tukee JSON Scheman osajoukkoa (objektit, merkkijonot, enumit, numerot, totuusarvot, taulukot, paikallinen $ref). Tukematon avainsana, kuten pattern, pysäyttää ajon exit-koodilla 2 ja kertoo avainsanan nimen; lista löytyy API-yhteensopivuusdokumentista.

6. Automatisoi arkesi: git, puhe ja valmiit skriptit

2 minuutissa saat: yhteenvedon viimeaikaisesta työstäsi, Macin, joka kertoo ääneen, kun pitkä ajo on valmis, ja kahdeksan valmista tekoälyä käyttävää shell-skriptiä.

Kun vaihdan tehtävästä toiseen tai odotan buildia, haluan pieniä automaatioita, jotka selittävät ja ilmoittavat asioista, jotta voin lakata tuijottamasta terminaalia.

Tiivistä, mitä olet tehnyt, missä tahansa git-repositoriossa:

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

Anna Macin puhua, kun jokin valmistuu. Pipetä vastaus komennolle say ja laita pitkä komentosi sen eteen &&-merkeillä:

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

Testi-Macissa ei ollut äänilähtöä, joten tallensimme puheen sen sijaan tiedostoon (| say -o build-done.aiff, 102 880 tavua ääntä). Puhuttu lause oli Your build is finished, and I'm glad you asked!.

apfelin mukana tulee myös kahdeksan demoskriptiä. Tallenna ne kansioon:

Terminaali
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

Yksi, josta pidimme testeissä:

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

Kaikki demot eivät onnistuneet ajoissamme: oneliner "count unique IP addresses in access.log" törmäsi pituusrajaan ja tulosti rikkinäisen komennon, ja explain lisäsi virheilmoituksen, jota ei ollut olemassa. Demojen README listaa kaikki kahdeksan.

7. Aja OpenAI-koodisi ilmaiseksi

2 minuutissa saat: paikallisen palvelimen, joka puhuu OpenAI:n Chat Completions API:a, joten olemassa oleva SDK-koodi pyörii Macillasi maksullisen pilvimallin sijaan.

Kun teen prototyyppejä OpenAI SDK:lla, haluan ilmaisen paikallisen endpointin, jotta voin rakentaa ja testata ilman avaimia, laskuja tai datan lähettämistä muualle.

Käynnistä palvelin yhdessä terminaalivälilehdessä:

Terminaali
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

Kutsu sitä toisessa välilehdessä kuin OpenAI:ta:

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

Virallinen OpenAI Python SDK toimii sellaisenaan. Vain base URL ja mallin nimi ovat eri. Tallenna nimellä 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)
Terminaali
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

Palvelin kuuntelee vain omaa Maciasi (127.0.0.1) ja hylkää pyynnöt verkkosivuilta, joiden origin on jokin muu. Jos haluat avata sen lähiverkkoosi, lisää token: apfel --serve --host 0.0.0.0 --token-auto (palvelimen tietoturvaohje).

Jos se ei toimi: Connection refused tarkoittaa, ettei palvelin ole käynnissä. Embeddingit ja vanha /v1/completions-endpoint palauttavat HTTP 501 -virheen, koska laitteella toimiva malli ei tarjoa niitä.

Seuraavaksi: ylläpitäjät ovat dokumentoineet asetukset työkaluille VS Code Copilot (vain chat), opencode ja Zed sekä Node.js:lle, Rubylle, PHP:lle ja kuudelle muulle kielelle. Emme testanneet niitä uudelleen tätä sivua varten.

8. Anna sille työkaluja MCP:llä

2 minuutissa saat: mallin, joka lukee verkkosivun livenä ja tiivistää sen Model Context Protocol -työkalun avulla.

Kun vastaus löytyy verkkosivulta, haluan mallin hakevan sen itse, jotta voin saada tiivistelmän kopioimatta tekstiä paikasta toiseen.

Asenna apfel-mcp-työkalut, jotka on tehty mahtumaan pieneen konteksti-ikkunaan:

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

Liitä yksi niistä valitsimella --mcp ja kysy. -q piilottaa työkalun raakatulosteen:

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

Samassa paketissa ovat myös apfel-mcp-ddg-search (verkkohaku), apfel-mcp-search-and-fetch ja apfel-mcp-fs (paikallisen tiedoston luku). Mikä tahansa MCP-palvelin käy: paikallisen skriptin polku tai https://-URL.

Myös työkalut, joilla on useita nimettyjä argumentteja, toimivat. Tässä apfel-repositorion laskin (mcp/calculator/server.py): malli kutsuu funktiota multiply molemmilla argumenteilla, apfel ajaa sen, ja malli vastaa tuloksella:

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

tool:-rivillä apfel näyttää kutsun, jonka se ajoi. Ennen apfelin versiota 1.18.0 malli ei nähnyt argumenttien nimiä vaan arvasi ne, joten tällainen kutsu epäonnistui (issue #555, korjattu pull requestissa #556). Jos näet tässä invalid arguments, päivitä komennolla brew upgrade apfel.

9. Testaa promptia chatissa

2 minuutissa saat: terminaalissa keskustelun, joka muistaa, mitä sanoit aiemmin.

Kun muotoilen promptia skriptiä varten, haluan kokeilla nopeasti muutamaa vuoroa, jotta voin nähdä, miten malli reagoi, ennen kuin automatisoin sen.

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

Lisää persoona valitsimella -s, esimerkiksi apfel --chat -s "You are a patient Python tutor". Kun pitkä keskustelu kasvaa konteksti-ikkunaa suuremmaksi, apfel pudottaa oletuksena vanhimmat vuorot pois; kontekstiohje selittää muut strategiat. Jos haluat ikkunan painikkeineen, katso apfel-chat.

10. Pidä palvelin käynnissä taustalla

2 minuutissa saat: OpenAI-yhteensopivan palvelimen, joka käynnistyy itsestään kirjautuessasi ja on aina valmiina portissa 11434.

Kun Macini työkalut käyttävät paikallista endpointia joka päivä, haluan sen olevan aina päällä, jotta voin lakata käynnistämästä sitä käsin.

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

Asetukset, kuten portti, token tai MCP-palvelimet, annetaan ympäristömuuttujina, esimerkiksi APFEL_PORT=8080 brew services start apfel. Kaikki ne on listattu taustapalveluohjeessa.

11. apfelin päälle rakennetut sovellukset

2 minuutissa saat: saman laitteella toimivan mallin ikkunaan, valikkoriville tai pikanäppäimen taakse, jos sovellukset ovat sinulle mieluisampia kuin terminaali.

Nämä tulevat samoilta ylläpitäjiltä (”apfel tree” READMEssa). Tarkistimme 15. marraskuuta 2026, että jokainen asennusnimi löytyy Homebrew'sta; itse sovelluksia emme testanneet tätä sivua varten.

Sovellus Mitä se tekee Asennus
apfel-chat Chat-sovellus, jossa streamaavat vastaukset, puhe ja kuva-analyysi brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Leikepöydän toiminnot valikkoriviltä: tiivistä, käännä, muotoile uudelleen brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Paina näppäintä, kysy, lue vastaus, sulje brew install Arthur-Ficial/tap/apfel-quick
apfelpad Muistio, jossa tekoäly on soluun kirjoitettava kaava brew install Arthur-Ficial/tap/apfelpad
apfel-mcp Pieneen ikkunaan mitoitetut MCP-työkalut (tehtävä 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel tallennetuilla asetuksilla ja MCP-palvelinlistalla brew install Arthur-Ficial/tap/apfel-run
apfel-tag Tagit, aiheet ja tunnetilat mistä tahansa sisään pipetetystä tekstistä brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Debug-ikkuna: pyynnöt, MCP-viestit, puhe brew install Arthur-Ficial/tap/apfel-gui

Rajoitukset ja rehelliset vastaukset

apfel antaa käyttöösi Applen laitteella toimivan mallin. README arvioi sen kooksi noin 3 miljardia parametria, eli se on paljon pienempi kuin ChatGPT:n tai Clauden taustalla olevat pilvimallit. Se on hyvä lyhyissä, rajatuissa tekstitehtävissä. Tässä rajoitukset, joihin törmäsimme tai jotka dokumentaatio mainitsee.

Konteksti-ikkuna on pieni. Kysymyksen ja vastauksen on mahduttava yhteensä 4 096 tokeniin macOS 26:ssa sekä M1- ja M2-Maceissa, tai 8 192 tokeniin M3- ja uudemmissa Maceissa, joissa on vähintään 12 GB muistia ja macOS 27 (README). apfel --model-info näyttää oman Macisi arvon. apfelin oma README on sille liian pitkä. Laske ennen kuin lähetät:

Terminaali
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

Luku 3 584 on 4 096 tokenin ikkuna miinus 512 tokenia, jotka pidetään vapaana vastausta varten. READMEssa on noin 3 000 sanaa, mutta Markdown ja koodi vievät monta tokenia sanaa kohden. Syötä pitkät tiedostot osissa (head -c 6000 file), osio kerrallaan.

Se ei tiedä tämän päivän päivämäärää. Se keksi sellaisen:

Terminaali
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 promptissa kaikki tiedot, joita se tarvitsee. Sillä ei ole internetyhteyttä, ellet liitä MCP-työkalua.

Se on joskus väärässä, ja silti varma asiastaan. Näit sen jo yllä: väärät shell-komennot tehtävässä 4 ja käännös, joka käänsi merkityksen päinvastaiseksi tehtävässä 2. Tarkista kaikki, millä on väliä.

Applen turvasuodatin voi estää harmittoman tekstin. apfel pysähtyy silloin exit-koodiin 3 ja viestiin The request was blocked by Apple's safety guardrails. Muotoile uudelleen tai lisää luovaan kirjoittamiseen ja dokumentteihin --permissive; guardrail-dokumentti selittää, mitä se muuttaa. Tätä sivua varten tehdyissä ajoissa emme törmänneet yhteenkään estoon.

Vastaukset vaihtelevat joka ajolla. Nämä ovat oikeita tulosteita, kukin yhdestä ajosta. Sinun vastauksesi sanamuoto on erilainen. Käytä valitsinta --temperature 0, jos haluat toistettavampia vastauksia; apfel ei lupaa identtistä tulostetta eri ajojen tai macOS-päivitysten välillä (vakauskäytäntö).

Nopeus: useimmat vastaukset tulivat ajoissamme 1-2 sekunnissa. Verkkosivun tiivistelmä MCP-työkalulla kesti 8 sekuntia.

Vaatimukset ovat tiukat: vain Apple Silicon, macOS 26 tai uudempi, Apple Intelligence päällä ja jokin niistä 15 kielestä, jotka --model-info listaa. Intel-Maceilla se ei toimi.

Kun jokin menee pieleen

apfel ilmoittaa ongelmista exit-koodilla, joten skriptit voivat reagoida niihin. Tarkista koodi komennolla echo $? heti komennon jälkeen.

Exit-koodi tai virhe Merkitys Mitä tehdä
2 Väärä valitsin tai asetus Valitsimet tulevat ennen promptia; apfel --help listaa ne
3 Applen turvasuodatin esti pyynnön Muotoile uudelleen tai lisää --permissive
4 Syöte on liian pitkä konteksti-ikkunaan Lähetä vähemmän tekstiä; tarkista komennolla apfel --count-tokens
5 Malli ei ole käytettävissä Ota Apple Intelligence käyttöön, odota latauksen valmistumista, aseta Macille ja Sirille sama kieli
6 Malli on varattu tai pyyntöjä on rajoitettu Odota ja aja uudelleen tai lisää --retry
Connection refused Portissa 11434 ei ole palvelinta Käynnistä apfel --serve tai brew services start apfel
HTTP 501 Endpoint, jota laitteella toimiva malli ei tarjoa (embeddingit, /v1/completions) Käytä endpointia /v1/chat/completions
piped input was empty Komento kirjoitti stderriin command 2>&1 \| apfel "..."

Jäitkö jumiin? Etsi olemassa oleva issue tai avaa uusi GitHubissa.

Kuka tämän teki ja miten se testattiin

apfel on ilmainen ja avointa lähdekoodia (MIT-lisenssi), Franz Enzenhoferin franzai-projekti. Sitä ylläpidetään yhdessä Arthur Ficialin kanssa, joka on Franzin tekoälyavustaja ja kirjoitti myös tämän oppaan. Koska sivun ovat kirjoittaneet apfelin tekijät itse, listasimme jokaisen näkemämme epäonnistumisen sen sijaan, että olisimme jättäneet ne pois.

Näin testasimme: 15. marraskuuta 2026 ajoimme jokaisen tämän sivun komennon MacBook Air M2:lla (24 GB), jossa oli macOS 27.0.1 (build 26A434). Käytimme GitHub-julkaisun allekirjoitettua apfel 1.18.0 -binääriä (samaa tiedostoa, jonka Homebrew-tap asentaa) oikeassa terminaali-istunnossa ja kopioimme tulosteet muuttamattomina. Sivun ensimmäinen versio (14. marraskuuta 2026, apfel 1.16.0) näytti tehtävässä 8 bugin työkaluissa, joilla on useita argumentteja; 1.18.0 korjaa sen, joten ajoimme tätä versiota varten jokaisen komennon uudelleen. Jos ensimmäinen tuloste oli väärä, jätimme väärän tulosteen sivulle ja kerroimme siitä. Ainoat uusintaajot tehtiin, jotta löytyisi vastauksia, joita ei tarvinnut muokata: yksi verkkosivun tiivistelmä sisälsi pitkän ajatusviivan, jota tämä sivusto ei näytä, joten ajoimme sen uudelleen ja pidimme kolmannen ajon. Puhe-esimerkki tarkistettiin kirjoittamalla ääni tiedostoon, koska testi-Macissa ei ollut äänilähtöä. Demoskriptit on kirjoitettu apfel 1.18.0:n komennolla apfel --demos.

Mitä muut ovat kirjoittaneet apfelista: Show HN -julkaisu (3. huhtikuuta 2026, 743 pistettä), Better Stackin opas, GIGAZINEn artikkeli ja käytännön arvio danilchenko.dev-sivustolla.

Lähteet: apfelin README, CLI-referenssi, asennusohje, demoskriptit, apfel vs Applen fm ja issue tracker, luettu 15. marraskuuta 2026.