Οδηγός · δοκιμασμένος στις 15 Νοεμβρίου 2026
Οδηγός apfel AI
Η πρώτη σου απάντηση από το AI που έχει ήδη το Mac σου, σε 60 δευτερόλεπτα. Μετά 11 δουλειές που κάνει καλά, όλες έτοιμες για copy-paste με την πραγματική έξοδο, και μια ειλικρινής λίστα με όσα δεν μπορεί να κάνει.
Σε αυτή τη σελίδα: 15 ενότητες
- Η πρώτη σου απάντηση σε 60 δευτερόλεπτα
- 1. Ρώτα το Mac σου για τον εαυτό του
- 2. Διόρθωσε όποιο κείμενο αντέγραψες
- 3. Διάβασε αποδείξεις, PDF και scripts
- 4. Από απλά αγγλικά σε εντολή shell
- 5. Πάρε JSON που μπορούν να εμπιστευτούν τα scripts σου
- 6. Αυτοματοποίησε τη μέρα σου: git, φωνή και έτοιμα scripts
- 7. Τρέξε τον κώδικά σου για OpenAI δωρεάν
- 8. Δώσ' του εργαλεία με MCP
- 9. Chat για να δοκιμάσεις ένα prompt
- 10. Άφησε τον server να τρέχει στο παρασκήνιο
- 11. Εφαρμογές πάνω στο apfel
- Όρια και ειλικρινείς απαντήσεις
- Όταν κάτι αποτυγχάνει
- Ποιος το έφτιαξε και πώς δοκιμάστηκε
Η πρώτη σου απάντηση σε 60 δευτερόλεπτα
Χρειάζεσαι ένα Mac με Apple Silicon (M1 ή νεότερο) με macOS 26 Tahoe ή νεότερο, και ενεργοποιημένο το Apple Intelligence στις Ρυθμίσεις συστήματος > Apple Intelligence και Siri. Έλεγξε τα δύο πρώτα με μία γραμμή:
sw_vers -productVersion && uname -m
27.0.1
arm64Έκδοση 26 ή μεγαλύτερη και arm64 σημαίνουν ότι είσαι έτοιμος. Εγκατάστησε το apfel με Homebrew. Χωρίς Xcode, χωρίς λογαριασμό, χωρίς API key:
brew install apfelΚάνε την πρώτη σου ερώτηση:
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.Αυτή η απάντηση ήρθε από το μοντέλο της Apple στο Mac σου. Τίποτα δεν στάλθηκε σε server και δεν κόστισε τίποτα.
Αν αποτύχει: ρώτα το apfel αν το μοντέλο είναι έτοιμο:
apfel --model-info | grep -E 'available|context'
├ available: yes
├ context: 4096 tokensΑν γράφει available: no, ενεργοποίησε το Apple Intelligence στις Ρυθμίσεις συστήματος και περίμενε να ολοκληρωθεί η λήψη του μοντέλου (ο οδηγός εγκατάστασης αναφέρει 3 έως 4 GB). Η γλώσσα του Mac και η γλώσσα του Siri πρέπει να είναι η ίδια υποστηριζόμενη γλώσσα. Όσο το μοντέλο δεν είναι διαθέσιμο, το apfel τερματίζει με exit code 5.
Επόμενο βήμα: οι δουλειές παρακάτω. Η καθεμία ξεκινά με το τι θα έχεις μετά από δύο λεπτά.
1. Ρώτα το Mac σου για τον εαυτό του
Σε 2 λεπτά έχεις: απαντήσεις σε απλά λόγια για τον δίσκο, τον επεξεργαστή και τη μνήμη σου, κατευθείαν από τις εντολές που ήδη ξέρεις.
Όταν μια εντολή τερματικού βγάζει έναν τοίχο από αριθμούς, θέλω μια απάντηση μίας γραμμής, ώστε να ενεργήσω χωρίς να διαβάσω man page.
Στείλε οποιαδήποτε εντολή με pipe στο apfel και πες τι θέλεις να μάθεις:
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.Κράτα την είσοδο μικρή: πρώτα head, awk και grep, μετά το apfel. Το μοντέλο διαβάζει μόνο μερικές χιλιάδες λέξεις τη φορά, λιγότερες για κώδικα (δες τα όρια).
Αν αποτύχει: κάποιες εντολές γράφουν στο stderr, που το pipe δεν μεταφέρει. Το apfel σού το λέει: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.
Επόμενο βήμα: το ίδιο κόλπο δουλεύει για git log, lsof, pmset -g batt, αρχεία log και οτιδήποτε άλλο τυπώνει κείμενο.
2. Διόρθωσε όποιο κείμενο αντέγραψες
Σε 2 λεπτά έχεις: μια εντολή που διορθώνει τη γραμματική σε ό,τι υπάρχει στο πρόχειρο, σε οποιαδήποτε εφαρμογή.
Όταν γράφω ένα γρήγορο μήνυμα στο Slack, στο Mail ή στον browser, θέλω να το καθαρίσω χωρίς να ανοίξω άλλη εφαρμογή, ώστε να το επικολλήσω πίσω σε δευτερόλεπτα.
Αντέγραψε λίγο κείμενο και τρέξε τη μεσαία γραμμή. Το pbpaste διαβάζει το πρόχειρο, το pbcopy γράφει πίσω το αποτέλεσμα:
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.Γιατί "the text above": το apfel βάζει πρώτα το κείμενο του pipe και μετά την οδηγία σου (πηγή). Με τη σύντομη οδηγία "fix grammar and spelling, reply with the corrected text only", το μοντέλο απάντησε στο μήνυμα αντί να το διορθώσει και έγραψε Could you let me know which meeting you're referring to?. Όταν ονομάσαμε το κείμενο πάνω στο οποίο πρέπει να δουλέψει, το πρόβλημα λύθηκε στη δοκιμή μας.
Αν αποτύχει: διάβασε το αποτέλεσμα πριν το στείλεις. Ένα μικρό μοντέλο αλλάζει καμιά φορά το νόημα· όταν του ζητήσαμε να μεταφράσει αυτή την πρόταση στα γερμανικά, μετέτρεψε το "Can you send me" σε "Can I send you".
Επόμενο βήμα: βάλε τη μεσαία γραμμή σε ένα alias του shell ή σε μια ενέργεια "Run Shell Script" των Συντομεύσεων και δώσε της μια συντόμευση πληκτρολογίου.
3. Διάβασε αποδείξεις, PDF και scripts
Σε 2 λεπτά έχεις: απαντήσεις για μια εικόνα, ένα σκαναρισμένο PDF ή ένα script, που διαβάζονται στο Mac σου με την αναγνώριση κειμένου της Apple.
Όταν μια απόδειξη, ένα σκαναρισμένο έγγραφο ή ένα άγνωστο αρχείο καταλήγει στις Λήψεις μου, θέλω το ένα στοιχείο που χρειάζομαι από αυτό, ώστε να το αρχειοθετήσω χωρίς να το ανοίξω.
Επισύναψε ένα αρχείο με -f. Φτιάξαμε μια δοκιμαστική εικόνα απόδειξης (receipt.png) με αυτές τις γραμμές:
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.20Η ίδια απόδειξη αποθηκευμένη ως PDF που περιέχει μόνο εικόνα δουλεύει επίσης, γιατί το apfel τρέχει αναγνώριση κειμένου στις σκαναρισμένες σελίδες:
apfel -f receipt.pdf "What is the total? Just the amount."
24.20Και οποιοδήποτε αρχείο κειμένου, για παράδειγμα ένα shell script:
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.Αυτό το script το παίρνεις στη δουλειά 6. Επισύναψε πολλά αρχεία με -f a.txt -f b.txt.
Αν αποτύχει: το exit code 4 σημαίνει ότι το αρχείο είναι πολύ μεγάλο για το μοντέλο (δες τα όρια). Το exit code 3 σημαίνει ότι το φίλτρο ασφαλείας της Apple το μπλόκαρε· ο οδηγός εξαγωγής αρχείων προτείνει να προσθέσεις --permissive σε αυτή την περίπτωση.
4. Από απλά αγγλικά σε εντολή shell
Σε 2 λεπτά έχεις: την εντολή που δεν θυμόσουν, τυπωμένη σκέτη για να την αντιγράψεις.
Όταν ξεχνάω τα flags του find, του du ή του tar, θέλω την εντολή από μια απλή πρόταση, ώστε να μείνω στο τερματικό.
Το --code τυπώνει μόνο τον κώδικα, χωρίς εξήγηση:
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100MΤα flags είναι σωστά, αλλά το μοντέλο επινόησε έναν φάκελο. Ο φάκελος χρήστη σου είναι το ~ (εδώ: 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 resultΔιάβασε κάθε εντολή πριν την τρέξεις. Στις δοκιμές μας το μοντέλο έβγαλε και λάθος εντολές. Όταν του ζητήσαμε "the 10 largest files in the current folder", τύπωσε ls -lh | head -n 10, που δείχνει τις πρώτες 10 εγγραφές, όχι τις μεγαλύτερες. Όταν του ζητήσαμε "show open ports", πρότεινε netstat -tuln | grep LISTEN, που χρησιμοποιεί flags του Linux· στο macOS δεν τυπώνει απολύτως τίποτα. Σε Mac, τις δείχνει το lsof -iTCP -sTCP:LISTEN -n -P.
Επόμενο βήμα: το demo script cmd στη δουλειά 6 τα πακετάρει όλα αυτά και ρωτάει πριν τρέξει οτιδήποτε (-x) ή αντιγράφει την εντολή (-c).
5. Πάρε JSON που μπορούν να εμπιστευτούν τα scripts σου
Σε 2 λεπτά έχεις: δομημένα δεδομένα βγαλμένα από ακατάστατο κείμενο, ως JSON που ταιριάζει πάντα στο schema σου.
Όταν χρειάζομαι ονόματα, αριθμούς ή ημερομηνίες από emails και σημειώσεις, θέλω πεδία, όχι πρόζα, ώστε να τα δώσω στο jq, σε ένα υπολογιστικό φύλλο ή σε ένα script.
Αποθήκευσε ένα JSON Schema ως contact.schema.json:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"city": { "type": "string" },
"phone": { "type": "string" }
},
"required": ["name", "city", "phone"]
}Μετά στείλε το κείμενο με pipe και --schema. Το apfel περιορίζει το μοντέλο ώστε η έξοδος να είναι έγκυρο JSON για αυτό το schema:
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"
}Τα κλειδιά επιστρέφουν με τη σειρά που τα δηλώνει το schema σου.
Για οποιαδήποτε απάντηση ως JSON με metadata, χρησιμοποίησε -o json:
apfel -o json "Translate to German: apple" | jq -r .content
ApfelΓια ολόκληρη λίστα, χρησιμοποίησε --batch: στην είσοδο μία γραμμή JSON ανά εγγραφή, στην έξοδο μία γραμμή αποτελέσματος ανά εγγραφή, και κάθε εγγραφή τρέχει σε καινούργιο session. Τρεις κριτικές προϊόντων σε ένα αρχείο κειμένου:
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 κάνει κάθε γραμμή μια εγγραφή· η τελευταία γραμμή είναι η σύνοψη του apfel στο stderr. Μια εγγραφή που αποτυγχάνει παίρνει status: "error" και το batch συνεχίζει.
Αν αποτύχει: το apfel υποστηρίζει ένα υποσύνολο του JSON Schema (objects, strings, enums, αριθμούς, booleans, arrays, τοπικό $ref). Μια μη υποστηριζόμενη λέξη-κλειδί όπως το pattern σταματά με exit code 2 και την κατονομάζει· η λίστα βρίσκεται στο έγγραφο συμβατότητας API.
6. Αυτοματοποίησε τη μέρα σου: git, φωνή και έτοιμα scripts
Σε 2 λεπτά έχεις: μια σύνοψη της πρόσφατης δουλειάς σου, ένα Mac που σου λέει δυνατά πότε τελείωσε μια μεγάλη εργασία, και οκτώ έτοιμα AI shell scripts.
Όταν αλλάζω εργασία ή περιμένω ένα build, θέλω μικρούς αυτοματισμούς που εξηγούν και ανακοινώνουν πράγματα, ώστε να σταματήσω να κοιτάζω το τερματικό.
Σύνοψη του τι έκανες, μέσα από οποιοδήποτε git repository:
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.Βάλε το Mac σου να μιλήσει όταν κάτι τελειώνει. Στείλε την απάντηση με pipe στο say και βάλε τη μεγάλη σου εντολή μπροστά με &&:
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | sayΤο δοκιμαστικό Mac δεν είχε έξοδο ήχου, οπότε γράψαμε την ομιλία σε αρχείο (| say -o build-done.aiff, 102.880 bytes ήχου). Η πρόταση που είπε ήταν Your build is finished, and I'm glad you asked!.
Το apfel έρχεται επίσης με οκτώ demo scripts. Γράψε τα σε έναν φάκελο:
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Ένα που μας άρεσε στις δοκιμές:
./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Δεν ήταν όλα τα demos καλά στις εκτελέσεις μας: το oneliner "count unique IP addresses in access.log" έπεσε πάνω στο όριο μήκους και τύπωσε μια σπασμένη εντολή, και το explain πρόσθεσε ένα μήνυμα σφάλματος που δεν υπήρχε. Το README των demos τα παραθέτει και τα οκτώ.
7. Τρέξε τον κώδικά σου για OpenAI δωρεάν
Σε 2 λεπτά έχεις: έναν τοπικό server που μιλάει το OpenAI Chat Completions API, ώστε ο υπάρχων κώδικας με το SDK να τρέχει στο Mac σου αντί για ένα πληρωμένο μοντέλο στο cloud.
Όταν φτιάχνω prototype με το OpenAI SDK, θέλω ένα δωρεάν τοπικό endpoint, ώστε να χτίζω και να δοκιμάζω χωρίς keys, χρεώσεις ή αποστολή δεδομένων έξω από το Mac.
Ξεκίνα τον server σε μια καρτέλα τερματικού:
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Σε δεύτερη καρτέλα, κάλεσέ τον όπως το 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.Το επίσημο OpenAI Python SDK δουλεύει χωρίς αλλαγές. Διαφέρουν μόνο το base URL και το όνομα του μοντέλου. Αποθήκευσε ως 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 SipΟ server ακούει μόνο στο δικό σου Mac (127.0.0.1) και απορρίπτει αιτήματα από ιστοσελίδες με άλλο origin. Για να τον ανοίξεις στο δίκτυό σου, πρόσθεσε ένα token: apfel --serve --host 0.0.0.0 --token-auto (οδηγός ασφάλειας server).
Αν αποτύχει: το Connection refused σημαίνει ότι ο server δεν τρέχει. Τα embeddings και το παλιό endpoint /v1/completions επιστρέφουν HTTP 501, γιατί το on-device μοντέλο δεν τα προσφέρει.
Επόμενο βήμα: οι maintainers τεκμηριώνουν ρυθμίσεις για VS Code Copilot (μόνο chat), opencode, Zed και Node.js, Ruby, PHP και έξι ακόμη γλώσσες. Αυτές δεν τις ξαναδοκιμάσαμε για αυτή τη σελίδα.
8. Δώσ' του εργαλεία με MCP
Σε 2 λεπτά έχεις: το μοντέλο να διαβάζει μια ζωντανή ιστοσελίδα και να τη συνοψίζει, μέσω ενός εργαλείου Model Context Protocol.
Όταν η απάντηση βρίσκεται σε μια ιστοσελίδα, θέλω το μοντέλο να τη φέρει μόνο του, ώστε να πάρω μια σύνοψη χωρίς να αντιγράφω κείμενο από δω κι από κει.
Εγκατάστησε τα εργαλεία apfel-mcp, που είναι φτιαγμένα για να χωράνε στο μικρό context window:
brew install Arthur-Ficial/tap/apfel-mcpΣύνδεσε ένα με --mcp και ρώτα. Το -q κρύβει την ακατέργαστη έξοδο του εργαλείου:
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.Το ίδιο πακέτο έχει τα apfel-mcp-ddg-search (αναζήτηση στο web), apfel-mcp-search-and-fetch και apfel-mcp-fs (ανάγνωση τοπικού αρχείου). Δουλεύει οποιοσδήποτε MCP server: η διαδρομή ενός τοπικού script ή ένα URL https://.
Δουλεύουν και εργαλεία με πολλά ονομασμένα ορίσματα. Να η αριθμομηχανή από το repository του apfel (mcp/calculator/server.py): το μοντέλο καλεί το multiply και με τα δύο ορίσματα, το apfel το εκτελεί και το μοντέλο απαντά με το αποτέλεσμα:
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: το apfel σού δείχνει την κλήση που έκανε. Πριν από το apfel 1.18.0 το μοντέλο δεν έβλεπε τα ονόματα των ορισμάτων και τα μάντευε, οπότε μια τέτοια κλήση αποτύγχανε (issue #555, διορθώθηκε στο pull request #556). Αν δεις εδώ invalid arguments, κάνε ενημέρωση με brew upgrade apfel.
9. Chat για να δοκιμάσεις ένα prompt
Σε 2 λεπτά έχεις: μια συζήτηση στο τερματικό που θυμάται τι είπες νωρίτερα.
Όταν διαμορφώνω ένα prompt για ένα script, θέλω να δοκιμάσω γρήγορα μερικούς γύρους, ώστε να δω πώς αντιδρά το μοντέλο πριν το αυτοματοποιήσω.
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.Πρόσθεσε μια persona με -s, για παράδειγμα apfel --chat -s "You are a patient Python tutor". Όταν ένα μεγάλο chat ξεπερνά το context window, το apfel από προεπιλογή πετάει τους παλαιότερους γύρους· ο οδηγός για το context εξηγεί τις άλλες στρατηγικές. Για παράθυρο με κουμπιά, δες το apfel-chat.
10. Άφησε τον server να τρέχει στο παρασκήνιο
Σε 2 λεπτά έχεις: τον server που είναι συμβατός με OpenAI να ξεκινά μόνος του με τη σύνδεση, πάντα έτοιμος στη θύρα 11434.
Όταν εργαλεία στο Mac μου χρησιμοποιούν κάθε μέρα το τοπικό endpoint, θέλω να είναι πάντα ανοιχτό, ώστε να μην το ξεκινάω πια με το χέρι.
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)Ρυθμίσεις όπως η θύρα, ένα token ή οι MCP servers είναι μεταβλητές περιβάλλοντος, για παράδειγμα APFEL_PORT=8080 brew services start apfel. Όλες αναφέρονται στον οδηγό για την υπηρεσία παρασκηνίου.
11. Εφαρμογές πάνω στο apfel
Σε 2 λεπτά έχεις: το ίδιο on-device μοντέλο σε ένα παράθυρο, στη γραμμή μενού ή πίσω από ένα hotkey, αν προτιμάς εφαρμογές από το τερματικό.
Προέρχονται από τους ίδιους maintainers (το "apfel tree" στο README). Στις 15 Νοεμβρίου 2026 ελέγξαμε ότι κάθε όνομα εγκατάστασης υπάρχει στο Homebrew· τις ίδιες τις εφαρμογές δεν τις δοκιμάσαμε για αυτή τη σελίδα.
| Εφαρμογή | Τι κάνει | Εγκατάσταση |
|---|---|---|
| apfel-chat | Εφαρμογή chat με streaming απαντήσεων, ομιλία και ανάλυση εικόνας | brew install Arthur-Ficial/tap/apfel-chat |
| apfel-clip | Ενέργειες για το πρόχειρο από τη γραμμή μενού: σύνοψη, μετάφραση, αναδιατύπωση | brew install Arthur-Ficial/tap/apfel-clip |
| apfel-quick | Πατάς ένα πλήκτρο, ρωτάς, παίρνεις την απάντηση, το κλείνεις | brew install Arthur-Ficial/tap/apfel-quick |
| apfelpad | Σημειωματάριο όπου το AI είναι ένας τύπος που βάζεις σε ένα κελί | brew install Arthur-Ficial/tap/apfelpad |
| apfel-mcp | Εργαλεία MCP στα μέτρα του μικρού παραθύρου (δουλειά 8) | brew install Arthur-Ficial/tap/apfel-mcp |
| apfel-run | Το apfel με αποθηκευμένες ρυθμίσεις και μια λίστα MCP servers | brew install Arthur-Ficial/tap/apfel-run |
| apfel-tag | Tags, θέματα και συναισθήματα για όποιο κείμενο στέλνεις με pipe | brew install Arthur-Ficial/tap/apfel-tag |
| apfel-gui | Παράθυρο debug: αιτήματα, μηνύματα MCP, ομιλία | brew install Arthur-Ficial/tap/apfel-gui |
Όρια και ειλικρινείς απαντήσεις
Το apfel σού δίνει το on-device μοντέλο της Apple. Το README το υπολογίζει σε περίπου 3 δισεκατομμύρια παραμέτρους, πολύ μικρότερο από τα μοντέλα cloud πίσω από το ChatGPT ή το Claude. Είναι καλό σε σύντομες, στοχευμένες δουλειές με κείμενο. Αυτά είναι τα όρια που συναντήσαμε ή που αναφέρει η τεκμηρίωση.
Το context window είναι μικρό. Ερώτηση και απάντηση πρέπει να χωρέσουν σε 4.096 tokens σε macOS 26 και σε Mac με M1 και M2, ή σε 8.192 tokens σε Mac με M3 ή νεότερο, με 12 GB ή περισσότερα, που τρέχουν macOS 27 (README). Το apfel --model-info δείχνει το δικό σου. Το ίδιο το README του apfel είναι πολύ μεγάλο για αυτό. Μέτρησε πριν στείλεις:
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Το 3.584 είναι το παράθυρο των 4.096 μείον 512 tokens που μένουν ελεύθερα για την απάντηση. Το README έχει περίπου 3.000 λέξεις, αλλά το Markdown και ο κώδικας κοστίζουν πολλά tokens ανά λέξη. Δώσε τα μεγάλα αρχεία σε κομμάτια (head -c 6000 file), μία ενότητα τη φορά.
Δεν ξέρει τη σημερινή ημερομηνία. Επινόησε μία:
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.Δώσ' του μέσα στο prompt κάθε στοιχείο που χρειάζεται. Δεν έχει internet, εκτός αν συνδέσεις ένα εργαλείο MCP.
Κάνει λάθη καμιά φορά, και μάλιστα με σιγουριά. Το είδες παραπάνω: λάθος εντολές shell στη δουλειά 4, μια μετάφραση που αντέστρεψε το νόημα στη δουλειά 2. Έλεγξε οτιδήποτε έχει σημασία.
Το φίλτρο ασφαλείας της Apple μπορεί να μπλοκάρει αθώο κείμενο. Τότε το apfel σταματά με exit code 3 και το μήνυμα The request was blocked by Apple's safety guardrails. Αναδιατύπωσε ή πρόσθεσε --permissive για δημιουργική γραφή και έγγραφα· το έγγραφο για τα guardrails εξηγεί τι αλλάζει. Στις εκτελέσεις για αυτή τη σελίδα δεν πέσαμε πάνω σε μπλοκάρισμα.
Οι απαντήσεις διαφέρουν σε κάθε εκτέλεση. Αυτές είναι πραγματικές έξοδοι από μία εκτέλεση η καθεμία. Οι δικές σου θα είναι διατυπωμένες αλλιώς. Χρησιμοποίησε --temperature 0 για πιο επαναλήψιμες απαντήσεις· το apfel δεν υπόσχεται ίδια έξοδο ανάμεσα σε εκτελέσεις ή ενημερώσεις του macOS (πολιτική σταθερότητας).
Ταχύτητα: οι περισσότερες απαντήσεις στις εκτελέσεις μας ήρθαν σε 1 έως 2 δευτερόλεπτα. Η σύνοψη της ιστοσελίδας με εργαλείο MCP πήρε 8 δευτερόλεπτα.
Οι απαιτήσεις είναι αυστηρές: μόνο Apple Silicon, macOS 26 ή νεότερο, ενεργό Apple Intelligence, και μία από τις 15 γλώσσες που αναφέρει το --model-info. Τα Mac με Intel δεν μπορούν να το τρέξουν.
Όταν κάτι αποτυγχάνει
Το apfel αναφέρει τα προβλήματα με ένα exit code, ώστε τα scripts να μπορούν να αντιδράσουν. Έλεγξέ το με echo $? αμέσως μετά την εντολή.
| Exit code ή σφάλμα | Σημασία | Τι να κάνεις |
|---|---|---|
2 |
Λάθος flag ή επιλογή | Τα flags μπαίνουν πριν από το prompt· το apfel --help τα παραθέτει |
3 |
Το φίλτρο ασφαλείας της Apple μπλόκαρε το αίτημα | Αναδιατύπωσε ή πρόσθεσε --permissive |
4 |
Η είσοδος είναι πολύ μεγάλη για το context window | Στείλε λιγότερο κείμενο· έλεγξε με apfel --count-tokens |
5 |
Το μοντέλο δεν είναι διαθέσιμο | Ενεργοποίησε το Apple Intelligence, περίμενε τη λήψη, ταίριαξε τη γλώσσα του Mac με του Siri |
6 |
Το μοντέλο είναι απασχολημένο ή έφτασε το όριο αιτημάτων | Περίμενε και τρέξ' το ξανά, ή πρόσθεσε --retry |
Connection refused |
Κανένας server στη θύρα 11434 | Ξεκίνα το apfel --serve ή το brew services start apfel |
| HTTP 501 | Endpoint που το on-device μοντέλο δεν προσφέρει (embeddings, /v1/completions) |
Χρησιμοποίησε το /v1/chat/completions |
piped input was empty |
Η εντολή έγραψε στο stderr | command 2>&1 \| apfel "..." |
Δεν λύθηκε ακόμα; Ψάξε ή άνοιξε ένα issue στο GitHub.
Ποιος το έφτιαξε και πώς δοκιμάστηκε
Το apfel είναι δωρεάν και ανοιχτού κώδικα (άδεια MIT), ένα έργο της franzai από τον Franz Enzenhofer. Το συντηρεί μαζί με τον Arthur Ficial, τον AI βοηθό του Franz, που έγραψε και αυτόν τον οδηγό. Επειδή αυτή τη σελίδα την έγραψαν οι δημιουργοί του apfel, καταγράψαμε κάθε αποτυχία που είδαμε αντί να την παραλείψουμε.
Πώς το δοκιμάσαμε: στις 15 Νοεμβρίου 2026 τρέξαμε κάθε εντολή αυτής της σελίδας σε ένα MacBook Air M2 (24 GB) με macOS 27.0.1 (build 26A434). Χρησιμοποιήσαμε το υπογεγραμμένο binary του apfel 1.18.0 από το GitHub release (το ίδιο αρχείο που εγκαθιστά το Homebrew tap), μέσα σε πραγματική συνεδρία τερματικού, και αντιγράψαμε την έξοδο χωρίς αλλαγές. Η πρώτη έκδοση αυτής της σελίδας (14 Νοεμβρίου 2026, apfel 1.16.0) έδειχνε το bug με τα εργαλεία πολλών ορισμάτων στη δουλειά 8· το 1.18.0 το διορθώνει, οπότε ξανατρέξαμε κάθε εντολή για αυτή την έκδοση. Όπου η πρώτη έξοδος ήταν λάθος, κρατήσαμε τη λάθος έξοδο στη σελίδα και το είπαμε. Οι μόνες επαναλήψεις έγιναν για να βρούμε απαντήσεις που δεν χρειάζονταν καμία επέμβαση: μια σύνοψη ιστοσελίδας περιείχε μια μακριά παύλα, που αυτό το site δεν τυπώνει, οπότε την ξανατρέξαμε και κρατήσαμε την τρίτη εκτέλεση. Το παράδειγμα ομιλίας ελέγχθηκε γράφοντας τον ήχο σε αρχείο, γιατί το δοκιμαστικό Mac δεν είχε έξοδο ήχου. Τα demo scripts γράφτηκαν από το apfel --demos του apfel 1.18.0.
Τι έγραψαν άλλοι για το apfel: το post στο Show HN (3 Απριλίου 2026, 743 πόντοι), ένας οδηγός από το Better Stack, ένα άρθρο του GIGAZINE και μια πρακτική κριτική στο danilchenko.dev.
Πηγές: το README του apfel, η αναφορά του CLI, ο οδηγός εγκατάστασης, τα demo scripts, το apfel έναντι του fm της Apple και ο issue tracker, όπως τα διαβάσαμε στις 15 Νοεμβρίου 2026.