Claude Skill
scouzi1966/maclocal-api
maclocal-api 是一个 Swift CLI 工具,通过 OpenAI 兼容端点在 macOS 上暴露 Apple Foundation 和 MLX 模型。支持服务器和单提示模式、Apple Vision、管道、网页浏览器和本地 AI API 聚合。
概览
仓库信息
安装这个 Skill
git clone https://github.com/scouzi1966/maclocal-api.gitRegistry 信息
git clone https://github.com/scouzi1966/maclocal-api.gitpip install macafm==0.9.10 # previous stablepip install --extra-index-url https://maclocal-ai.pages.dev/afm/wheels/simple/ \pip install macafm
项目简介
maclocal-api 是一个基于 Swift 的 CLI 工具,通过单个 OpenAI 兼容的 API 端点在 macOS 上暴露 Apple 的 Foundation 和 MLX 模型以及其他本地 AI API。它支持服务器模式和单提示(非服务器)推理(支持管道),现已集成网页浏览器和本地 AI API 聚合器。
'afm' command cli: macOS server and single prompt mode that exposes Apple's Foundation and MLX Models and other APIs running on your Mac through a single aggregated OpenAI-compatible API endpoint. Supports Apple Vision and single command (non-server) inference with piping as well . Now with Web Browser and local AI API aggregator
要点
- 为 Apple Foundation 和 MLX 模型提供 OpenAI 兼容的聚合 API 端点
- 双模式:macOS 服务器模式和单提示(非服务器)推理(支持管道)
- 支持 Apple Vision,用于基于图像的 AI 任务
- 集成网页浏览器,支持交互式使用
- 本地 AI API 聚合器,整合多个本地端点
使用场景
- 在 Apple Silicon 上运行本地 LLM 推理,无需依赖云端
- 将多个本地 AI API 聚合为一个 OpenAI 兼容端点,供应用使用
- 通过 CLI 或服务器使用 Apple Vision 模型进行图像分析
- 通过管道和脚本原型化并测试 Apple Foundation 和 MLX 模型
- 在 macOS 上构建完全注重隐私的 AI 工作流
README 摘要
If you find this useful, please ⭐ the repo! Also check out [Vesta AI Explorer](https://kruks.ai/)! — my full-featured native macOS AI app. ## Install | | Stable (v0.9.12) | Nightly (afm-next) | |---|---|---| | **Homebrew** | `brew install scouzi1966/afm/afm` | `brew install scouzi1966/afm/afm-next` | | **pip** | `pip install macafm` | `pip install --extra-index-url https://maclocal-ai.pages.dev/afm/wheels/simple/ macafm-next` | | **Release notes** | [v0.9.12](https://github.com/scouzi1966/maclocal-api/releases/tag/v0.9.12) | [v0.9.13-next](https://github.com/scouzi1966/maclocal-api/releases/tag/nightly-20260614-a92a0fe) | ### 🔨 Build from source — one command Clone and build everything (submodules, patches, WebUI, release binary) with a single script. It checks your toolchain, auto-installs what it can (Node via Homebrew), and tells you what to install manually (Xcode Command Line Tools) — no AI agent or project knowledge required. The script initializes submodules for you, so a plain `git clone` is all you need. ```bash git clone https://github.com/scouzi1966/maclocal-api.git cd maclocal-api ./build.sh ``` That's it. The `afm` binary lands in `.build/release/afm`. Add `--install` to also install it to `/usr/local/bin` (on your `PATH` by default; uses `sudo` if needed): ```bash ./build.sh --install ``` Run `./build.sh --help` for all options (`--debug`, `--skip-webui`, `--yes` for non-interactive/CI). > [!TIP] > **Switching between stable and nightly:** > ```bash > brew unlink afm && brew install scouzi1966/afm/afm-next # switch to nightly > brew unlink afm-next && brew link afm # switch back to stable > ASSUMES you did a brew install scouzi1966/afm/afm previously > ``` ### Install a previous version Older stable releases are ke