apfel е проект на .

Туторијал · тестирано на 15 ноември 2026

apfel AI туторијал

Твојот прв одговор од AI што веќе е на твојот Mac, за 60 секунди. Потоа 11 задачи што ги работи добро, секоја подготвена за copy-paste со вистинскиот излез, и искрен список на она што не може да го направи.

Вистинска снимка од терминалот, ништо монтирано: apfel 1.18.0 на macOS 27.0.1, MacBook Air M2.
На оваа страница: 15 делови
  1. Твојот прв одговор за 60 секунди
  2. 1. Прашај го Mac-от за самиот себе
  3. 2. Поправи кој било копиран текст
  4. 3. Читај сметки, PDF-ови и скрипти
  5. 4. Од обичен англиски до shell команда
  6. 5. JSON на кој скриптите можат да се потпрат
  7. 6. Автоматизирај го денот: git, глас и готови скрипти
  8. 7. Изврши го твојот OpenAI код бесплатно
  9. 8. Дај му алатки преку MCP
  10. 9. Разговарај за да тестираш промпт
  11. 10. Серверот нека работи во позадина
  12. 11. Апликации изградени врз apfel
  13. Граници и искрени одговори
  14. Кога нешто не работи
  15. Кој го направи ова и како е тестирано

Твојот прв одговор за 60 секунди

Ти треба Mac со Apple Silicon (M1 или понов) со macOS 26 Tahoe или понов и вклучен Apple Intelligence во System Settings > Apple Intelligence & Siri. Првите два услови ги проверуваш со еден ред:

Терминал
sw_vers -productVersion && uname -m
27.0.1
arm64

Верзија 26 или повисока и arm64 значат дека си подготвен. Инсталирај го apfel со Homebrew. Без Xcode, без сметка, без API клуч:

Терминал
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. Ништо не беше испратено на сервер и не чинеше ништо.

Ако не работи: прашај го apfel дали моделот е подготвен:

Терминал
apfel --model-info | grep -E 'available|context'
├ available:  yes
├ context:    4096 tokens

Ако пишува available: no, вклучи го Apple Intelligence во System Settings и почекај додека моделот не се преземе целосно (според упатството за инсталација тоа се 3 до 4 GB). Јазикот на твојот Mac и јазикот на Siri мора да бидат ист поддржан јазик. Додека моделот не е достапен, apfel завршува со exit код 5.

Следно: задачите подолу. Секоја започнува со тоа што ќе имаш по две минути.

1. Прашај го Mac-от за самиот себе

За 2 минути имаш: одговори на обичен јазик за дискот, процесорот и меморијата, директно од командите што веќе ги знаеш.

Кога некоја команда во терминалот ќе испише ѕид од бројки, сакам одговор во еден ред, за да можам да реагирам без да читам man страница.

Пушти ја која било команда со 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 или во прелистувач, сакам да ја исправам без да отворам друга апликација, за да можам да ја залепам назад за неколку секунди.

Копирај некој текст, па изврши го средниот ред. 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“.

Следно: стави го средниот ред во shell alias или во акцијата „Run Shell Script“ во Shortcuts и додели му кратенка на тастатурата.

3. Читај сметки, PDF-ови и скрипти

За 2 минути имаш: одговори за слика, скениран PDF или скрипта, прочитани на твојот Mac со препознавањето текст на Apple.

Кога во Downloads ќе ми падне сметка, скен или непозната датотека, сакам да го добијам единствениот податок што ми треба, за да можам да ја архивирам без да ја отворам.

Прикачи датотека со -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:14
Терминал
apfel -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 скрипта:

Терминал
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.

Таа скрипта ја добиваш во задача 6. Повеќе датотеки прикачуваш со -f a.txt -f b.txt.

Ако не работи: exit код 4 значи дека датотеката е предолга за моделот (види граници). Exit код 3 значи дека ја блокирал безбедносниот филтер на Apple; упатството за извлекување од датотеки предлага во тој случај да додадеш --permissive.

4. Од обичен англиски до shell команда

За 2 минути имаш: командата што не можеше да ја запомниш, испишана сама, без објаснување, за да ја копираш.

Кога ќе ги заборавам знамињата на 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

Знамињата се точни, но моделот измислил папка. Твојата домашна папка е ~ (тука: 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, што користи Linux знамиња; на macOS не печати баш ништо. На Mac ги прикажува lsof -iTCP -sTCP:LISTEN -n -P.

Следно: демо-скриптата cmd од задача 6 го обвиткува ова и прашува пред да изврши нешто (-x) или ја копира командата (-c).

5. JSON на кој скриптите можат да се потпрат

За 2 минути имаш: структурирани податоци извлечени од неуреден текст, како JSON што секогаш одговара на твојата шема.

Кога ми требаат имиња, бројки или датуми од мејлови и белешки, сакам полиња, а не проза, за да можам да ги предадам на jq, табела или скрипта.

Зачувај JSON Schema како contact.schema.json:

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

Потоа пушти го текстот со pipe и --schema. apfel го ограничува моделот така што излезот е валиден JSON за таа шема:

Терминал
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"
}

Клучевите се враќаат по редоследот по кој ги наведува твојата шема.

За кој било одговор како JSON со метаподатоци, користи -o json:

Терминал
apfel -o json "Translate to German: apple" | jq -r .content
Apfel

За цел список, користи --batch: еден JSON ред по запис на влез, еден ред со резултат по запис на излез, секој запис во нова сесија. Три рецензии за производ во текстуална датотека:

Терминал
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 (објекти, стрингови, enum-и, бројки, boolean вредности, низи, локален $ref). Неподдржан клучен збор како pattern запира со exit код 2 и го именува; списокот е во документот за компатибилност со API.

6. Автоматизирај го денот: git, глас и готови скрипти

За 2 минути имаш: резиме на твојата неодамнешна работа, Mac што гласно ти кажува кога ќе заврши долга задача и осум готови AI shell скрипти.

Кога менувам задачи или чекам build, сакам мали автоматизации што објаснуваат и известуваат, за да можам да престанам да зјапам во терминалот.

Резимирај што правеше, од кој било git репозиториум:

Терминал
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 бајти аудио). Реченицата што ја изговори беше Your build is finished, and I'm glad you asked!.

apfel доаѓа и со осум демо-скрипти. Запиши ги во папка:

Терминал
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

Не секое демо беше добро во нашите обиди: oneliner "count unique IP addresses in access.log" налета на ограничувањето за должина и испиша неисправна команда, а explain додаде порака за грешка што не постоеше. README-то за демо-скриптите ги наведува сите осум.

7. Изврши го твојот OpenAI код бесплатно

За 2 минути имаш: локален сервер што го зборува OpenAI Chat Completions API, па постоечкиот SDK код работи на твојот Mac наместо на платен модел во облак.

Кога правам прототип со OpenAI SDK, сакам бесплатен локален endpoint, за да можам да градам и тестирам без клучеви, без трошоци и без да праќам податоци надвор.

Стартувај го серверот во едно јазиче на терминалот:

Терминал
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:

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)
Терминал
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

Серверот слуша само на твојот Mac (127.0.0.1) и одбива барања од веб-страници од други origin-и. За да го отвориш кон својата мрежа, додај токен: apfel --serve --host 0.0.0.0 --token-auto (упатство за безбедност на серверот).

Ако не работи: Connection refused значи дека серверот не работи. Embeddings и стариот endpoint /v1/completions враќаат HTTP 501, бидејќи моделот на уредот не ги нуди.

Следно: одржувачите имаат документирано поставки за VS Code Copilot (само чет), opencode, Zed и Node.js, Ruby, PHP и уште шест јазици. За оваа страница не ги тестиравме повторно.

8. Дај му алатки преку MCP

За 2 минути имаш: модел што чита жива веб-страница и ја резимира, преку алатка за Model Context Protocol.

Кога одговорот е на некоја веб-страница, сакам моделот сам да ја преземе, за да можам да добијам резиме без да копирам текст наоколу.

Инсталирај ги алатките apfel-mcp, направени да се соберат во малиот контекстен прозорец:

Терминал
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 (веб-пребарување), apfel-mcp-search-and-fetch и apfel-mcp-fs (читање локална датотека). Работи кој било MCP сервер: патека до локална скрипта или https:// URL.

Работат и алатки со повеќе именувани аргументи. Еве го калкулаторот од репозиториумот на 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. Разговарај за да тестираш промпт

За 2 минути имаш: разговор во терминалот што памети што си кажал претходно.

Кога обликувам промпт за скрипта, сакам брзо да пробам неколку чекори, за да можам да видам како реагира моделот пред да го автоматизирам.

Терминал
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.

Додај персона со -s, на пример apfel --chat -s "You are a patient Python tutor". Кога долг разговор ќе го надрасне контекстниот прозорец, apfel стандардно ги отфрла најстарите чекори; упатството за контекст ги објаснува другите стратегии. За прозорец со копчиња, види apfel-chat.

10. Серверот нека работи во позадина

За 2 минути имаш: 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)

Поставките како портата, токенот или MCP серверите се променливи на околината, на пример APFEL_PORT=8080 brew services start apfel. Сите се наведени во упатството за сервисот во позадина.

11. Апликации изградени врз apfel

За 2 минути имаш: истиот модел на уредот во прозорец, во лентата со менија или на кратенка од тастатурата, ако повеќе ги сакаш апликациите отколку терминалот.

Ги прават истите одржувачи („apfel tree“ во README). На 15 ноември 2026 проверивме дека секое име за инсталација постои во Homebrew; апликациите не ги тестиравме за оваа страница.

Апликација Што прави Инсталација
apfel-chat Апликација за чет со стримувани одговори, говор и анализа на слики 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 сервери brew install Arthur-Ficial/tap/apfel-run
apfel-tag Ознаки, теми и емоции за секој текст што ќе го пратиш со pipe brew install Arthur-Ficial/tap/apfel-tag
apfel-gui Прозорец за дебагирање: барања, MCP пораки, говор brew install Arthur-Ficial/tap/apfel-gui

Граници и искрени одговори

apfel ти го дава моделот на Apple на уредот. Според README има околу 3 милијарди параметри, многу помал од моделите во облак зад ChatGPT или Claude. Добар е за кратки, фокусирани задачи со текст. Ова се границите на кои налетавме или што ги наведува документацијата.

Контекстниот прозорец е мал. Прашањето и одговорот заедно мора да се соберат во 4.096 токени на macOS 26 и на Mac со M1 и M2, или во 8.192 токени на 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 токени што се чуваат слободни за одговорот. README-то има околу 3.000 зборови, но Markdown и кодот чинат многу токени по збор. Долгите датотеки внесувај ги во делови (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.

Секој факт што му треба дај му го во промптот. Нема интернет, освен ако не приклучиш MCP алатка.

Понекогаш греши, и тоа самоуверено. Го виде погоре: погрешни shell команди во задача 4, превод што го преврте значењето во задача 2. Провери сè што е важно.

Безбедносниот филтер на Apple може да блокира безопасен текст. Тогаш apfel запира со exit код 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. На Intel Mac не работи.

Кога нешто не работи

apfel ги пријавува проблемите со exit код, па скриптите можат да реагираат. Провери го со echo $? веднаш по командата.

Exit код или грешка Значење Што да правиш
2 Погрешно знаменце или опција Знамињата одат пред промптот; apfel --help ги наведува
3 Безбедносниот филтер на Apple го блокирал барањето Преформулирај или додај --permissive
4 Влезот е предолг за контекстниот прозорец Прати помалку текст; провери со apfel --count-tokens
5 Моделот не е достапен Вклучи Apple Intelligence, почекај да заврши преземањето, усогласи го јазикот на Mac и Siri
6 Моделот е зафатен или е достигнато ограничувањето на барања Почекај и изврши повторно, или додај --retry
Connection refused Нема сервер на портата 11434 Стартувај apfel --serve или brew services start apfel
HTTP 501 Endpoint што моделот на уредот не го нуди (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 асистент, кој го напиша и овој туторијал. Бидејќи страницата ја напишаа самите автори на apfel, го наведовме секој неуспех што го видовме наместо да го премолчиме.

Како тестиравме: на 15 ноември 2026 ја извршивме секоја команда од оваа страница на MacBook Air M2 (24 GB) со macOS 27.0.1 (build 26A434). Ја користевме потпишаната бинарна датотека на apfel 1.18.0 од изданието на GitHub (истата датотека што ја инсталира Homebrew tap-от), во вистинска сесија во терминал, и излезот го копиравме без измени. Првата верзија на оваа страница (14 ноември 2026, apfel 1.16.0) ја покажуваше грешката со алатки со повеќе аргументи во задача 8; 1.18.0 ја поправа, па за оваа верзија ја извршивме повторно секоја команда. Каде што првиот излез беше погрешен, го оставивме погрешниот излез на страницата и го напишавме тоа. Единствените повторни извршувања беа за да најдеме одговори на кои не им треба уредување: едно резиме на веб-страница содржеше долга црта, која оваа страница не ја печати, па го извршивме повторно и го задржавме третото извршување. Примерот со говор го проверивме со запишување на аудиото во датотека, бидејќи тест-Mac-от немаше звучен излез. Демо-скриптите ги запиша apfel --demos од apfel 1.18.0.

Што пишуваа други за apfel: објавата на Show HN (3 април 2026, 743 поени), водич од Better Stack, статија од GIGAZINE и практична рецензија на danilchenko.dev.

Извори: README на apfel, CLI референцата, упатството за инсталација, демо-скриптите, apfel наспроти fm на Apple и листата на issues, прочитани на 15 ноември 2026.