macOS Tahoe 內建一個擁有 30 億參數的語言模型。apfel 讓你只需透過一行 brew install 指令即可使用命令列介面。無需下載模型、無需 API 金鑰、無需設定,直接可用。
在 GitHub 上已有超過 6200 顆星的支持。
需求條件:Apple Silicon、macOS Tahoe、啟用 Apple Intelligence。
所有運算皆在你的裝置上執行,無需網路連線,資料不會離開你的 Mac。
從安裝到 AI 輸出只需 12 秒,完全無需設定。
其他本地 AI 工具雖然不錯,但都需要下載模型和設定。apfel 不需要任何東西,模型已經存在你的 Mac 裡。只要一行 brew install,安裝完成。
apfel 提供命令列工具、相容 OpenAI 的伺服器,以及互動式聊天介面,全部只需一行安裝,無需額外下載。
支援管線操作與組合,能與 jq、xargs 及你的 shell 腳本搭配使用,支援標準輸入、標準輸出、JSON 輸出、檔案附件及正確的退出代碼。
可作為 localhost:11434 的替代方案,任何 OpenAI SDK 指向它即可使用,支援串流、工具呼叫、CORS 及多種回應格式。
支援多輪對話並自動管理上下文,提供五種截斷策略與系統提示支援,全部在你的 Mac 上執行。
apfel 支援 Model Context Protocol,能連接任何 MCP 伺服器,讓本機模型擁有數學運算、API、資料庫等工具功能。
Apple 在每台 Mac 內建了大型語言模型,它就靜靜地存在那裡。apfel 為它開啟一扇門,且完全無需設定。
從 macOS 26(Tahoe)開始,每台 Apple Silicon Mac 都包含一個語言模型,作為 Apple Intelligence 的一部分。Apple 透過 FoundationModels 框架提供 Swift API,讓應用程式能存取 SystemLanguageModel。所有推論皆在神經引擎與 GPU 上執行,無需網路、無需雲端、無需 API 金鑰,模型就存在那裡。
開箱即用的本機模型支援 Siri、寫作工具及系統功能,但沒有終端指令、HTTP 端點或管線文字處理方式。FoundationModels 框架存在,但你必須撰寫 Swift 應用程式才能使用。這正是 apfel 的功能所在。
apfel 是一個 Swift 6.3 編譯的二進位檔,包裝 LanguageModelSession,並以三種方式提供服務:UNIX 命令列工具(支援 stdin/stdout)、相容 OpenAI 的 HTTP 伺服器(基於 Hummingbird)以及具上下文管理的互動聊天介面。
它處理 Apple 原生 API 無法做到的功能:正確的退出代碼、JSON 輸出、檔案附件、五種上下文截斷策略(因應 4096 令牌限制)、透過 SDK 計算真實令牌數,以及將 OpenAI 工具結構轉換為 Apple 原生的 Transcript.ToolDefinition 格式。
使用 apfel 時不會有任何 HTTP 呼叫。以下所有說明均可在 Apple 官方文件中查證。
FoundationModels 框架完全在你的 Apple Silicon 神經引擎上執行,無需伺服器、雲端或網際網路連線。
Apple 不會收集本機推論的提示、回應或任何使用資料。沒有資料被儲存或傳送。
Apple 的基礎模型訓練僅使用授權及公開資料,你的互動不會成為訓練資料的一部分。
無分析、無遙測、無自動更新檢查、無崩潰回報、無回傳行為。apfel 唯一的網路呼叫是你明確執行 apfel --update 時。整個程式碼庫皆為開源。
demo/ 資料夾內有 shell 腳本。先安裝 apfel,再選擇你想要的腳本。
自然語言轉換為 shell 指令。說出你想做的事,得到對應指令。
從純英文產生管線指令,如 awk、sed、sort、uniq。
像自然紀錄片一樣敘述你的 Mac 系統活動。
用簡單英文解釋任何指令、錯誤訊息或程式碼片段。
這個目錄是什麼?即時為任何程式碼庫提供專案導覽。
簡述近期 git 提交紀錄。
所有指令均在真實 Mac 上測試。apfel 可與 ps、lsof、du、vm_stat、git、pbpaste、sleep、pgrep、curl、say 等指令串接,這是雲端 AI 無法比擬的,因為它們無法存取你的程序、剪貼簿或 git 差異。
例如:
-> WindowServer 使用最高 CPU,佔 42.6%。
哪些應用程式監聽哪些埠口。
-> 11434 fichten, 18789 node, 5000 ControlCenter ...
/dev/disk3s1 是最滿的,使用 263Gi / 926Gi。
活躍頁面 349k,wired 頁面 266k,記憶體使用量顯著。
哪些資料夾佔用最多磁碟空間。
-> Library 36G,Downloads 604M 為主。
檔案如 apfel-quick-preview.png、og.png、translate-preview.png ...
哪些應用程式正在連網。
-> node → 157.240.253.60:443, claude.ex → 160.79.104.10:443, Google → 66.102.1.188:5228 ...
電池狀態:充飽電,健康度 100%,目前活躍中。
用簡單英文回顧你最近的提交。
-> 從 v1.2.1 更新到 v1.3.2,新增姊妹專案 ...
從最近提交草擬一句發行說明。
-> 發布 v1.3.2,擁有 5053 顆星、783 個測試、更新內容。
修正剪貼簿中的文法錯誤,並將修正結果放回剪貼簿。
-> "i has went" 變成 "I went",放回剪貼簿。
將剪貼簿內容翻譯成日文,並放回剪貼簿。
-> 剪貼簿現在包含日文翻譯。
將剪貼簿中的大量文字摘要成三個重點。
-> 在終端機中顯示三個精簡重點。
從會議記錄中提取清晰的行動項目,放回剪貼簿。
-> "Sarah drafts Q3 budget", "email design team" 等。
當長時間任務完成時,透過語音通知你(例如 30 分鐘後)。
-> Mac 語音提示:「你的長時間任務已完成,做得好!」
等待檔案出現在 Downloads 資料夾,然後語音通知。
-> 每 5 秒輪詢;當 Report.pdf 出現時,Mac 語音播報。
等待長時間執行的程序結束,然後語音通知。
-> 每 5 秒輪詢;當 ffmpeg 結束時,Mac 語音播報。
每 30 分鐘,用語音摘要你剛完成的工作。
-> 每半小時自動語音報告,讓你持續編碼。
每 15 分鐘,當電池低於 20% 時語音警告。
-> 電池低於門檻時,Mac 會大聲提醒。
監控 URL 直到回傳 2xx,然後語音慶祝部署成功。
-> 每 30 秒輪詢直到測試環境上線,Mac 語音播報「你的部署已上線,URL 正常回應!」。
將隨意語句改寫成禮貌用語。
-> "Could you please share the documents at your earliest ..."
只看標頭就詢問 URL 狀態。
-> GitHub 回傳帶有嚴格快取與安全標頭的 HTML 頁面。
將 Hacker News 今日熱門新聞一句話摘要並語音播報。
-> Mac 以簡潔摘要播報當日頭條。
用簡單英文解釋 JSON 資料。
-> 一位名為 Alice 的用戶,使用專業方案,擁有 42 點數。
在終端機內產生正則表達式。
-> ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
詢問你忘記的 bash 一行指令。
解釋神秘指令,而非猜測。
-> 解壓並提取 gzipped tarball 到當前目錄。
忘記確切 git 指令?直接詢問。
用一句話解讀別人的正則表達式。
-> 匹配三位數前綴、一個連字號及四位數——美國電話格式。
將隨意日期字串轉換為 ISO 8601 格式。
將整個檔案摘要成三個重點。
-> 三個重點涵蓋範圍、安裝與使用。
apfel 支援 OpenAI API,任何客戶端庫、框架或工具只要支援 OpenAI,都能改指向你的 Mac AI。只需更改基底 URL。
從零開始,星數已達 6228 並持續增加。
獲得 Apple、Google、VMware、NVIDIA 與 PlayStation 工程師的支持。
無需下載模型、無需註冊、無需 API 金鑰,只有 apfel。
一系列基於 apfel 的原生 macOS 工具,以及姊妹專案將其他 Apple 框架帶入終端機。
多對話 macOS 聊天客戶端,支援串流 Markdown、語音輸入輸出、影像分析,完全私密,無需 API 金鑰或雲端。
公式筆記本,輸入 =apfel("summarize this") 即可在 Markdown 中串流摘要,類似 =SUM 但用於語言。
即時 AI 覆蓋,按 Ctrl+Space 任意位置輸入問題,答案串流至剪貼簿,無需 Wi-Fi、帳號或費用。
原生 macOS SwiftUI 除錯 GUI,與 Apple Intelligence 聊天,檢查請求與回應、日誌、語音轉文字、文字轉語音,全在本機。
從選單欄啟用 AI 剪貼簿操作,按 cmd+shift+V 修正文法、翻譯、解釋程式碼、摘要,完全本機執行,無需 API 金鑰。
給 apfel 網頁與檔案支援。四個小型 MCP 工具:url-fetch、ddg-search、search-and-fetch 及唯讀檔案閱讀器,皆適用於 apfel 的 4096 令牌上下文視窗。
小型 UNIX 包裝器,為 apfel 提供持久 MCP 註冊表,能從純文字設定檔啟用或停用 MCP 伺服器,重啟後仍保留,無 GUI、無守護程序。
共享 Swift 套件驅動生態系統,發現、啟動並串流本地 apfel --serve 程序,是所有 SwiftUI apfel 應用的核心。
姊妹專案:apfel 處理語言,auge 處理視覺。單一 CLI 支援 OCR、影像分類、條碼及人臉偵測,100% 本機透過 Apple Vision 框架,無需 API 金鑰或雲端。
姊妹專案:UNIX 過濾器及 DeepL、LibreTranslate、Google v2 的替代 HTTP 伺服器,基於 Apple 本機翻譯框架,100% 本機,NetworkGuard 強制執行,無需 API 金鑰或雲端。
問題來源於 Hacker News 與 Reddit。
由 Arthur-Ficial 在 Apple Silicon 平台開發。