pi-apfel
v0.1.0
Published
Pi provider extension for Apfel's local Apple FoundationModels server.
Maintainers
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
apfelinstalled and available onPATH
brew install apfelInstall
From npm:
pi install npm:pi-apfelFor local development from this repository:
pi -e .Or install this checkout as a Pi package:
pi install /absolute/path/to/pi-apfelUsage
The extension registers a new Pi model provider named apfel with model apple-foundationmodel.
Commands:
/apfel-start— startsapfel --serveon127.0.0.1:11434/apfel-health— checks Apfel's/healthendpoint/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 tohttp://127.0.0.1:11434/v1APFEL_HOST— host used by/apfel-start, defaults to127.0.0.1APFEL_PORT— port used by/apfel-start, defaults to11434APFEL_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