Arthur-Ficial/apfel

项目概览

apfel 将 Apple Silicon Mac 内置的 FoundationModels LLM 暴露为 UNIX CLI 工具和本地 OpenAI 兼容服务器。推理过程在设备端运行，无需 API 密钥、云服务或网络连接。

项目类型

模型运行

应用场景

聊天助手 · 编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 需要纯本地数据边界、不产生 API 费用且熟悉 UNIX 工作流的 Apple Silicon Mac 用户。

核心能力

• 支持管道友好的命令行界面，可处理单次提示、管道输入、文件附加并生成输出。
• 提供本地 OpenAI 兼容的服务器，作为即插即用的 http://localhost:11434/v1 后端。
• 提供交互式 REPL 环境，用于测试提示词或 MCP 服务器。
• 通过 --mcp 标志附加 Model Context Protocol 服务器；apfel 会自动发现、调用并返回结果。
• 支持将文件、PDF 或图像直接附加到提示中，利用设备端算力进行文本提取、OCR 和图像理解。
• 通过引导生成技术，保证输出符合 Schema 验证的 JSON 数据。
• 在所有上下文中支持原生 ToolDefinition 和用于工具调用的 JSON 检测。
• 二进制文件中内置了包装 apfel 的真实 shell 脚本（如 cmd、oneliner、mac-narrator 等）。

限制与风险

• 输入和输出合计的上下文窗口上限为 4096 tokens。
• 仅支持 macOS 26+ 且必须是 Apple Silicon 架构。
• 仅内置一个设备端模型（约 3B 参数），且无法更改配置。
• Apple 内置的安全系统可能会阻止部分良性提示词，在评估时需注意此风险。

如何开始

• 安装难度评级为 easy，无需安装 Xcode。通过运行 'brew install apfel' 安装后，即可使用 'apfel "What is the capital of Austria?"' 进行首次体验。

核验依据

• README: Apple Silicon Macs ship a built-in LLM via [Apple FoundationModels](https://developer.apple.com/documentation/foundationmodels). `apfel` exposes it as a UNIX tool and a local Open…
• README: macOS 26 Tahoe+, Apple Silicon (M1+), [Apple Intelligence enabled](https://support.apple.com/en-us/121115). ```bash brew install apfel ```
• README: [](https://github.com/Arthur-Ficial/apfel)
• README: **Base URL:** `http://localhost:11434/v1`
• README: `apfel --chat` is a small REPL for testing prompts or MCP servers. For a GUI chat app, see [apfel-chat](https://github.com/Arthur-Ficial/apfel-chat).

内容核验时间：