apfel

环境要求

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

安装与启动步骤

1. 1确认设备环境

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

2. 2安装 apfel

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

   brew install apfel

   复制

3. 3命令行模式试用

   直接传入提示词获取答案；提示词含 ! 时用单引号包裹，避免 zsh/bash 的历史展开。

   apfel "What is the capital of Austria?"

   复制

4. 4管道输入文本

   也可把其他命令的输出通过管道交给 apfel 处理，适合脚本中调用。

   echo "text" | apfel

   复制

5. 5启动交互式聊天

   进入 REPL 交互界面，可以连续多轮对话，适合手动探索本地模型能力。

   apfel --chat

   复制

6. 6启动本地 OpenAI 兼容服务

   以服务模式运行后，会得到一个本地 http://localhost:11434/v1 端点，可直接作为 OpenAI SDK 的 base URL 使用。

   apfel --serve

   复制

7. 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. 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 可连通即启动成功。

常见问题

注意事项

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