v1.18.0 · Без налаштувань · MIT
apfel
Безкоштовний ШІ, який уже є на вашому Mac.
macOS Tahoe постачається з LLM на 3 млрд параметрів. apfel відкриває до неї доступ із командного рядка однією командою brew install. Без завантаження моделей, без API-ключів, без налаштувань - просто працює.
$ brew install apfel
6.6k+ зірок на github.com/Arthur-Ficial/apfel
Потрібно: Apple Silicon · macOS Tahoe · увімкнений Apple Intelligence
Вперше з apfel? Почніть 60-секундний посібник (англійською)
Усе працює на вашому пристрої. Жодних мережевих запитів. Жодні дані не залишають ваш Mac.
Подивіться, як це працює.
Від brew install до відповіді ШІ за 12 секунд. Жодних налаштувань.
Нуль налаштувань. Нуль завантажень LLM. Нуль витрат на токени.
Інші локальні ШІ-інструменти чудові, але потребують завантаження моделей і налаштування. apfel не потрібно нічого - модель уже є на вашому Mac. Один brew install. Готово.
Модель під капотом
Apple ML ResearchТри інструменти. Одне встановлення.
CLI, OpenAI-сумісний сервер та інтерактивний чат. Усе з одного brew install. Без додаткових завантажень.
UNIX-інструмент
Дружить із пайпами й легко комбінується. Працює з jq, xargs і вашими shell-скриптами. stdin, stdout, вивід JSON, JSON за схемою через --schema, багатоходові діалоги з файлу повідомлень через --messages, вкладення файлів, правильні коди виходу.
Сервер OpenAI
Пряма заміна на localhost:11434. Спрямуйте на нього будь-який OpenAI SDK - і вперед. Chat Completions і Responses API, стрімінг, виклик інструментів, вивід за JSON Schema, CORS.
Інтерактивний чат
Багатоходові розмови з автоматичним керуванням контекстом. П'ять стратегій обрізання. Підтримка системного промпту. Щоб почати, просто введіть apfel у терміналі. Усе на вашому Mac.
Нативна підтримка MCP.
Дайте вбудованій моделі Apple інструменти. Будь-які.
Підключайте сервери інструментів через --mcp
apfel розмовляє мовою Model Context Protocol. Вкажіть будь-який MCP-сервер, і модель на пристрої отримає інструменти: математику, API, бази даних - усе, для чого можна написати сервер.
- Працює в усіх трьох режимах: CLI, сервер і чат
- Під час запуску сам знаходить інструменти через MCP tools/list
- Виклики інструментів розпізнаються й виконуються, а результати автоматично повертаються моделі
- Без прапорця --mcp - жодних накладних витрат: нуль зайвих токенів, нуль змін у шляху виконання
- У комплекті MCP-сервер калькулятора як proof of concept
- Віддалені MCP-сервери за URL -
--mcp https://...з необов'язковою автентифікацією Bearer-токеном
Як це працює.
Apple вбудувала LLM у кожен Mac. І вона просто лежить без діла. apfel дає їй вхідні двері - без жодних налаштувань.
Apple постачає LLM на пристрої
Починаючи з macOS 26 (Tahoe), кожен Mac на Apple Silicon має мовну модель у складі Apple Intelligence. Apple відкриває її через фреймворк FoundationModels - Swift API, що дає застосункам доступ до SystemLanguageModel. Увесь інференс виконується на Neural Engine і GPU. Без мережевих запитів, без хмари, без API-ключів. Модель просто є.
Але Apple використовує її лише для Siri
Із коробки модель на пристрої забезпечує роботу Siri, Writing Tools і системних функцій. Немає ні команди в терміналі, ні HTTP-ендпоінта, ні способу пропустити через неї текст пайпом. Фреймворк FoundationModels є, але щоб ним скористатися, треба написати застосунок на Swift. Саме це й робить apfel.
Що додає apfel
apfel - це бінарник на Swift 6.3, який обгортає LanguageModelSession і відкриває її трьома способами: як UNIX-інструмент командного рядка з stdin/stdout, як OpenAI-сумісний HTTP-сервер (на основі Hummingbird) і як інтерактивний чат із керуванням контекстом.
Він бере на себе те, чого не вміє сирий API Apple: правильні коди виходу, вивід JSON, вкладення файлів, п'ять стратегій обрізання контексту для малого контекстного вікна (4 096 токенів, 8 192 на Mac з M3 і новіших під macOS 27), справжній підрахунок токенів через SDK і перетворення схем інструментів OpenAI у нативний формат Apple Transcript.ToolDefinition.
Приватність закладено в основу.
Жодного HTTP-запиту під час роботи apfel. Кожне твердження нижче посилається на документацію самої Apple.
На пристрої. Працює офлайн.
Фреймворк FoundationModels працює повністю на Neural Engine вашого Apple Silicon. Не потрібні ні сервер, ні хмара, ні інтернет.
Ваші дані залишаються вашими.
Apple не збирає промпти, відповіді чи будь-які дані про використання під час інференсу на пристрої. Нічого не зберігається, нічого не надсилається.
Ніколи не йде на навчання.
Apple навчає свої базові моделі лише на ліцензованих і публічних даних. Ваші взаємодії ніколи не потрапляють у процес навчання.
apfel не додає жодного трекінгу.
Без аналітики, без телеметрії, без автоматичних перевірок оновлень, без звітів про збої, без «дзвінків додому». Єдиний мережевий запит apfel робить лише тоді, коли ви явно запускаєте apfel --update. Увесь код відкритий.
Потужні інструменти в комплекті.
Shell-скрипти в теці demo/. Спершу встановіть apfel, потім беріть ті, що потрібні.
cmd
Від звичайної мови до shell-команди. Скажіть, що потрібно, - отримайте команду.
oneliner
Ланцюжки пайпів з опису звичайними словами. awk, sed, sort, uniq - згенеровані за вас.
mac-narrator
Коментує системну активність вашого Mac, як документальний фільм про дику природу.
explain
Пояснює будь-яку команду, повідомлення про помилку чи фрагмент коду простими словами.
wtd
Що це за тека? Миттєво зорієнтуйтеся в будь-якому проєкті.
gitsum
Підсумовує останні git-коміти кількома реченнями.
30 корисних і крутих однорядковиків.
Кожну команду перевірено на справжньому Mac. Поєднуйте apfel з ps, lsof, du, vm_stat, git, pbpaste, sleep, pgrep, curl, say - хмарним ШІ така гнучкість недосяжна, бо вони не бачать ваших процесів, вашого буфера обміну, вашого git diff. А apfel бачить.
Що зараз з'їдає мій CPU.
$ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU"
-> Найбільше CPU використовує WindowServer: 42.6%.
Які застосунки слухають які порти.
$lsof -iTCP -sTCP:LISTEN -n -P | head -15 | apfel "list which apps own which ports as a table"
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
Який том заповнений найбільше.
$df -h | apfel "which volume is fullest, one sentence"
-> Найзаповненіший - /dev/disk3s1: 263Gi з 926Gi.
vm_stat, розшифрований простими словами.
$vm_stat | apfel "explain my memory usage in plain english, one sentence"
-> 349k сторінок активні, 266k зафіксовані (wired) - пам'ять суттєво зайнята.
Які теки тут займають найбільше місця.
$du -sh */ 2>/dev/null | sort -rh | head -5 | apfel "which folders are eating most disk, one sentence"
-> Лідирують Library (36G) і Downloads (604M).
Найбільші файли в цій теці.
$ls -laS | head -10 | apfel "what are the biggest files here, just file names"
-> apfel-quick-preview.png, og.png, translate-preview.png ...
Які застосунки зараз спілкуються з інтернетом.
$lsof -i -nP 2>/dev/null | grep ESTABLISHED | awk '{print $1, $9}' | head -10 | apfel "which apps are talking to the internet right now, short answer"
-> node → 157.240.253.60:443, claude.ex → 160.79.104.10:443, Google → 66.102.1.188:5228 ...
Стан батареї та залишок часу одним рядком.
$pmset -g batt | apfel "battery health and percent, one line"
-> Повністю заряджена, стан 100%, зараз активна.
Підсумок ваших останніх комітів простими словами.
$git log --oneline -20 | apfel "summarize what I have been working on"
-> Оновлення з v1.2.1 до v1.3.2, додано споріднені проєкти ...
Складіть однорядкову примітку до релізу з останніх комітів.
$git log --oneline -5 | apfel "write a one-line release note based on these commits"
-> Випущено v1.3.2: 5053 зірки, 783 тести, оновлення.
Виправте граматику того, що лежить у буфері обміну, і покладіть виправлене назад.
$pbpaste | apfel "fix grammar" | pbcopy
-> "i has went" стає "I went" - і знову в буфері.
Перекладіть вміст буфера японською і покладіть назад.
$pbpaste | apfel "translate to japanese" | pbcopy
-> Тепер у буфері обміну японський переклад.
Стисніть стіну тексту з буфера обміну до 3 пунктів.
$pbpaste | apfel "summarize in 3 bullets"
-> 3 стислих пункти у вашому терміналі.
Витягніть чіткі завдання з нотаток зустрічі в буфері обміну.
$pbpaste | apfel "extract just the action items as a clean bullet list, no other text" | pbcopy
-> "Sarah drafts Q3 budget", "email design team", ... знову в буфері.
Голосове сповіщення, коли довге завдання завершиться (тут - через 30 хвилин).
$sleep 1800 && apfel "tell me cheerfully my long task just finished, one short sentence" | say
-> Mac каже: "Ваше довге завдання щойно завершилося, чудова робота!"
Дочекайтеся, поки файл з'явиться в Downloads, і повідомте про це.
$until [ -e ~/Downloads/Report.pdf ]; do sleep 5; done; apfel "tell me my download just landed, one cheerful sentence" | say
-> Перевіряє кожні 5 с; щойно з'являється Report.pdf, Mac оголошує новину.
Дочекайтеся завершення довгого процесу й повідомте про це.
$while pgrep -q ffmpeg; do sleep 5; done; apfel "tell me cheerfully that my video encoding is done, one short sentence" | say
-> Перевіряє кожні 5 с; щойно ffmpeg завершується, Mac оголошує новину.
Кожні 30 хвилин - голосовий підсумок того, що ви щойно зробили.
$while sleep 1800; do git log --since="30 min ago" --oneline | apfel "summarize my last 30 minutes of work in one cheerful sentence" | say; done
-> Автостендап щопівгодини вголос, поки ви далі пишете код.
Кожні 15 хвилин - голосове попередження, якщо заряд батареї впаде нижче 20 відсотків.
$while sleep 900; do P=$(pmset -g batt | grep -oE "[0-9]+%" | head -1 | tr -d %); [ "$P" -lt 20 ] && apfel "battery just dropped to $P percent, write one short sentence that is friendly but super urgent telling me to plug in NOW" | say; done
-> Мовчить, доки заряд не просяде; тоді Mac уголос видає дружнє, але термінове попередження.
Стежте за URL, доки він не поверне 2xx, а тоді вголос відсвяткуйте деплой.
$until curl -sf https://staging.example.com/health >/dev/null; do sleep 30; done; apfel "tell me cheerfully that my deploy is live and the URL is responding, one short sentence" | say
-> Перевіряє кожні 30 с, доки staging не підніметься; Mac каже: "Деплой запущено, URL відповідає!".
Перефразуйте невимушену фразу ввічливо.
$echo "hey can u send me docs asap" | apfel "rephrase politely"
-> "Could you please share the documents at your earliest ..."
Зверніться до URL і дізнайтеся, що там відбувається, лише із заголовків.
$curl -sI https://github.com | apfel "explain what happens at this URL in one sentence, based on the HTTP headers"
-> GitHub віддає HTML-сторінку зі строгим кешуванням і заголовками безпеки.
Hacker News за сьогодні: підсумок в одному реченні, зачитаний уголос.
$curl -s https://news.ycombinator.com | grep titleline | sed "s/<[^>]*>//g" | apfel "summarize hacker news today in one cheerful sentence" | say
-> Mac зачитує головні новини дня одним стислим підсумком.
Поясніть JSON-блоб простими словами.
$echo '{"name":"alice","plan":"pro","credits":42}' | apfel "explain this JSON in one sentence"
-> Користувачка Alice на тарифі pro, кредитів: 42.
Математика без калькулятора.
$apfel "what is 15% tip on 87.50, just the number"
-> 13.13
Згенеруйте regex, не виходячи з термінала.
$apfel "regex for a valid email address, just the regex"
-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Попросіть bash-однорядковик, який ви забули.
$apfel "give me one find command that lists files larger than 100MB, just the bash command"
-> find / -type f -size +100M
Поясніть загадкову команду замість того, щоб гадати.
$apfel "explain the command tar -xzvf file.tar.gz in one sentence"
-> Розпаковує стиснутий gzip tar-архів у поточну теку.
Забули точну команду git? Просто запитайте.
$apfel "git command to uncommit but not unedit my last commit, just the command"
-> git reset --soft HEAD~1
Розшифруйте чужий regex одним реченням.
$apfel "explain this regex in one sentence: ^\d{3}-\d{4}$"
-> Префікс з 3 цифр, дефіс і ще 4 цифри - формат телефонного номера в США.
Перетворіть довільно записану дату на ISO 8601.
$apfel "convert 'Sat Apr 27 2026 11:30' to ISO 8601 (YYYY-MM-DDTHH:MM:SS), reply only with the converted string"
-> 2026-04-27T11:30:00+00:00
Підсумуйте цілий файл у 3 пунктах.
$apfel -f README.md "summarize in 3 bullets"
-> 3 пункти: призначення, встановлення, використання.
Сумісний з OpenAI.
Змініть один URL. Код не чіпайте.
Пряма заміна
apfel розмовляє мовою OpenAI API. Будь-яка клієнтська бібліотека, будь-який фреймворк, будь-який інструмент, що працює з OpenAI, може натомість працювати з ШІ на вашому Mac. Просто змініть base URL.
- ✓ POST /v1/chat/completions
- ✓ POST /v1/responses (Responses API)
- ✓ Стрімінг (SSE)
- ✓ Виклик інструментів / function calling
- ✓ GET /v1/models
- ✓ response_format: json_object, json_schema
- ✓ частини image_url як data URL (macOS 27)
- ✓ temperature, max_tokens, seed
- ✓ CORS для браузерних клієнтів
from openai import OpenAI # Just change the base_url. That's it. client = OpenAI( base_url="http://localhost:11434/v1", api_key="unused" # no auth needed ) resp = client.chat.completions.create( model="apple-foundationmodel", messages=[{ "role": "user", "content": "What is 1+1?" }], ) print(resp.choices[0].message.content)
Та сама модель, що й у fm від Apple. Інше призначення.
У macOS 27 є fm - власний інтерфейс командного рядка Apple до вбудованої моделі. Ось де їхні шляхи розходяться.
| apfel | Apple fm | |
|---|---|---|
| Працює на | macOS 26 і 27, один бінарник | лише macOS 27 |
| Встановлення | brew install apfel | Уже є (один раз sudo fm license) |
| Клієнти OpenAI працюють без змін | Так: JSON за замовчуванням, usage, max_tokens враховується, помилки зіставлено | Стрімить, якщо не попросити інакше, ігнорує max_tokens, 500 при спрацюванні запобіжників |
| Виклик інструментів і MCP | Нативні виклики інструментів, локальні й віддалені MCP-сервери | Немає (tools пропускає токени шаблону у відповідь) |
| Скрипти | --code, -o json, 9 кодів виходу, --count-tokens --strict | Звичайний текст, код виходу 0 або 1 |
| Файли на вході | Текст, PDF, зображення: OCR-текст на обох ОС, а на macOS 27 ще й саме зображення для моделі | Зображення для моделі, плюс вбудовані інструменти OCR і штрихкодів |
| Збереження сесій чату | Ні | Іменовані транскрипти, --resume |
| Швидкість | Та сама модель на тому самому Mac, те саме контекстне вікно (4 096 токенів на цьому M2, 8 192 на M3 і новіших), кількість токенів однакова. Разовий промпт: 0,35 с проти 0,30 с. | |
Коротка історія. apfel вийшов першим: перший коміт і v0.1.0 - 24 березня 2026, перший реліз на GitHub - 31 березня 2026, головна сторінка Hacker News - у квітні. Apple анонсувала fm на WWDC 8 червня 2026 і 14 вересня 2026 випустила його разом із macOS 27. Обидва працюють з тією самою вбудованою моделлю через той самий фреймворк FoundationModels; apfel - відкритий варіант, який до того ж працює і на macOS 26.
Кожен рядок виміряно на macOS 27.0.1 (Apple M2, 24 ГБ) 2026-10-05, і його перевимірюють для кожного релізу apfel. На повній сторінці - перевірки сервера, таблиця збігу підрахунку токенів і всі команди, щоб це відтворити.
Популярний на GitHub.
Від нуля до 6,610 зірок - і це не межа.
Starred by engineers from Apple, Google, VMware, NVIDIA, and PlayStation.
Поставити зірку на GitHubДані станом на
Як почати.
Без завантаження моделей. Без реєстрацій. Без API-ключів. Лише це.
Homebrew
$ brew install apfel $ apfel "Hello, Mac"
Збірка з вихідного коду
$ git clone https://github.com/Arthur-Ficial/apfel.git $ cd apfel && make install
Дерево apfel.
Дедалі більша родина нативних інструментів для macOS на основі apfel - і споріднені проєкти, що приносять у термінал інші фреймворки Apple.
apfel-chat
Чат-клієнт для macOS із кількома розмовами. Стрімінг markdown, голосовий ввід і вивід, аналіз зображень - повністю приватно, без API-ключів, без хмари.
SwiftUI Продакшн
apfelpad
Нотатник із формулами для роздумів. Введіть =apfel("summarize this") у своєму markdown і дивіться, як відповідь з'являється просто в тексті. Як =SUM, тільки для мови.
apfel-quick
Миттєвий ШІ-оверлей. Натисніть Ctrl+Space будь-де, введіть запитання - і відповідь потече у ваш буфер обміну. Без Wi-Fi, без акаунта, без рахунків.
SwiftUI Нове
apfel-gui
Нативний налагоджувальний GUI для macOS на SwiftUI. Спілкуйтеся з Apple Intelligence, переглядайте запити й відповіді, логи, розпізнавання та синтез мовлення - усе на пристрої.
SwiftUI
apfel-clip
ШІ-дії з буфером обміну з рядка меню. Натисніть cmd+shift+V на будь-якому тексті - виправити граматику, перекласти, пояснити код, підсумувати. Повністю на пристрої, без API-ключів.
SwiftUI Продакшн
apfel-mcp
Дайте apfel доступ до вебу та ваших файлів. Чотири невеликі MCP-інструменти - url-fetch, ddg-search, search-and-fetch і файловий рідер у режимі лише читання - кожен ужатий під мале контекстне вікно apfel (4 096 токенів на більшості Mac, 8 192 на M3 і новіших з macOS 27).
Python Нове
apfel-run
Крихітна UNIX-обгортка, яка дає apfel постійний реєстр MCP. Вмикайте й вимикайте MCP-сервери за назвою у звичайному текстовому конфігу. Переживає перезапуски, без GUI, без демона.
Shell Нове
apfel-server-kit
Спільний Swift-пакет, на якому тримається екосистема. Знаходить локальний процес apfel --serve, запускає його і стрімить із нього. Хребет, з яким спілкується кожен SwiftUI-застосунок apfel.
Swift Нове
auge
Споріднений проєкт. apfel відповідає за мову, auge - за зір. Один CLI для OCR, класифікації зображень, штрихкодів і розпізнавання облич - на 100% на пристрої через фреймворк Vision від Apple. Без API-ключів, без хмари.
Swift Споріднений проєкт
translate
Споріднений проєкт. UNIX-фільтр плюс HTTP-сервер на заміну DeepL, LibreTranslate і Google v2 - на основі вбудованого фреймворку Translation від Apple. На 100% на пристрої, жорстко гарантовано NetworkGuard. Без API-ключів, без хмари.
Swift Споріднений проєктЧасті запитання.
Запитання зібрано з Hacker News і Reddit.
Яка версія macOS потрібна?
Чи має apfel доступ до моїх особистих даних?
Чи залишають якісь дані мій Mac?
Модель: фреймворк FoundationModels від Apple працює без підключення до інтернету і виконується повністю на Neural Engine. Ваші промпти й відповіді ніколи не залишають пристрій. Дані користувачів ніколи не використовуються для навчання.
Інструмент: apfel так це й залишає. Без аналітики, без телеметрії, без трекінгу, без автоматичних перевірок оновлень, без звітів про збої, без «дзвінків додому». Відкритий код, який будь-хто може перевірити.
Яке контекстне вікно?
apfel --model-info показує вікно, яке реально є на вашому Mac. Чудово для shell-скриптів, підсумків і перетворення тексту. Не для довгих розмов чи великих документів.У чому модель сильна? Де їй важко?
Слабше: математика, знання фактів, довгі розмови, генерація складного коду.
Модель радше відмовить, ніж вигадуватиме. Це свідомий вибір Apple.
Чи безпечний режим сервера?
--token), перевірка origin, ендпоінти логів лише в режимі налагодження. Деталі в server-security.md.Чи потрібно вмикати Apple Intelligence?
Як оновити apfel?
apfel --update. Визначає спосіб встановлення, шукає новішу версію і питає перед оновленням. Вручну: brew upgrade apfel або git pull && make install.Яку модель він використовує?
Чим apfel відрізняється від Ollama чи LM Studio?
Чи підтримує apfel MCP і виклик інструментів?
--mcp <server>, щоб підключити інструменти. Посібник із виклику інструментів.Чим apfel відрізняється від власного CLI fm від Apple у macOS 27?
fm - інтерфейс командного рядка Apple до тієї самої вбудованої моделі. apfel додає OpenAI-сумісний сервер із викликом інструментів, MCP, вивід за JSON Schema, зображення на вході як data URL, чесні коди виходу та підтримку macOS 26. Порівняння пліч-о-пліч: apfel проти fm.Чи є в apfel телеметрія або «дзвінки додому»?
apfel --update: він перевіряє в Homebrew, чи є новіша версія. Відкритий код, який будь-хто може перевірити.Хто це створив?
Співмейнтейнер - Arthur Ficial, екземпляр OpenClaw, що працює на Claude Opus від Anthropic. Активно розробляється з Claude Code і Codex. Завжди в режимі high thinking / high effort.
Початок: 24 березня 2026.