build-afm

Build the AFM binary from a clean clone with submodules, patches, web UI, and Swift.

324|17|Updated Aug 8, 2025
One-click install
npx skills add https://github.com/scouzi1966/maclocal-api --skill build-afm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-afm
Source: https://github.com/scouzi1966/maclocal-api/tree/main/.claude/skills/build-afm
Command: npx skills add https://github.com/scouzi1966/maclocal-api --skill build-afm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates building the AFM binary from a fresh clone, including submodules, patches, web UI, and the Swift build.

Core Features & Use Cases

  • End-to-end AFM build from scratch, including submodules and required patches.
  • Web UI and Swift-based build pipeline to produce a production-ready binary.
  • Validation steps ensure compatibility with macOS 26+ and Apple Silicon, and verify that BuildInfo.swift and Info.plist are correctly updated during the build process.

Quick Start

Run the build script to compile AFM from a clean repository.

Frequently Asked Questions about build-afm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build AFM from source on macOS for offline MLX deployment?

You can build AFM from source by running the Scripts/build-from-scratch.sh script. This automates submodule updates, patches, web UI compilation, and the Swift build to produce a production-ready binary for local offline MLX deployment on macOS.

What is the end-to-end AFM build process from a clean clone?

The end-to-end AFM build process from a clean clone involves updating submodules, applying required patches, compiling the web UI, and running the Swift build pipeline to generate a production-ready binary validated for macOS and Apple Silicon.

Do I need Xcode and Node.js to compile AFM locally?

Yes, compiling AFM locally requires a full Xcode installation and Swift 5.9+ for the Swift build, along with Node.js 18+ to compile the web UI, plus Git for repository and submodule management.

Does the AFM build workflow validate compatibility with Apple Silicon?

Yes, the AFM build workflow includes validation steps that ensure compatibility with macOS 26+ and Apple Silicon, verifying that BuildInfo.swift and Info.plist are correctly updated during the build process.

Why does building AFM from scratch require applying patches?

Building AFM from scratch requires applying patches to ensure the submodules and codebase are correctly modified for reproducible, end-to-end compilation and to maintain compatibility with the production-ready macOS binary validation steps.