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.