pi-apfel

Pi provider extension for Apfel's local Apple FoundationModels server.

Packages

Package details

extension

Install pi-apfel from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-apfel
Package
pi-apfel
Version
0.1.0
Published
Jul 8, 2026
Downloads
167/mo · 9/wk
Author
nivoset
License
MIT
Types
extension
Size
9.1 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-apfel

Pi provider extension for Apfel, which exposes Apple's on-device FoundationModels API through a local OpenAI-compatible server.

Requirements

  • macOS 26+ on Apple Silicon
  • Apple Intelligence enabled
  • apfel installed and available on PATH
brew install apfel

Install

From npm:

pi install npm:pi-apfel

For local development from this repository:

pi -e .

Or install this checkout as a Pi package:

pi install /absolute/path/to/pi-apfel

Usage

The extension registers a new Pi model provider named apfel with model apple-foundationmodel.

Commands:

  • /apfel-start — starts apfel --serve on 127.0.0.1:11434
  • /apfel-health — checks Apfel's /health endpoint
  • /apfel-stop — stops the server if this Pi session started it

Then choose the model in Pi with /model and select apfel/apple-foundationmodel.

Configuration

Environment variables:

  • APFEL_BASE_URL — full OpenAI-compatible base URL, defaults to http://127.0.0.1:11434/v1
  • APFEL_HOST — host used by /apfel-start, defaults to 127.0.0.1
  • APFEL_PORT — port used by /apfel-start, defaults to 11434
  • APFEL_TOKEN — token if the Apfel server was started with --token

Extra arguments passed to /apfel-start are appended to apfel --serve, for example:

/apfel-start --permissive