docs / build with the engine
Engine overview
A local-first Swift SDK for dictated text.
Cleanup Engine is an unreleased developer preview. These guides are generated from the SDK repository, which is private for now; file paths are shown as text. Request access.
A local-first Swift SDK for turning dictated text into cleaned text, with explicit outcomes, Unicode-safe edits, provenance and timings. Prepare a verified model pack once and reuse the cleaner across requests.
Version: 0.1.0-beta.2 — public beta. The implementation has contract, concurrency, adversarial transport and real-model regression tests. Stable production support still requires the release gates, including real Pomvox integration and a reviewed quality corpus. Sub-100ms cleanup is a benchmark target, not a demonstrated capability.
What it provides
- Local cleanup: pinned Swift/MLX inference, a frozen baseline prompt, optional vocabulary and reusable prefix caches.
- Predictable failures: exact-input fallback, bounded admission and deadlines. Cancellation throws and suppresses late delivery.
- Inspectable results: final text, UTF-8 edits, outcome, artifact/runtime identity and stage timings.
- Explicit cloud access: a separate transport client requiring an endpoint and credentials. No automatic uploads, downloads, route changes or retries.
- A small host seam: the SDK owns no microphone, STT, clipboard, paste, UI, history or telemetry.
The engine is MIT licensed (LICENSE). Baseline weights are separate artifacts with their own license; see pack licensing and availability. Premium cloud packs keep proprietary weights server-side. Licensed private enterprise deployment is a separate product direction. This repository does not contain a premium service, billing or a marketplace.
Requirements
| Component | Requirements | Validated environment |
|---|---|---|
| Core, local facade, cloud client | macOS 14+, Swift 6 | Swift 6.2.4, macOS 15.7.4 |
| MLX runtime | Apple Silicon, full Xcode, pinned installed model | Apple M1, 16 GiB, Xcode 26.3 |
| Tests and asset preparation | Python 3; XcodeGen for the separate consumer | Debug/Release and sanitizer runs; see evidence |
macOS 14 is the declared deployment minimum; it has not yet been exercised in the release validation matrix. Linux, Intel inference, C/Python/Node bindings and multiple resident local models are not supported in this milestone.