AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
把 Mac 自带的 Apple Intelligence 模型变成命令行工具和本地 OpenAI 兼容服务。
apfel 是一个用 Swift 写的 macOS 命令行工具,调用 Apple FoundationModels 框架,把 Apple Silicon Mac 内置的本地模型暴露出来。它提供三种用法:UNIX 命令行工具、OpenAI 兼容的本地 HTTP 服务和交互式对话,全部在本机推理,不需要 API 密钥,也不走云端。
推荐指数
对 macOS 26+ 的 Apple Silicon 用户来说,这是零成本、零配置的本地模型接入方式,但受系统和芯片限制。
总 Star 排名
#980
雷达追踪的 3,958 个 AI 仓库中
创建于
2026
2026年3月25日
核心亮点
1完全本地推理
基于 Apple FoundationModels,不联网、不需要 API 密钥。
2OpenAI 兼容
--serve 启动本地服务,现有 OpenAI SDK 改 base_url 即可用。
3管道友好
支持 stdin 输入、文件附件、JSON 输出和退出码,方便写脚本。
4多模态附件
可附加 PDF、图片,做本地文本提取和 OCR。
5安装简单
brew install apfel 一条命令,无需 Xcode。
适用场景
脚本中调用模型
例如:git diff HEAD~1 | apfel -f CONVENTIONS.md "按规范审查这个 diff"
替换云端 API
例如:把 OpenAI SDK 的 base_url 指向 http://localhost:11434/v1 做本地测试
批量文本处理
例如:用 apfel --batch 对 JSONL 工单逐条分类
隐私敏感场景
例如:用 apfel -f report.pdf 在本地总结合同或报告
它是怎么工作的
第 1 步
调用系统模型
通过 Apple FoundationModels 框架使用 Mac 内置的本地模型。
第 2 步
命令行封装
apfel 把提示词、文件、管道输入整理成请求并输出结果。
第 3 步
本地服务
--serve 在本机 11434 端口提供 OpenAI 兼容的 /v1/chat/completions 接口。
第 4 步
工具调用
可通过 APFEL_MCP 挂载外部工具脚本,支持 tool calling。
快速上手
- 1
安装
用 Homebrew 安装,需 macOS 26+ 和 Apple Silicon。
brew install apfel - 2
试一条提示
直接命令行提问。
apfel "What is the capital of Austria?" - 3
启动本地服务
前台运行 OpenAI 兼容服务。
apfel --serve - 4
交互对话
进入 REPL 模式。
apfel --chat
适合谁
- 使用 macOS 26+ 的 Apple Silicon Mac 用户
- 想零成本本地调用模型的开发者
- 需要 OpenAI 兼容本地后端的项目
- 注重隐私、不愿把数据发到云端的人
不太适合
- Windows 或 Linux 用户
- Intel Mac 或系统版本低于 macOS 26 的用户
- 需要大上下文或强模型能力的生产场景
成熟度
- 活跃度最近一次推送在 2026-11,版本已到 1.19.0,迭代较频繁。
- 文档README 详细,含安装、示例和多语言翻译,另有 docs 目录。
- 社区约 6600 star、250 fork,开放 issue 仅 12 个。
- 上手难度brew 一条命令安装,但受 macOS 版本和芯片限制。
同类项目怎么选
- Ollama跨平台,需下载模型文件,不依赖 Apple Intelligence。
- llama.cpp通用本地推理框架,支持多平台和多种模型格式。
- LM Studio图形界面为主,模型需下载,非系统内置模型。
使用前注意
- · 仅支持 macOS 26 Tahoe+ 的 Apple Silicon,且需开启 Apple Intelligence。
- · 上下文窗口有限:macOS 26 和 M1/M2 为 4096 token,M3+ 在 macOS 27 上为 8192。
- · 模型能力受系统内置模型限制,不适合高要求任务。
- · MIT 许可,可自由使用和修改。
