apfel - проєкт .

Посібник · перевірено 15 листопада 2026

Посібник з apfel AI

Перша відповідь від ШІ, який уже є на вашому 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 хвилини у вас є: відповіді звичайною мовою про ваш диск, процесор і пам'ять просто з команд, які ви вже знаєте.

Коли команда в терміналі видає стіну цифр, я хочу відповідь в один рядок, щоб діяти, не читаючи 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" вона вивела 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 працює без змін. Відрізняються лише базова 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 означає, що сервер не запущено. Ембединги та старий ендпоінт /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 не працює.

Коли щось не працює

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 Ендпоінт, якого модель на пристрої не підтримує (ембединги, /v1/completions) Використовуйте /v1/chat/completions
piped input was empty Команда писала в stderr command 2>&1 \| apfel "..."

Досі не виходить? Пошукайте або відкрийте issue на GitHub.

Хто це зробив і як ми тестували

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

Як ми тестували: 15 листопада 2026 ми виконали кожну команду з цієї сторінки на MacBook Air M2 (24 ГБ) з macOS 27.0.1 (збірка 26A434). Ми використовували підписаний бінарник apfel 1.18.0 з релізу на GitHub (той самий файл, який встановлює tap Homebrew) у справжній сесії термінала й копіювали вивід без змін. Перша версія цієї сторінки (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.