# AFM / maclocal.ai

> AFM is a local OpenAI-compatible Swift server for Apple Silicon. maclocal.ai is its human and agent-readable companion documentation; it is not a hosted inference API.

## Canonical contract

- [What's new](https://maclocal.ai/whats-new): Visual AFM release highlights and links to the complete GitHub release history.
- [API overview](https://maclocal.ai/docs/api-reference): Compatibility boundaries and route matrix.
- [Chat completions](https://maclocal.ai/docs/api-reference/chat-completions): Request fields, precedence, response shape, and examples.
- [Streaming](https://maclocal.ai/docs/api-reference/streaming): SSE lifecycle, tool deltas, usage, cancellation, and profiling.
- [Operations](https://maclocal.ai/docs/api-reference/operations): Models, token budgeting, batches, health, and metrics.
- [Errors](https://maclocal.ai/docs/api-reference/errors): Error envelope, correlation IDs, status codes, and retry behavior.
- [OpenAPI 3.1](https://maclocal.ai/openapi.json): Machine-readable public snapshot of the local AFM contract.
- [Full agent context](https://maclocal.ai/llms-full.txt): Compact implementation notes and operating constraints.

## Capability guides

- [WebUI](https://maclocal.ai/docs/webui)
- [Tool calling](https://maclocal.ai/docs/tool-calling)
- [Parameter recipes](https://maclocal.ai/docs/configuration-recipes)
- [Environment variables](https://maclocal.ai/docs/environment-variables)
- [Model architectures](https://maclocal.ai/docs/model-architectures)
- [Apple-native APIs](https://maclocal.ai/docs/apple-native)
- [Performance](https://maclocal.ai/docs/performance)
- [DwarfStar + DeepSeek V4](https://maclocal.ai/docs/dwarfstar-deepseek)

## Source

- [maclocal-api](https://github.com/scouzi1966/maclocal-api): Authoritative runtime implementation.