← TinyGPT · docs · devlog · roadmap · speedup
source: docs/prds/tinygpt-product-thesis.md · view on GitHub ↗

tinygpt product thesis — the embedded local-AI runtime for Mac apps

Status: positioning doc (2026-06-10). Written as the specialist track closes (v11 = final 0.6B planner run, verdict pending) and focus shifts to fine-tuning/distilling larger open models. This doc makes the thesis explicit so the large-model phase starts from it, not from habit.

The thesis in one line

tinygpt’s durable asset is the runtime, not the factory. Product = the embedded local-AI runtime for Mac apps. Pace is its first proof.

Evidence (why the factory isn’t the product)

What tinygpt uniquely has (the moat inventory)

  1. ANE end-to-end LLM decode with LoRA support (M8: 28-block stateful CoreML chain, fp32-compute/fp16-state, int8 per-block weights, numerics gate). Nobody else ships this — anemll has no LoRA path, Apple’s stack is closed.
  2. Grammar-constrained Swift serving — JSON-Schema/GBNF FSM masking at 119ms warm TTFW with streaming partial JSON. mlx-lm is Python; Ollama/LM Studio are apps, not embeddable libraries.
  3. On-device adaptation loop — LoRA/DoRA train → bake → serve → eval → quantize, all base-model-agnostic, zero Python at runtime.

The competitive gap: Apple Foundation Models framework is closed, small, and uncustomizable; the MLX ecosystem is Python-first. Embeddable + customizable

What tinygpt is NOT (scope discipline)

How the roadmap serves the thesis

PhaseThesis role
1. v11 specialist close-outBounded: one run, ship or fail. Either way the track closes and the adaptation pipeline is proven on a real gate.
2. VLM + Pace needsVoice loop airtight first (WhisperKit → planner → executor under 100ms doctrine) — the make-or-break demo. VLM A/B picks the port target; the port itself extends the runtime (M8 pattern → vision tower).
3. Fine-tune/distill larger modelstinygpt’s new job: adapt + serve 4–14B open weights brilliantly on Apple silicon. QLoRA (LoRA-on-quantized-base) is the hardware unlock on 48 GB; 30B-A3B stays teacher-only.

Decision rule carried forward from the specialist era: before any fine-tune, measure the zero-shot base on the same gate. Train only when zero-shot demonstrably falls short. (This rule would have saved most of v1–v10.)

Risks

v11 verdict

Placeholder — fill when the 2026-06-10 pipeline run lands: