apfel

Mac 上免费本地 AI，无需联网，即刻体验。

apfel 是一个专为 Mac 用户设计的免费 AI 工具，它利用 Apple Intelligence 框架在本地设备上运行，无需 API 密钥、云服务或额外下载。项目提供三种使用方式：命令行工具、兼容 OpenAI 的本地服务器以及交互式聊天界面，让用户能在 Mac 上直接体验 AI 能力。它解决了隐私敏感用户对云端 AI 的顾虑，以及开发者对本地 AI 服务集成的需求，核心能力包括快速启动、无缝集成和离线运行。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6433

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队Arthur-Ficial

所属国家

官网地址https://apfel.franzai.com

GitHubhttps://github.com/Arthur-Ficial/apfel

定价模式free

价格说明完全免费，本地运行，无需API密钥或云端服务。

访问状态

是否开源是

开源协议MIT

主要语言Swift

技术栈/模型apple-intelligence,apple-silicon,cli,foundationmodels,homebrew,llm,macos,macos-26,on-device,openai-compatible,swift,tool-calling,unix

GitHub 星标★ 6433

30天Star增速

HF 下载量

上线时间2026-03-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

macOS 26 Tahoe 或更高版本
Apple Silicon 芯片（M1 及以上）
已开启 Apple Intelligence
使用 Homebrew 安装（或具备 macOS 26.4 SDK / Swift 6.3 的 Command Line Tools 用于源码构建）

安装与启动步骤

1确认设备环境

在 Mac 上确认系统为 macOS 26 Tahoe+、芯片为 Apple Silicon（M1 起），并在系统设置中开启 Apple Intelligence，否则无法运行。
2安装 apfel

通过 Homebrew 一行安装，装完即可全局使用 apfel 命令，无需 API 密钥或额外下载模型。
```
brew install apfel
```
3命令行模式试用

直接传入提示词获取答案；提示词含 ! 时用单引号包裹，避免 zsh/bash 的历史展开。
```
apfel "What is the capital of Austria?"
```
4管道输入文本

也可把其他命令的输出通过管道交给 apfel 处理，适合脚本中调用。
```
echo "text" | apfel
```
5启动交互式聊天

进入 REPL 交互界面，可以连续多轮对话，适合手动探索本地模型能力。
```
apfel --chat
```
6启动本地 OpenAI 兼容服务

以服务模式运行后，会得到一个本地 http://localhost:11434/v1 端点，可直接作为 OpenAI SDK 的 base URL 使用。
```
apfel --serve
```
7从源码构建（可选）

不装 Homebrew 时可用源码构建，需要 macOS 26.4 SDK / Swift 6.3 的 Command Line Tools，无需完整 Xcode。
```
git clone https://github.com/Arthur-Ficial/apfel.git && cd apfel && make install
```
8安装可选配置层（可选）

apfel 本身没有配置文件，如需 TOML 配置（多 MCP、多 profile）可安装 apfel-run 包装器。
```
brew install Arthur-Ficial/tap/apfel-run
apfel-run config init
```

如何确认成功

执行 apfel "Hello, Mac!" 能直接返回回答即安装成功；服务模式下访问 http://localhost:11434/v1 可连通即启动成功。

常见问题

Q：需要 API 密钥或联网吗？

A：不需要。apfel 使用 macOS 自带的 Apple FoundationModels，100% 在本机运行，不需要 API 密钥、云服务或额外下载模型。

Q：支持哪些 Mac？

A：需要 Apple Silicon（M1 及以上）且系统为 macOS 26 Tahoe 或更高，同时必须在系统设置中开启 Apple Intelligence。

Q：上下文窗口有多大？

A：macOS 26 上为 4096 tokens，macOS 27 上为 8192 tokens，运行时会自动读取实际值。

Q：怎么更新到新版本？

A：Homebrew 安装的用户执行 brew upgrade apfel 即可升级。

Q：提示词里有感叹号会报错？

A：! 在 zsh/bash 中会触发历史展开，用单引号包裹提示词即可，例如 apfel 'Hello, Mac!'。

注意事项

Apple Intelligence 未开启时工具无法工作，请先在系统设置中启用。
apfel 本身没有配置文件，只通过命令行 flags 和环境变量控制，需要 TOML 配置可额外安装 apfel-run。
本地服务默认端点由 README 给出为 http://localhost:11434/v1，可直接作为 OpenAI SDK 的 base URL。
工具调用（tool calling）在命令行、聊天和服务三种模式下均可用。

核心亮点

完全本地运行，数据不出设备，隐私安全有保障
提供 OpenAI 兼容 API，可无缝替换现有服务
零配置启动，无需 API 密钥，开箱即用

不足之处

依赖 Apple Intelligence 框架，仅支持较新 macOS 版本
功能受限于 Apple 提供的模型能力，可能不如云端大模型丰富

适用场景

隐私敏感场景下使用 AI 助手
本地开发调试 OpenAI API 兼容服务
离线环境下的快速 AI 问答

替代项目

Ollama、llama.cpp、LocalAI

项目介绍

apfel 是对话助手领域的开源项目，由 Arthur-Ficial 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（6,433）位列前 7%，在对话助手分类的 905 个项目里位列前 5%。

近 41 天，它的 GitHub 星标从 6,282 增加到 6,433，净增 151。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。完全免费，本地运行，无需API密钥或云端服务。

它主要面向的使用场景是：隐私敏感场景下使用AI助手。同类可对比的替代方案包括 Ollama、llama.cpp、LocalAI。

上一篇：llama-gpt

下一篇：AingDesk