Arthur-Ficial GitHub avatar

apfel

Swift
Mac 本地 AI 命令行Arthur-Ficial最近推送 2026年11月18日
模型推理与部署MIT6,6142522 issues

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

把 Mac 自带的 Apple Intelligence 模型变成命令行工具和本地 OpenAI 兼容服务。

apfel 是一个用 Swift 写的 macOS 命令行工具,调用 Apple FoundationModels 框架,把 Apple Silicon Mac 内置的本地模型暴露出来。它提供三种用法:UNIX 命令行工具、OpenAI 兼容的本地 HTTP 服务和交互式对话,全部在本机推理,不需要 API 密钥,也不走云端。

推荐指数

4.0

对 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. 第 1 步

    调用系统模型

    通过 Apple FoundationModels 框架使用 Mac 内置的本地模型。

  2. 第 2 步

    命令行封装

    apfel 把提示词、文件、管道输入整理成请求并输出结果。

  3. 第 3 步

    本地服务

    --serve 在本机 11434 端口提供 OpenAI 兼容的 /v1/chat/completions 接口。

  4. 第 4 步

    工具调用

    可通过 APFEL_MCP 挂载外部工具脚本,支持 tool calling。

快速上手

  1. 1

    安装

    用 Homebrew 安装,需 macOS 26+ 和 Apple Silicon。

    brew install apfel
  2. 2

    试一条提示

    直接命令行提问。

    apfel "What is the capital of Austria?"
  3. 3

    启动本地服务

    前台运行 OpenAI 兼容服务。

    apfel --serve
  4. 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 许可,可自由使用和修改。

主题标签

apple-intelligenceapple-siliconclifoundationmodelsllmmacosmacos-26on-deviceswifthomebrewopenai-compatibletool-callingunix