apfel je projekat.

Vodič · testirano 15. novembra 2026.

apfel AI vodič

Tvoj prvi odgovor od AI-ja koji već imaš na Macu za 60 sekundi. Zatim 11 zadataka koje dobro radi, svaki spreman za copy-paste sa stvarnim izlazom, i iskren spisak onoga što ne može.

Pravi snimak terminala, ništa nije montirano: apfel 1.18.0 na macOS 27.0.1, MacBook Air M2.
Na ovoj stranici: 15 odjeljaka
  1. Tvoj prvi odgovor za 60 sekundi
  2. 1. Pitaj Mac o njemu samom
  3. 2. Ispravi bilo koji kopirani tekst
  4. 3. Čitaj račune, PDF-ove i skripte
  5. 4. Pretvori običnu rečenicu u shell komandu
  6. 5. Dobij JSON u koji se tvoje skripte mogu pouzdati
  7. 6. Automatizuj svoj dan: git, glas i gotove skripte
  8. 7. Pokreni svoj OpenAI kod besplatno
  9. 8. Daj mu alate preko MCP-a
  10. 9. Chat za testiranje prompta
  11. 10. Neka server radi u pozadini
  12. 11. Aplikacije izgrađene na apfelu
  13. Ograničenja i iskreni odgovori
  14. Kad nešto ne radi
  15. Ko je ovo napravio i kako je testirano

Tvoj prvi odgovor za 60 sekundi

Treba ti Mac s Apple Silicon čipom (M1 ili noviji), macOS 26 Tahoe ili noviji i Apple Intelligence uključen u System Settings > Apple Intelligence & Siri. Prva dva uslova provjeriš jednom linijom:

Terminal
sw_vers -productVersion && uname -m
27.0.1
arm64

Verzija 26 ili viša i arm64 znače da si spreman. Instaliraj apfel preko Homebrewa. Bez Xcodea, bez naloga, bez API ključa:

Terminal
brew install apfel

Postavi prvo pitanje:

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.

Taj odgovor je dao Appleov model na tvom Macu. Ništa nije otišlo na server i ništa nije koštalo.

Ako ne radi: pitaj apfel je li model spreman:

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

Ako piše available: no, uključi Apple Intelligence u System Settings i sačekaj da se model preuzme (prema vodiču za instalaciju ima 3 do 4 GB). Jezik Maca i jezik Siri moraju biti isti podržani jezik. Dok model nije dostupan, apfel završava s exit kodom 5.

Dalje: zadaci ispod. Svaki počinje onim što ćeš imati nakon dvije minute.

1. Pitaj Mac o njemu samom

Za 2 minute imaš: jasne odgovore o disku, procesoru i memoriji, direktno iz komandi koje već znaš.

Kada komanda u terminalu izbaci zid brojeva, želim odgovor u jednoj rečenici, da bih mogao reagovati bez čitanja man stranice.

Pošalji bilo koju komandu kroz pipe u apfel i reci šta želiš znati:

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.

Neka ulaz bude mali: prvo head, awk i grep, pa tek onda apfel. Model odjednom čita samo nekoliko hiljada riječi, a koda još manje (vidi ograničenja).

Ako ne radi: neke komande pišu na stderr, a pipe to ne prenosi. apfel ti to i kaže: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Dalje: isti trik radi za git log, lsof, pmset -g batt, log fajlove i sve drugo što ispisuje tekst.

2. Ispravi bilo koji kopirani tekst

Za 2 minute imaš: komandu koja ispravlja gramatiku onoga što je u clipboardu, u bilo kojoj aplikaciji.

Kada napišem kratku poruku u Slacku, Mailu ili browseru, želim da je sredim bez otvaranja druge aplikacije, da bih je za par sekundi zalijepio nazad.

Kopiraj neki tekst, pa pokreni srednju liniju. pbpaste čita clipboard, pbcopy vraća rezultat u njega:

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.

Zašto "the text above": apfel stavlja tekst iz pipea na početak, a tvoju uputu iza njega (izvor). S kratkom uputom "fix grammar and spelling, reply with the corrected text only" model je odgovorio na poruku umjesto da je ispravi i napisao Could you let me know which meeting you're referring to?. Kad smo eksplicitno naveli tekst na kojem treba raditi, u našem testu je problem nestao.

Ako ne radi: pročitaj rezultat prije slanja. Mali model ponekad promijeni smisao; kad smo tražili da ovu rečenicu prevede na njemački, od "Can you send me" napravio je "Can I send you".

Dalje: stavi srednju liniju u shell alias ili u akciju "Run Shell Script" u Shortcutsu i dodijeli joj prečicu na tastaturi.

3. Čitaj račune, PDF-ove i skripte

Za 2 minute imaš: odgovore o slici, skeniranom PDF-u ili skripti, pročitane na tvom Macu uz Appleovo prepoznavanje teksta.

Kada mi u Downloads stigne račun, sken ili nepoznat fajl, želim iz njega izvući onaj jedan podatak koji mi treba, da bih ga arhivirao bez otvaranja.

Fajl dodaješ s -f. Napravili smo testnu sliku računa (receipt.png) s ovim redovima:

Izlaz
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

Isti račun sačuvan kao PDF koji sadrži samo sliku također radi, jer apfel na skeniranim stranicama pokreće prepoznavanje teksta:

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

I bilo koji tekstualni fajl, na primjer shell skripta:

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.

Tu skriptu dobijaš u zadatku 6. Više fajlova dodaješ sa -f a.txt -f b.txt.

Ako ne radi: exit kod 4 znači da je fajl predug za model (vidi ograničenja). Exit kod 3 znači da ga je blokirao Appleov sigurnosni filter; vodič za izvlačenje iz fajlova za taj slučaj predlaže dodavanje --permissive.

4. Pretvori običnu rečenicu u shell komandu

Za 2 minute imaš: komandu koje se nisi mogao sjetiti, ispisanu bez ičega viška, spremnu za kopiranje.

Kada zaboravim flagove za find, du ili tar, želim dobiti komandu iz obične rečenice, da bih ostao u terminalu.

--code ispisuje samo kod, bez objašnjenja:

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

Flagovi su tačni, ali model je izmislio folder. Tvoj home folder je ~ (dakle: 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

Pročitaj svaku komandu prije nego što je pokreneš. U našim testovima model je davao i pogrešne. Na zahtjev za "the 10 largest files in the current folder" ispisao je ls -lh | head -n 10, što prikazuje prvih 10 stavki, a ne najveće fajlove. Na "show open ports" predložio je netstat -tuln | grep LISTEN, s flagovima za Linux; na macOS-u to ne ispiše baš ništa. Na Macu ih prikazuje lsof -iTCP -sTCP:LISTEN -n -P.

Dalje: demo skripta cmd iz zadatka 6 radi upravo ovo i pita te prije nego što bilo šta pokrene (-x) ili kopira komandu (-c).

5. Dobij JSON u koji se tvoje skripte mogu pouzdati

Za 2 minute imaš: strukturirane podatke izvučene iz neurednog teksta, kao JSON koji uvijek odgovara tvojoj šemi.

Kada mi trebaju imena, brojevi ili datumi iz mailova i bilješki, želim polja, a ne prozu, da bih ih mogao proslijediti u jq, tabelu ili skriptu.

Sačuvaj JSON Schema kao contact.schema.json:

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

Zatim pošalji tekst kroz pipe sa --schema. apfel ograničava model tako da izlaz bude validan JSON za tu šemu:

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

Ključevi se vraćaju redoslijedom kojim ih tvoja šema deklariše.

Za bilo koji odgovor kao JSON s metapodacima koristi -o json:

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

Za cijeli spisak koristi --batch: na ulazu jedna JSON linija po zapisu, na izlazu jedna linija rezultata po zapisu, a svaki zapis ide u novu sesiju. Tri recenzije proizvoda u tekstualnom fajlu:

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 pretvara svaku liniju u zapis; zadnja linija je apfelov sažetak na stderr. Zapis koji ne uspije dobija status: "error", a batch se nastavlja.

Ako ne radi: apfel podržava podskup JSON Scheme (objekti, stringovi, enumi, brojevi, booleani, nizovi, lokalni $ref). Nepodržana ključna riječ kao što je pattern zaustavlja izvršavanje s exit kodom 2 i navodi je po imenu; spisak je u dokumentu o kompatibilnosti API-ja.

6. Automatizuj svoj dan: git, glas i gotove skripte

Za 2 minute imaš: sažetak svog nedavnog rada, Mac koji ti naglas javi kad je dug posao gotov i osam gotovih AI shell skripti.

Kada prelazim s jednog zadatka na drugi ili čekam build, želim male automatizacije koje objašnjavaju i javljaju stvari, da bih prestao buljiti u terminal.

Sažmi šta si radio, iz bilo kojeg git repozitorija:

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.

Neka ti Mac progovori kad nešto završi. Pošalji odgovor kroz pipe u say, a svoju dugu komandu stavi ispred sa &&:

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

Testni Mac nije imao zvučni izlaz, pa smo govor snimili u fajl (| say -o build-done.aiff, 102.880 bajta zvuka). Izgovorena rečenica bila je Your build is finished, and I'm glad you asked!.

apfel dolazi i s osam demo skripti. Upiši ih u folder:

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

Jedna koja nam se svidjela u testiranju:

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

Nije svaki demo bio dobar u našim pokušajima: oneliner "count unique IP addresses in access.log" udario je u ograničenje dužine i ispisao neispravnu komandu, a explain je dodao poruku o grešci koja nije postojala. README za demo skripte navodi svih osam.

7. Pokreni svoj OpenAI kod besplatno

Za 2 minute imaš: lokalni server koji govori OpenAI Chat Completions API, pa postojeći SDK kod radi s tvojim Macom umjesto s plaćenim cloud modelom.

Kada pravim prototip s OpenAI SDK-om, želim besplatan lokalni endpoint, da bih mogao razvijati i testirati bez ključeva, računa i slanja podataka van.

Pokreni server u jednom tabu terminala:

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

U drugom tabu pozovi ga kao OpenAI:

Terminal
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.

Zvanični OpenAI Python SDK radi bez izmjena. Razlikuju se samo base URL i ime modela. Sačuvaj kao 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 sluša samo na tvom Macu (127.0.0.1) i odbija zahtjeve s web stranica s drugih origina. Da ga otvoriš prema svojoj mreži, dodaj token: apfel --serve --host 0.0.0.0 --token-auto (vodič za sigurnost servera).

Ako ne radi: Connection refused znači da server nije pokrenut. Embeddings i stari endpoint /v1/completions vraćaju HTTP 501, jer ih model na uređaju ne nudi.

Dalje: održavaoci apfela dokumentuju podešavanja za VS Code Copilot (samo chat), opencode, Zed i Node.js, Ruby, PHP i još šest jezika. Za ovu stranicu ih nismo ponovo testirali.

8. Daj mu alate preko MCP-a

Za 2 minute imaš: model koji čita živu web stranicu i sažima je, preko alata za Model Context Protocol.

Kada je odgovor na nekoj web stranici, želim da je model sam preuzme, da bih dobio sažetak bez kopiranja teksta tamo-amo.

Instaliraj alate apfel-mcp, napravljene tako da stanu u mali kontekstni prozor:

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

Dodaj jedan sa --mcp i pitaj. -q sakriva sirovi izlaz alata:

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.

Isti paket sadrži apfel-mcp-ddg-search (pretraga weba), apfel-mcp-search-and-fetch i apfel-mcp-fs (čitanje lokalnog fajla). Radi bilo koji MCP server: putanja do lokalne skripte ili https:// URL.

Rade i alati s više imenovanih argumenata. Evo kalkulatora iz apfel repozitorija (mcp/calculator/server.py): model poziva multiply s oba argumenta, apfel ga izvršava, a model odgovara rezultatom:

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.

U liniji tool: apfel ti pokazuje poziv koji je izvršio. Prije apfela 1.18.0 model nije vidio imena argumenata i nagađao ih je, pa bi ovakav poziv pao (issue #555, ispravljeno u pull requestu #556). Ako ovdje vidiš invalid arguments, ažuriraj sa brew upgrade apfel.

9. Chat za testiranje prompta

Za 2 minute imaš: razgovor u terminalu koji pamti šta si ranije rekao.

Kada oblikujem prompt za skriptu, želim brzo isprobati nekoliko poruka, da bih vidio kako model reaguje prije nego što to automatizujem.

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.

Personu dodaješ sa -s, na primjer apfel --chat -s "You are a patient Python tutor". Kad dug razgovor preraste kontekstni prozor, apfel po defaultu izbacuje najstarije poruke; vodič za kontekst objašnjava ostale strategije. Za prozor s dugmadima pogledaj apfel-chat.

10. Neka server radi u pozadini

Za 2 minute imaš: server kompatibilan s OpenAI-jem koji se sam pokreće pri prijavi i uvijek je spreman na portu 11434.

Kada alati na mom Macu svaki dan koriste lokalni endpoint, želim da je uvijek uključen, da bih ga više ne morao pokretati ručno.

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)

Postavke kao što su port, token ili MCP serveri zadaju se varijablama okruženja, na primjer APFEL_PORT=8080 brew services start apfel. Sve su navedene u vodiču za pozadinski servis.

11. Aplikacije izgrađene na apfelu

Za 2 minute imaš: isti model na uređaju u prozoru, u traci menija ili na prečici, ako ti više odgovaraju aplikacije nego terminal.

Prave ih isti ljudi koji održavaju apfel ("drvo apfela" u README-u). Provjerili smo 15. novembra 2026. da svako ime za instalaciju postoji u Homebrewu; same aplikacije za ovu stranicu nismo testirali.

Aplikacija Šta radi Instalacija
apfel-chat Chat aplikacija sa streamingom odgovora, govorom i analizom slika brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Akcije nad clipboardom iz trake menija: sažimanje, prevođenje, preformulisanje brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Pritisneš tipku, pitaš, dobiješ odgovor, zatvoriš brew install Arthur-Ficial/tap/apfel-quick
apfelpad Bilježnica u kojoj je AI formula koju staviš u ćeliju brew install Arthur-Ficial/tap/apfelpad
apfel-mcp MCP alati prilagođeni malom prozoru (zadatak 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel sa sačuvanom konfiguracijom i spiskom MCP servera brew install Arthur-Ficial/tap/apfel-run
apfel-tag Tagovi, teme i emocije za bilo koji tekst koji pošalješ kroz pipe brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Prozor za debugovanje: zahtjevi, MCP poruke, govor brew install Arthur-Ficial/tap/apfel-gui

Ograničenja i iskreni odgovori

apfel ti daje Appleov model na uređaju. README navodi da ima oko 3 milijarde parametara, što je mnogo manje od cloud modela iza ChatGPT-ja ili Claudea. Dobar je u kratkim, fokusiranim tekstualnim zadacima. Ovo su ograničenja na koja smo naišli ili koja navodi dokumentacija.

Kontekstni prozor je mali. Pitanje i odgovor zajedno moraju stati u 4.096 tokena na macOS 26 i na Macovima s M1 i M2, odnosno u 8.192 tokena na Macovima s M3 ili novijim čipom, sa 12 GB ili više i macOS 27 (README). apfel --model-info prikazuje koliko imaš ti. Ni apfelov vlastiti README ne stane. Prebroji prije slanja:

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

Broj 3.584 je prozor od 4.096 minus 512 tokena rezervisanih za odgovor. README ima oko 3.000 riječi, ali Markdown i kod troše mnogo tokena po riječi. Duge fajlove šalji u dijelovima (head -c 6000 file), jedan po jedan odjeljak.

Ne zna današnji datum. Izmislio ga je:

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.

Svaku činjenicu koja mu treba daj mu u promptu. Nema pristup internetu osim ako ne dodaš MCP alat.

Ponekad griješi, i to samouvjereno. Vidio si to gore: pogrešne shell komande u zadatku 4, prijevod koji je izvrnuo smisao u zadatku 2. Provjeri sve što je važno.

Appleov sigurnosni filter može blokirati bezopasan tekst. apfel se tada zaustavlja s exit kodom 3 i porukom The request was blocked by Apple's safety guardrails. Preformuliši ili dodaj --permissive za kreativno pisanje i dokumente; dokument o guardrailima objašnjava šta to mijenja. U pokušajima za ovu stranicu nismo naišli na blokadu.

Odgovori se razlikuju pri svakom pokretanju. Ovo su stvarni izlazi, svaki iz jednog pokretanja. Tvoji će biti drugačije sročeni. Koristi --temperature 0 za ponovljivije odgovore; apfel ne obećava identičan izlaz između pokretanja ni između ažuriranja macOS-a (politika stabilnosti).

Brzina: većina odgovora u našim pokušajima stigla je za 1 do 2 sekunde. Sažetak web stranice s MCP alatom trajao je 8 sekundi.

Zahtjevi su strogi: samo Apple Silicon, macOS 26 ili noviji, uključen Apple Intelligence i jedan od 15 jezika koje navodi --model-info. Intel Macovi ga ne mogu pokrenuti.

Kad nešto ne radi

apfel prijavljuje probleme exit kodom, pa skripte mogu reagovati. Provjeri ga sa echo $? odmah nakon komande.

Exit kod ili greška Značenje Šta uraditi
2 Pogrešan flag ili opcija Flagovi idu ispred prompta; apfel --help ih navodi
3 Appleov sigurnosni filter je blokirao zahtjev Preformuliši ili dodaj --permissive
4 Ulaz je predug za kontekstni prozor Pošalji manje teksta; provjeri sa apfel --count-tokens
5 Model nije dostupan Uključi Apple Intelligence, sačekaj preuzimanje, uskladi jezik Maca i Siri
6 Model je zauzet ili je dostignut limit zahtjeva Sačekaj i pokreni ponovo ili dodaj --retry
Connection refused Nema servera na portu 11434 Pokreni apfel --serve ili brew services start apfel
HTTP 501 Endpoint koji model na uređaju ne nudi (embeddings, /v1/completions) Koristi /v1/chat/completions
piped input was empty Komanda je pisala na stderr command 2>&1 \| apfel "..."

I dalje ne ide? Pretraži ili otvori issue na GitHubu.

Ko je ovo napravio i kako je testirano

apfel je besplatan i open source (MIT licenca), franzai projekat Franza Enzenhofera. Održava se uz pomoć Arthura Ficiala, Franzovog AI asistenta, koji je napisao i ovaj vodič. Pošto su ovu stranicu napisali autori apfela, naveli smo svaki neuspjeh koji smo vidjeli umjesto da ga prešutimo.

Kako smo testirali: 15. novembra 2026. pokrenuli smo svaku komandu s ove stranice na MacBook Airu M2 (24 GB) s macOS 27.0.1 (build 26A434). Koristili smo potpisani binarni fajl apfel 1.18.0 iz GitHub izdanja (isti fajl koji instalira Homebrew tap), u pravoj sesiji terminala, i izlaz kopirali bez izmjena. Prva verzija ove stranice (14. novembra 2026., apfel 1.16.0) prikazivala je bug s alatima s više argumenata u zadatku 8; 1.18.0 ga ispravlja, pa smo za ovu verziju ponovo pokrenuli svaku komandu. Gdje je prvi izlaz bio pogrešan, ostavili smo pogrešan izlaz na stranici i to naglasili. Ponavljali smo samo da bismo dobili odgovore koje ne treba uređivati: jedan sažetak web stranice sadržavao je dugu crtu, koju ovaj sajt ne prikazuje, pa smo ga pokrenuli ponovo i zadržali treći pokušaj. Primjer s govorom provjeren je snimanjem zvuka u fajl, jer testni Mac nije imao zvučni izlaz. Demo skripte je napisao apfel --demos iz apfela 1.18.0.

Šta su drugi pisali o apfelu: Show HN objava (3. aprila 2026., 743 boda), vodič Better Stacka, članak GIGAZINE-a i praktična recenzija na danilchenko.dev.

Izvori: apfel README, CLI referenca, vodič za instalaciju, demo skripte, apfel naspram Appleovog fm i issue tracker, pročitano 15. novembra 2026.