apfel - праект .

Кіраўніцтва · праверана 15 лістапада 2026

Кіраўніцтва па ШІ apfel

Першы адказ ад ШІ, які ўжо ёсць на вашым Mac, за 60 секунд. Потым 11 задач, з якімі ён добра спраўляецца, кожная гатовая да капіявання разам з сапраўдным вывадам, і сумленны спіс таго, чаго ён не ўмее.

Сапраўдны запіс тэрмінала без мантажу: 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 у Сістэмныя налады > 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 у Сістэмных наладах і пачакайце, пакуль мадэль спампуецца (паводле інструкцыі па ўсталяванні, гэта 3-4 ГБ). Мова вашага Mac і мова Siri павінны быць адной і той жа падтрымліванай мовай. Пакуль мадэль недаступная, apfel завяршаецца з кодам выхаду 5.

Далей: задачы ніжэй. Кожная пачынаецца з таго, што ў вас будзе праз дзве хвіліны.

1. Спытайце Mac пра яго самога

За 2 хвіліны ў вас будзе: зразумелыя адказы пра ваш дыск, CPU і памяць, проста з тых каманд, якія вы ўжо ведаеце.

Калі каманда ў тэрмінале выдае сцяну лічбаў, я хачу адказ у адзін радок, каб дзейнічаць, не чытаючы man-старонку.

Перадайце пайпам у 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, а пайп яго не перадае. apfel пра гэта паведаміць: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

Далей: той самы прыём працуе з git log, lsof, pmset -g batt, лог-файламі і ўсім, што выводзіць тэкст.

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 ставіць тэкст з пайпа першым, а вашу інструкцыю пасля яго (зыходны код). З кароткай інструкцыяй "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-аліяс або дзеянне "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.

Калі не працуе: код выхаду 4 азначае, што файл занадта доўгі для мадэлі (гл. абмежаванні). Код выхаду 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" ("10 найбуйнейшых файлаў у бягучай тэчцы") яна вывела 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"]
}

Потым перадайце тэкст пайпам з --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", а апрацоўка ідзе далей.

Калі не працуе: apfel падтрымлівае частку JSON Schema (аб'екты, радкі, enum, лікі, булевыя значэнні, масівы, лакальныя $ref). Калі сустракаецца непадтрымліванае ключавое слова, напрыклад pattern, apfel спыняецца з кодам выхаду 2 і называе яго; спіс ёсць у дакуменце пра сумяшчальнасць API.

6. Аўтаматызуйце свой дзень: git, голас і гатовыя скрыпты

За 2 хвіліны ў вас будзе: зводка вашай нядаўняй працы, Mac, які ўголас паведамляе, калі доўгая задача скончылася, і восем гатовых shell-скрыптоў з ШІ.

Калі я пераключаюся паміж задачамі або чакаю зборку, я хачу мець невялікія аўтаматызацыі, якія тлумачаць і паведамляюць, каб не сачыць увесь час за тэрміналам.

Падсумуйце, што вы рабілі, з любога 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 скажа, калі нешта скончылася. Перадайце адказ пайпам у 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, я хачу бясплатны лакальны эндпоінт, каб распрацоўваць і тэставаць без ключоў, рахункаў і адпраўкі даных вонкі.

Запусціце сервер у адной укладцы тэрмінала:

Тэрмінал
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 і стары эндпоінт /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-сервер: шлях да лакальнага скрыпта або URL https://.

Інструменты з некалькімі іменаванымі аргументамі таксама працуюць. Вось калькулятар з рэпазіторыя 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 карыстаюцца лакальным эндпоінтам кожны дзень, я хачу, каб ён быў заўсёды ўключаны, каб больш не запускаць яго ўручную.

Тэрмінал
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" у 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 Нататнік, дзе ШІ - гэта формула ў ячэйцы 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 Тэгі, тэмы і эмоцыі для любога тэксту з пайпа 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 ГБ або больш пад 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 спыняецца з кодам выхаду 3 і паведамленнем The request was blocked by Apple's safety guardrails. Перафармулюйце або дадайце --permissive для творчых тэкстаў і дакументаў; што гэта мяняе, тлумачыць дакумент пра ахоўныя фільтры. Падчас запускаў для гэтай старонкі мы на блакаванне не натыкнуліся.

Адказы кожны раз розныя. Тут паказаны сапраўдныя вывады, кожны з аднаго запуску. У вас фармулёўкі будуць іншымі. Для больш паўтаральных адказаў выкарыстоўвайце --temperature 0; apfel не абяцае аднолькавага вываду паміж запускамі або абнаўленнямі macOS (палітыка стабільнасці).

Хуткасць: большасць адказаў у нашых запусках прыходзіла за 1-2 секунды. Зводка вэб-старонкі з інструментам MCP заняла 8 секунд.

Патрабаванні строгія: толькі Apple Silicon, macOS 26 або навейшая, уключаны Apple Intelligence і адна з 15 моў, якія пералічвае --model-info. На Mac з Intel ён не працуе.

Калі нешта не працуе

apfel паведамляе пра праблемы кодам выхаду, каб скрыпты маглі на іх рэагаваць. Праверыць яго можна праз echo $? адразу пасля каманды.

Код выхаду або памылка Што азначае Што рабіць
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 Эндпоінт, якога мадэль на прыладзе не падтрымлівае (embeddings, /v1/completions) Выкарыстоўвайце /v1/chat/completions
piped input was empty Каманда пісала ў stderr command 2>&1 \| apfel "..."

Усё яшчэ не атрымліваецца? Пашукайце або адкрыйце issue на GitHub.

Хто гэта зрабіў і як мы тэставалі

apfel - бясплатны праект з адкрытым кодам (ліцэнзія MIT), праект franzai ад Franz Enzenhofer. Franz падтрымлівае яго разам з Arthur Ficial, сваім ШІ-асістэнтам, які і напісаў гэтае кіраўніцтва. Паколькі гэтую старонку напісалі стваральнікі apfel, мы пералічылі кожны збой, які бачылі, а не схавалі іх.

Як мы тэставалі: 15 лістапада 2026 мы запусцілі кожную каманду з гэтай старонкі на MacBook Air M2 (24 ГБ) з macOS 27.0.1 (зборка 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 і трэкер issue, прачытаныя 15 лістапада 2026.