apfel je projekt .

Vodič · testirano 15. studenoga 2026.

apfel AI vodič

Prvi odgovor AI-ja koji već imaš na Macu za 60 sekundi. Zatim 11 zadataka koje dobro obavlja, svaki spreman za kopiranje sa stvarnim izlazom, i iskren popis onoga što ne može.

Stvarna snimka terminala, ništa nije montirano: apfel 1.18.0 na macOS-u 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. Od obične rečenice do shell naredbe
  6. 5. JSON kojem tvoje skripte mogu vjerovati
  7. 6. Automatiziraj 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. Tko je ovo napravio i kako je testirano

Tvoj prvi odgovor za 60 sekundi

Trebaš Mac s Apple Siliconom (M1 ili noviji) i macOS 26 Tahoe ili noviji, a Apple Intelligence mora biti uključen u Postavkama sustava > Apple Intelligence i Siri. Prva dva uvjeta provjeriš jednim retkom:

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 računa, 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 je odgovor stigao od Appleova modela na tvom Macu. Ništa nije poslano 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 Postavkama sustava i pričekaj da se model do kraja preuzme (vodič za instalaciju navodi da 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 u nastavku. Svaki počinje onim što ćeš imati nakon dvije minute.

1. Pitaj Mac o njemu samom

Za 2 minute imaš: odgovore običnim jezikom o disku, procesoru i memoriji, izravno iz naredbi koje već poznaješ.

Kad naredba u terminalu izbaci zid brojeva, želim odgovor u jednom retku kako bih mogao reagirati bez čitanja man stranice.

Pošalji izlaz bilo koje naredbe pipeom u apfel i reci što ž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 malen: najprije head, awk i grep, a tek onda apfel. Model odjednom čita samo nekoliko tisuća riječi, a kod još manje (vidi ograničenja).

Ako ne radi: neke naredbe pišu na stderr, a to pipe 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 datoteke i sve ostalo što ispisuje tekst.

2. Ispravi bilo koji kopirani tekst

Za 2 minute imaš: naredbu koja ispravlja gramatiku onoga što je u međuspremniku, u bilo kojoj aplikaciji.

Kad na brzinu napišem poruku u Slacku, Mailu ili pregledniku, želim je dotjerati bez otvaranja druge aplikacije kako bih je za par sekundi zalijepio natrag.

Kopiraj neki tekst, a zatim pokreni srednji redak. pbpaste čita međuspremnik, 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 umjesto ispravka odgovorio na poruku: Could you let me know which meeting you're referring to?. Kad smo izričito naveli tekst na kojem treba raditi, u našem testu to je riješilo problem.

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 srednji redak u shell alias ili u akciju "Run Shell Script" u Prečacima i dodijeli joj tipkovnički prečac.

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

Za 2 minute imaš: odgovore o slici, skeniranom PDF-u ili skripti, pročitanima na tvom Macu Appleovim prepoznavanjem teksta.

Kad mi u Downloads stigne račun, sken ili nepoznata datoteka, želim iz nje izvući jedan podatak koji mi treba kako bih je razvrstao bez otvaranja.

Datoteku priložiš s -f. Napravili smo testnu sliku računa (receipt.png) s ovim recima:

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 spremljen 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 koja tekstualna datoteka, 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 dobivaš u zadatku 6. Više datoteka priložiš s -f a.txt -f b.txt.

Ako ne radi: exit kod 4 znači da je datoteka preduga za model (vidi ograničenja). Exit kod 3 znači da ju je blokirao Appleov sigurnosni filtar; vodič za izdvajanje sadržaja iz datoteka za taj slučaj predlaže dodati --permissive.

4. Od obične rečenice do shell naredbe

Za 2 minute imaš: naredbu koje se nisi mogao sjetiti, ispisanu bez ikakvog dodatnog teksta, spremnu za kopiranje.

Kad zaboravim zastavice za find, du ili tar, želim dobiti naredbu iz obične rečenice kako 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

Zastavice su točne, ali model je izmislio mapu. Tvoja početna mapa je ~ (ovdje: 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 naredbu 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. Na "show open ports" predložio je netstat -tuln | grep LISTEN, koji koristi Linuxove zastavice; na macOS-u ne ispiše baš ništa. Na Macu ih prikazuje lsof -iTCP -sTCP:LISTEN -n -P.

Dalje: demo skripta cmd u zadatku 6 omata ovo i pita prije nego što išta pokrene (-x) ili kopira naredbu (-c).

5. JSON kojem tvoje skripte mogu vjerovati

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

Kad iz e-mailova i bilješki trebam imena, brojeve ili datume, želim polja, a ne prozu, kako bih ih mogao proslijediti u jq, tablicu ili skriptu.

Spremi JSON Schemu 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 pipeom uz --schema. apfel ograničava model tako da izlaz bude valjan JSON za tu shemu:

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 deklarira tvoja shema.

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 popis koristi --batch: jedan JSON redak po zapisu na ulazu, jedan redak rezultata po zapisu na izlazu, svaki zapis u novoj sesiji. Tri recenzije proizvoda u tekstualnoj datoteci:

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 svaki redak pretvara u zapis; zadnji redak je apfelov sažetak na stderru. Zapis koji ne uspije dobiva status: "error", a batch se nastavlja.

Ako ne radi: apfel podržava podskup JSON Scheme (objekte, stringove, enume, brojeve, booleane, polja, lokalni $ref). Nepodržana ključna riječ poput pattern prekida izvođenje s exit kodom 2 i navodi o kojoj je riječ; popis je u dokumentu o kompatibilnosti API-ja.

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

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

Kad prelazim s posla na posao ili čekam build, želim male automatizacije koje objašnjavaju i najavljuju stvari kako bih prestao buljiti u terminal.

Sažmi što 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 pipeom u say, a svoju dugu naredbu stavi ispred s &&:

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

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

apfel dolazi i s osam demo skripti. Zapiši ih u mapu:

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

Nisu sve demo skripte bile dobre u našim pokretanjima: oneliner "count unique IP addresses in access.log" naišao je na ograničenje duljine i ispisao neispravnu naredbu, a explain je dodao poruku o pogreš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 na tvom Macu umjesto na plaćenom cloud modelu.

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

Pokreni server u jednoj kartici 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 drugoj kartici 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.

Službeni OpenAI Python SDK radi bez izmjena. Razlikuju se samo osnovni URL i naziv modela. Spremi 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 web stranica s drugih ishodišta. Ako ga želiš otvoriti 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. Embeddingsi i stari endpoint /v1/completions vraćaju HTTP 501, jer ih model na uređaju ne nudi.

Dalje: autori dokumentiraju postavljanje za VS Code Copilot (samo chat), opencode, Zed te Node.js, Ruby, PHP i još šest jezika. Te upute nismo ponovno testirali za ovu stranicu.

8. Daj mu alate preko MCP-a

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

Kad se odgovor nalazi na web stranici, želim da ga model sam dohvati kako bih dobio sažetak bez prebacivanja teksta amo-tamo.

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

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

Priloži jedan s --mcp i pitaj. -q skriva 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 (pretraživanje weba), apfel-mcp-search-and-fetch i apfel-mcp-fs (čitanje lokalne datoteke). 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 retku tool: apfel ti pokazuje poziv koji je izvršio. Prije apfela 1.18.0 model nije vidio nazive argumenata pa ih je pogađao, i takav poziv nije uspijevao (issue #555, ispravljeno u pull requestu #556). Ako ovdje vidiš invalid arguments, ažuriraj s brew upgrade apfel.

9. Chat za testiranje prompta

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

Kad oblikujem prompt za skriptu, želim brzo isprobati nekoliko krugova razgovora kako bih vidio kako model reagira prije nego što to automatiziram.

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š s -s, na primjer apfel --chat -s "You are a patient Python tutor". Kad dugi razgovor preraste kontekstni prozor, apfel prema zadanim postavkama izbacuje najstarije izmjene; vodič za kontekst objašnjava ostale strategije. Ako želiš prozor s gumbima, 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.

Kad alati na mom Macu svaki dan koriste lokalni endpoint, želim da stalno radi kako bih ga prestao ručno pokretati.

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 poput porta, tokena ili MCP servera 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, traci izbornika ili na prečacu, ako ti aplikacije više leže od terminala.

Dolaze od istih autora ("apfel tree" u README-u). Provjerili smo 15. studenoga 2026. da svaki naziv za instalaciju postoji u Homebrewu; same aplikacije za ovu stranicu nismo testirali.

Aplikacija Što radi Instalacija
apfel-chat Chat aplikacija sa streamanjem odgovora, govorom i analizom slika brew install Arthur-Ficial/tap/apfel-chat
apfel-clip Akcije nad međuspremnikom iz trake izbornika: sažmi, prevedi, preformuliraj brew install Arthur-Ficial/tap/apfel-clip
apfel-quick Pritisni tipku, pitaj, dobij odgovor, zatvori brew install Arthur-Ficial/tap/apfel-quick
apfelpad Bilježnica u kojoj je AI formula koju upišeš 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 spremljenom konfiguracijom i popisom MCP servera brew install Arthur-Ficial/tap/apfel-run
apfel-tag Oznake, teme i emocije za bilo koji tekst poslan pipeom brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Prozor za debugiranje: 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 ga procjenjuje na oko 3 milijarde parametara, što je mnogo manje od cloud modela iza ChatGPT-a 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 malen. Pitanje i odgovor zajedno moraju stati u 4.096 tokena na macOS-u 26 i na Macovima s M1 i M2, odnosno u 8.192 tokena na Macovima s M3 ili novijim čipom i 12 GB ili više uz macOS 27 (README). apfel --model-info pokazuje koliko imaš ti. Ni apfelov README u njega 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 umanjen za 512 tokena koji ostaju slobodni za odgovor. README ima oko 3.000 riječi, ali Markdown i kod troše mnogo tokena po riječi. Duge datoteke šalji u dijelovima (head -c 6000 file), odjeljak po 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 priložiš MCP alat.

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

Appleov sigurnosni filtar može blokirati bezazlen tekst. apfel se tada zaustavlja s exit kodom 3 i porukom The request was blocked by Apple's safety guardrails. Preformuliraj ili dodaj --permissive za kreativno pisanje i dokumente; dokument o zaštitnim ogradama objašnjava što to mijenja. U pokretanjima za ovu stranicu nismo naišli na blokadu.

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

Brzina: većina odgovora u našim pokretanjima stigla je za 1 do 2 sekunde. Sažetak web stranice uz MCP alat 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. Intelovi Macovi ga ne mogu pokrenuti.

Kad nešto ne radi

apfel javlja probleme exit kodom, pa skripte mogu reagirati. Provjeri ga s echo $? odmah nakon naredbe.

Exit kod ili pogreška Značenje Što učiniti
2 Pogrešna zastavica ili opcija Zastavice idu ispred prompta; apfel --help ih sve navodi
3 Appleov sigurnosni filtar blokirao je zahtjev Preformuliraj ili dodaj --permissive
4 Ulaz je predug za kontekstni prozor Pošalji manje teksta; provjeri s apfel --count-tokens
5 Model nije dostupan Uključi Apple Intelligence, pričekaj preuzimanje, uskladi jezik Maca i Siri
6 Model je zauzet ili je dosegnuto ograničenje broja zahtjeva Pričekaj i pokreni ponovno ili dodaj --retry
Connection refused Na portu 11434 nema servera Pokreni apfel --serve ili brew services start apfel
HTTP 501 Endpoint koji model na uređaju ne nudi (embeddingsi, /v1/completions) Koristi /v1/chat/completions
piped input was empty Naredba je pisala na stderr command 2>&1 \| apfel "..."

I dalje zapelo? Pretraži issueje ili otvori novi na GitHubu.

Tko je ovo napravio i kako je testirano

apfel je besplatan i open source (MIT licenca), projekt franzai koji je pokrenuo Franz Enzenhofer. Franz ga održava zajedno s Arthurom Ficialom, Franzovim AI asistentom, koji je napisao i ovaj vodič. Budući da su ovu stranicu napisali autori apfela, naveli smo svaku pogrešku koju smo vidjeli umjesto da ih prešutimo.

Kako smo testirali: 15. studenoga 2026. pokrenuli smo svaku naredbu s ove stranice na MacBooku Air M2 (24 GB) s macOS-om 27.0.1 (build 26A434). Koristili smo potpisanu binarnu datoteku apfel 1.18.0 iz izdanja na GitHubu (istu datoteku koju instalira Homebrew tap), u stvarnoj sesiji terminala, i izlaz kopirali bez izmjena. Prva verzija ove stranice (14. studenoga 2026., apfel 1.16.0) prikazivala je pogrešku s alatima s više argumenata u zadatku 8; 1.18.0 je ispravlja, pa smo za ovu verziju ponovno pokrenuli svaku naredbu. Kad je prvi izlaz bio pogrešan, ostavili smo ga na stranici i to naveli. Ponovna pokretanja služila su samo tome da pronađemo odgovore koje nije trebalo uređivati: jedan sažetak web stranice sadržavao je dugu crticu, koju ova stranica ne ispisuje, pa smo ga pokrenuli ponovno i zadržali treće pokretanje. Primjer s govorom provjeren je snimanjem zvuka u datoteku, jer testni Mac nije imao izlaz za zvuk. Demo skripte zapisao je apfel --demos iz apfela 1.18.0.

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

Izvori: apfel README, referenca za CLI, vodič za instalaciju, demo skripte, apfel naspram Appleova fm i praćenje issueja, pročitano 15. studenoga 2026.