Vodič · testirano 15. novembra 2026.
apfel AI vodič
Prvi odgovor od AI-ja koji tvoj Mac već ima, za 60 sekundi. Zatim 11 zadataka koje dobro obavlja, svaki spreman za copy-paste sa stvarnim izlazom, i iskren spisak onoga što ne ume.
Na ovoj stranici: 15 odeljaka
- Prvi odgovor za 60 sekundi
- 1. Pitaj Mac o njemu samom
- 2. Ispravi bilo koji kopirani tekst
- 3. Čitaj račune, PDF-ove i skripte
- 4. Od obične rečenice do shell komande
- 5. JSON kome tvoje skripte mogu da veruju
- 6. Automatizuj svoj dan: git, glas i gotove skripte
- 7. Pokreni svoj OpenAI kod besplatno
- 8. Daj mu alate preko MCP-a
- 9. Chat za testiranje prompta
- 10. Server stalno radi u pozadini
- 11. Aplikacije zasnovane na apfel-u
- Ograničenja i iskreni odgovori
- Kad nešto ne radi
- Ko je ovo napravio i kako je testirano
Prvi odgovor za 60 sekundi
Treba ti Mac sa Apple Silicon čipom (M1 ili noviji), macOS 26 Tahoe ili noviji i uključen Apple Intelligence u System Settings > Apple Intelligence & Siri. Prva dva uslova proveravaš jednom linijom:
sw_vers -productVersion && uname -m
27.0.1
arm64Verzija 26 ili viša i arm64 znače da si spreman. Instaliraj apfel preko Homebrew-a. Bez Xcode-a, bez naloga, bez API ključa:
brew install apfelPostavi prvo pitanje:
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 Apple-ov model na tvom Mac-u. Ništa nije poslato na server i nije te koštalo ni dinara.
Ako ne radi: pitaj apfel da li je model spreman:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensAko piše available: no, uključi Apple Intelligence u System Settings i sačekaj da se model preuzme do kraja (prema vodiču za instalaciju ima 3 do 4 GB). Jezik Mac-a i jezik Siri moraju biti isti, i to jedan od podržanih. Dok model nije dostupan, apfel izlazi sa kodom 5.
Dalje: zadaci ispod. Svaki počinje onim što ćeš imati posle dva minuta.
1. Pitaj Mac o njemu samom
Za 2 minuta imaš: jasne odgovore o disku, procesoru i memoriji, direktno iz komandi koje već znaš.
Kad komanda u terminalu izbaci gomilu brojeva, želim odgovor u jednoj rečenici, da bih mogao da reagujem bez čitanja man stranice.
Prosledi bilo koju komandu pipe-om u apfel i reci šta želiš da saznaš:
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.Neka ulaz bude mali: prvo head, awk i grep, pa tek onda apfel. Model odjednom čita samo nekoliko hiljada reči, a kad je u pitanju kod, 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 ostalo što ispisuje tekst.
2. Ispravi bilo koji kopirani tekst
Za 2 minuta imaš: komandu koja ispravlja gramatiku svega što je u clipboard-u, u bilo kojoj aplikaciji.
Kad na brzinu napišem poruku u Slack-u, Mail-u ili browseru, želim da je sredim bez otvaranja druge aplikacije, da bih je za par sekundi nalepio nazad.
Kopiraj neki tekst, pa pokreni srednju liniju. pbpaste čita clipboard, pbcopy upisuje rezultat nazad:
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 pipe-a na početak, a tvoje uputstvo posle njega (izvor). Sa kratkim uputstvom "fix grammar and spelling, reply with the corrected text only" model je odgovorio na poruku umesto da je ispravi i napisao Could you let me know which meeting you're referring to?. Kad smo mu naveli na kom tekstu treba da radi, u našem testu je to rešeno.
Ako ne radi: pročitaj rezultat pre slanja. Mali model ponekad promeni smisao; kad smo tražili da ovu rečenicu prevede na nemački, "Can you send me" je pretvorio u "Can I send you".
Dalje: stavi srednju liniju u shell alias ili u Shortcuts akciju "Run Shell Script" i dodeli joj prečicu na tastaturi.
3. Čitaj račune, PDF-ove i skripte
Za 2 minuta imaš: odgovore o slici, skeniranom PDF-u ili skripti, pročitane na tvom Mac-u pomoću Apple-ovog prepoznavanja teksta.
Kad mi u Downloads stigne račun, sken ili nepoznat fajl, želim jedan podatak koji mi treba iz njega, da bih ga arhivirao bez otvaranja.
Fajl prilažeš sa -f. Napravili smo test sliku računa (receipt.png) sa ovim linijama:
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.20Isti račun sačuvan kao PDF koji sadrži samo sliku takođe radi, jer apfel na skeniranim stranicama pokreće prepoznavanje teksta:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20Kao i bilo koji tekstualni fajl, na primer shell skripta:
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 prilažeš sa -f a.txt -f b.txt.
Ako ne radi: exit kod 4 znači da je fajl predugačak za model (vidi ograničenja). Exit kod 3 znači da ga je blokirao Apple-ov bezbednosni filter; vodič za izdvajanje teksta iz fajlova za taj slučaj predlaže da dodaš --permissive.
4. Od obične rečenice do shell komande
Za 2 minuta imaš: komandu koje nisi mogao da se setiš, ispisanu bez ikakvog objašnjenja, spremnu za kopiranje.
Kad zaboravim flagove za find, du ili tar, želim komandu iz obične rečenice, da bih ostao u terminalu.
--code ispisuje samo kod, bez objašnjenja:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MFlagovi su tačni, ali je model izmislio fasciklu. Tvoja početna fascikla je ~ (ovde: 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 resultPročitaj svaku komandu pre nego što je pokreneš. U našim testovima model je davao i pogrešne. Kad smo tražili "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, sa flagovima za Linux; na macOS-u to ne ispiše baš ništa. Na Mac-u ih prikazuje lsof -iTCP -sTCP:LISTEN -n -P.
Dalje: demo skripta cmd iz zadatka 6 radi ovo isto i pita te pre nego što bilo šta pokrene (-x) ili kopira komandu (-c).
5. JSON kome tvoje skripte mogu da veruju
Za 2 minuta imaš: strukturirane podatke izvučene iz neurednog teksta, kao JSON koji uvek odgovara tvojoj šemi.
Kad mi trebaju imena, brojevi ili datumi iz mejlova i beležaka, želim polja, a ne prozu, da bih ih prosledio u jq, tabelu ili skriptu.
Sačuvaj JSON Schema kao contact.schema.json:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"city": { "type": "string" },
"phone": { "type": "string" }
},
"required": ["name", "city", "phone"]
}Zatim prosledi tekst pipe-om uz --schema. apfel ograničava model tako da izlaz bude ispravan JSON za tu šemu:
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 redosledom kojim su navedeni u tvojoj šemi.
Za bilo koji odgovor kao JSON sa metapodacima koristi -o json:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelZa ceo spisak koristi --batch: na ulazu jedna JSON linija po zapisu, na izlazu jedna linija rezultata po zapisu, svaki zapis u novoj sesiji. Tri recenzije proizvoda u tekstualnom fajlu:
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 pretvara svaku liniju u zapis; poslednja linija je apfel-ov rezime na stderr-u. Zapis koji ne uspe dobija status: "error", a batch se nastavlja.
Ako ne radi: apfel podržava podskup JSON Schema (objekti, stringovi, enum-i, brojevi, boolean vrednosti, nizovi, lokalni $ref). Nepodržana ključna reč kao što je pattern prekida rad sa exit kodom 2 i navodi tu reč; spisak je u dokumentu o kompatibilnosti API-ja.
6. Automatizuj svoj dan: git, glas i gotove skripte
Za 2 minuta imaš: rezime svog nedavnog rada, Mac koji ti naglas javi kad se dugačak zadatak završi i osam gotovih AI shell skripti.
Kad menjam zadatke ili čekam build, želim male automatizacije koje objašnjavaju i najavljuju stvari, da bih prestao da buljim u terminal.
Rezimiraj šta si radio, iz bilo kog git repozitorijuma:
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 Mac progovori kad se nešto završi. Prosledi odgovor pipe-om u say, a svoju dugačku komandu stavi ispred uz &&:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayTest Mac nije imao zvučni izlaz, pa smo govor snimili u fajl (| say -o build-done.aiff, 102.880 bajtova zvuka). Izgovorena rečenica je glasila Your build is finished, and I'm glad you asked!.
apfel dolazi i sa osam demo skripti. Upiši ih u fasciklu:
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
• wtdJedna koja nam se dopala u testiranju:
./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 pauseNisu svi demoi bili dobri u našim pokretanjima: oneliner "count unique IP addresses in access.log" je udario u ograničenje dužine i ispisao neispravnu komandu, a explain je dodao poruku o grešci koja nije postojala. Demo README navodi svih osam.
7. Pokreni svoj OpenAI kod besplatno
Za 2 minuta imaš: lokalni server koji govori OpenAI Chat Completions API, pa postojeći SDK kod radi na tvom Mac-u umesto na plaćenom modelu u oblaku.
Kad pravim prototip sa OpenAI SDK-om, želim besplatan lokalni endpoint, da bih gradio i testirao bez ključeva, računa i slanja podataka napolje.
Pokreni server u jednom tabu terminala:
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:11434U drugom tabu ga pozovi kao OpenAI:
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 izmena. Razlikuju se samo osnovni URL i ime modela. Sačuvaj kao 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 sluša samo na tvom Mac-u (127.0.0.1) i odbija zahteve sa web stranica sa drugih origin-a. Da bi ga otvorio za svoju mrežu, dodaj token: apfel --serve --host 0.0.0.0 --token-auto (vodič za bezbednost 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: autori projekta su dokumentovali podešavanje za VS Code Copilot (samo chat), opencode, Zed i Node.js, Ruby, PHP i još šest jezika. To nismo ponovo testirali za ovu stranicu.
8. Daj mu alate preko MCP-a
Za 2 minuta imaš: model koji čita živu web stranicu i rezimira je, preko alata za Model Context Protocol.
Kad je odgovor na nekoj web stranici, želim da je model sam preuzme, da bih dobio rezime bez prebacivanja teksta tamo-amo.
Instaliraj apfel-mcp alate, napravljene tako da stanu u mali context window:
brew install Arthur-Ficial/tap/apfel-mcpPriključi jedan sa --mcp i pitaj. -q sakriva sirovi izlaz alata:
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 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 sa više imenovanih argumenata. Evo kalkulatora iz apfel repozitorijuma (mcp/calculator/server.py): model poziva multiply sa oba argumenta, apfel ga izvršava, a model odgovara rezultatom:
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. Pre apfel 1.18.0 model nije video imena argumenata i nagađao ih je, pa je ovakav poziv padao (issue #555, ispravljeno u pull request-u #556). Ako ovde vidiš invalid arguments, ažuriraj sa brew upgrade apfel.
9. Chat za testiranje prompta
Za 2 minuta imaš: razgovor u terminalu koji pamti šta si ranije rekao.
Kad oblikujem prompt za skriptu, želim da brzo isprobam nekoliko poruka, da bih video kako model reaguje pre nego što to automatizujem.
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.Ulogu dodaješ sa -s, na primer apfel --chat -s "You are a patient Python tutor". Kad dugačak razgovor preraste context window, apfel podrazumevano izbacuje najstarije poruke; vodič za kontekst objašnjava ostale strategije. Ako želiš prozor sa dugmićima, pogledaj apfel-chat.
10. Server stalno radi u pozadini
Za 2 minuta imaš: OpenAI-kompatibilan server koji se sam pokreće pri prijavi i uvek je spreman na portu 11434.
Kad alati na mom Mac-u svaki dan koriste lokalni endpoint, želim da on uvek radi, da bih prestao da ga pokrećem ručno.
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)Podešavanja kao što su port, token ili MCP serveri zadaju se kroz promenljive okruženja, na primer APFEL_PORT=8080 brew services start apfel. Sve su navedene u vodiču za pozadinski servis.
11. Aplikacije zasnovane na apfel-u
Za 2 minuta imaš: isti model na uređaju u prozoru, u traci menija ili na prečici, ako ti aplikacije više leže od terminala.
Dolaze od istih autora ("apfel tree" u README-u). Proverili smo 15. novembra 2026. da svako ime za instalaciju postoji u Homebrew-u; same aplikacije nismo testirali za ovu stranicu.
| Aplikacija | Šta radi | Instalacija |
|---|---|---|
| apfel-chat | Chat aplikacija sa strimovanim odgovorima, govorom i analizom slika | brew install Arthur-Ficial/tap/apfel-chat |
| apfel-clip | Akcije nad clipboard-om iz trake menija: rezime, prevod, preformulisanje | brew install Arthur-Ficial/tap/apfel-clip |
| apfel-quick | Pritisni taster, pitaj, dobij odgovor, zatvori | brew install Arthur-Ficial/tap/apfel-quick |
| apfelpad | Beležnica u kojoj je AI formula koju upišeš u ćeliju | brew install Arthur-Ficial/tap/apfelpad |
| apfel-mcp | MCP alati krojeni za mali context window (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 proslediš pipe-om | brew install Arthur-Ficial/tap/apfel-tag |
| apfel-gui | Prozor za debagovanje: zahtevi, MCP poruke, govor | brew install Arthur-Ficial/tap/apfel-gui |
Ograničenja i iskreni odgovori
apfel ti daje Apple-ov model na uređaju. Prema README-u ima oko 3 milijarde parametara, što je mnogo manje od modela u oblaku iza ChatGPT-ja ili Claude-a. Dobar je za kratke, fokusirane zadatke sa tekstom. Ovo su ograničenja na koja smo naišli ili koja navodi dokumentacija.
Context window je mali. Pitanje i odgovor zajedno moraju da stanu u 4.096 tokena na macOS-u 26 i na M1 i M2 Mac-ovima, odnosno u 8.192 tokena na M3 ili novijim Mac-ovima sa 12 GB ili više koji rade na macOS-u 27 (README). apfel --model-info prikazuje koliki je kod tebe. Sam apfel-ov README je predugačak za njega. Prebroj pre slanja:
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: 4Broj 3.584 je prozor od 4.096 minus 512 tokena rezervisanih za odgovor. README ima oko 3.000 reči, ali Markdown i kod troše mnogo tokena po reči. Dugačke fajlove šalji u delovima (head -c 6000 file), odeljak po odeljak.
Ne zna današnji datum. Izmislio ga je:
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 priključiš MCP alat.
Ponekad greši, i to samouvereno. Video si to gore: pogrešne shell komande u zadatku 4, prevod koji je okrenuo smisao u zadatku 2. Proveri sve što je važno.
Apple-ov bezbednosni filter može da blokira bezazlen tekst. apfel se tada zaustavlja sa 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 bezbednosnim ograničenjima objašnjava šta ta opcija menja. U pokretanjima 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 ili macOS ažuriranja (politika stabilnosti).
Brzina: većina odgovora u našim pokretanjima stigla je za 1 do 2 sekunde. Rezime web stranice sa MCP alatom trajao je 8 sekundi.
Zahtevi su strogi: samo Apple Silicon, macOS 26 ili noviji, uključen Apple Intelligence i jedan od 15 jezika koje navodi --model-info. Na Intel Mac-ovima ne radi.
Kad nešto ne radi
apfel prijavljuje probleme exit kodom, pa skripte mogu da reaguju. Proveri ga sa echo $? odmah posle komande.
| Exit kod ili greška | Značenje | Šta da radiš |
|---|---|---|
2 |
Pogrešan flag ili opcija | Flagovi idu pre prompta; apfel --help ih navodi |
3 |
Apple-ov bezbednosni filter je blokirao zahtev | Preformuliši ili dodaj --permissive |
4 |
Ulaz je predugačak za context window | Pošalji manje teksta; proveri sa apfel --count-tokens |
5 |
Model nije dostupan | Uključi Apple Intelligence, sačekaj preuzimanje, uskladi jezik Mac-a i Siri |
6 |
Model je zauzet ili je dostignut limit zahteva | 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 si zaglavljen? Pretraži ili otvori issue na GitHub-u.
Ko je ovo napravio i kako je testirano
apfel je besplatan i open source (MIT licenca), franzai projekat Franza Enzenhofera. Projekat se održava uz pomoć Arthura Ficiala, Franzovog AI asistenta, koji je napisao i ovaj vodič. Pošto su ovu stranicu napisali autori apfel-a, naveli smo svaki neuspeh koji smo videli umesto da ga prećutimo.
Kako smo testirali: 15. novembra 2026. pokrenuli smo svaku komandu sa ove stranice na MacBook Air M2 (24 GB) sa macOS-om 27.0.1 (build 26A434). Koristili smo potpisani apfel 1.18.0 binarni fajl iz GitHub izdanja (isti fajl koji instalira Homebrew tap), u pravoj terminal sesiji, i kopirali izlaz bez izmena. Prva verzija ove stranice (14. novembar 2026, apfel 1.16.0) pokazala je bag sa alatima sa više argumenata u zadatku 8; 1.18.0 ga ispravlja, pa smo za ovu verziju ponovo pokrenuli svaku komandu. Gde je prvi izlaz bio pogrešan, ostavili smo pogrešan izlaz na stranici i to naveli. Ponovna pokretanja služila su samo da se nađu odgovori koje nije trebalo menjati: jedan rezime web stranice sadržavao je dugu crtu, koju ovaj sajt ne prikazuje, pa smo ga pokrenuli ponovo i zadržali treće pokretanje. Primer sa govorom proveren je upisivanjem zvuka u fajl, jer test Mac nije imao zvučni izlaz. Demo skripte je upisao apfel --demos iz apfel 1.18.0.
Šta su drugi pisali o apfel-u: Show HN objava (3. april 2026, 743 poena), vodič od Better Stack-a, članak na GIGAZINE-u i praktična recenzija na danilchenko.dev.
Izvori: apfel README, CLI referenca, vodič za instalaciju, demo skripte, apfel naspram Apple-ovog fm i issue tracker, pročitano 15. novembra 2026.